Device commands
Last updated
Last updated
The client provides methods to configure the device and start a session, while the session provides methods for user interaction.
Starts a session with the requested app, device, operating system, and other launch options.
Parameters
config?
Record<string, any>
Update the configured app, device, operating system, or other launch options. See for acceptable values.
Note: This will end any active sessions.
Ends the active session or cancels any pending session requests.
Executes an adb shell
command on the device (Android only)
Enables or disables all interactions on the device.
Sets the biometry enrollment status (iOS Only)
Simulate a matching fingerprint (Android 8+ only) or Face ID (iOS)
Ends the session
Experimental The data structure of the response is subject to change
Returns an array of elements describing the current UI on the device.
Sends a heartbeat to the server, resetting the inactivity timer of the session
Sends a single key press to the device.
This can also be used to send hardware keys:
HOME
VOLUME_UP
(Android)
VOLUME_DOWN
(Android)
ANDROID_KEYCODE_MENU
(Android)
LOCK_SCREEN
(Android)
UNLOCK_SCREEN
(Android)
TOGGLE_SCREEN_LOCK
(iOS)
Opens a deep-link or web URL
Launches the specified application using the provided appId
.
Parameters
appId
string
Android:
The app's package name / appId (e.g., com.example.app
) or packageName/activityName
. If no activity name is specified, it defaults to the main launch activity.
iOS:
The app's bundle identifier (e.g., com.example.app
).
Restarts the app
Reinstalls the app
Rotates the device 90 degrees left or right
Takes a screenshot of the device and returns the data as a buffer.
Alternatively, it can return the data as a base64 encoded string
Shakes device
Toggles the soft keyboard (iOS only)
Changes the current language.
Types the given text
Typing is limited to 1000 characters at a time to ensure optimal performance and prevent potential disruptions. For larger payloads, you can use multiple 'type' operations.
Upload media to the device.
A JSON object describing the for the device.
If your app does not automatically handle language/locale changes, you would need to explicitly call for this to take effect. Some apps might also cache data in the previously used language. In these cases use to clear any previous cached data.