Skip to content

Overview

Remote Control Agent

The BlueFletch Remote Control package allows for device administrators to view and in some cases, interact with a Mobile Devices.

Features

From the BlueFletch Portal, a user can request View or Remote Control of a device. Complete details on running a remote session from the Portal can be found here.

In View mode, the remote agent will allow for screen capture of the device. This will allow a Portal user to view what is being displayed on a remote device.

In Remote Control mode, a Portal user can also interact with a remote device. Interaction includes opening and closing applications, invoking Playbook plays, etc.

At the current time the 'Remote Control' feature is limited to Zebra devices and those devices that have signed BlueFletch Platform Services integration.

Application Details

Package: com.bluefletch.ems.emm.remoteagent

Setup

Install package and apply the appropriate permissions.

Intents

com.bluefletch.ems.remotecontrol.ACTION_INIT to accomplish initial permissions setup. Only valid on Zebra devices. Is a one time intent.

com.bluefletch.ems.remotecontrol.ACTION_START to start foreground service to run, which will request video permissions.

com.bluefletch.ems.remotecontrol.ACTION_STOP to stop the foreground service and any remote capture processing.

Example ADB Command

adb shell am start -n com.bluefletch.ems.emm.remoteagent/com.bluefletch.ems.remotecontrol.MainActivity

Example AirWatch Command

mode=explicit,action=android.action.intent.MAIN,package=com.bluefletch.ems.emm.remoteagent,class=com.bluefletch.ems.remotecontrol.MainActivity,broadcast=false

Permissions

For Android 10 and above, permission SYSTEM_ALERT_WINDOW is required for Remote Control to properly function.

Permissions via ADB

adb shell pm grant com.bluefletch.ems.emm.remoteagent android.permission.WRITE_EXTERNAL_STORAGE
adb shell pm grant com.bluefletch.ems.emm.remoteagent android.permission.READ_EXTERNAL_STORAGE
adb shell pm grant com.bluefletch.ems.emm.remoteagent android.permission.READ_PHONE_STATE
adb shell pm grant com.bluefletch.ems.emm.remoteagent android.permission.SYSTEM_ALERT_WINDOW

Permission via SOTI

afw_set_permission_grant_state com.bluefletch.ems.emm.remoteagent android.permission.READ_PHONE_STATE allow
afw_set_permission_grant_state com.bluefletch.ems.emm.remoteagent android.permission.READ_EXTERNAL_STORAGE allow
afw_set_permission_grant_state com.bluefletch.ems.emm.remoteagent android.permission.WRITE_EXTERNAL_STORAGE allow
afw_set_permission_grant_state com.bluefletch.ems.emm.remoteagent android.permission.SYSTEM_ALERT_WINDOW allow