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