Device API
Device Settings
Control orientation, battery, GPS, dark mode, network speed, font scale, and animations.
Modify device configuration without navigating Android Settings. Changes take effect immediately.
set_orientation
Lock the device to portrait or landscape.
| Parameter | Type | Required | Values |
|---|---|---|---|
orientation | string | Yes | portrait, landscape |
Orientation set to landscape.set_device_ability
Toggle core device capabilities on or off.
| Parameter | Type | Required | Description |
|---|---|---|---|
ability | string | Yes | wifi, bluetooth, location, airplaneMode, autoRotate |
enabled | boolean | Yes | true to enable, false to disable |
WiFi has been disabled.set_battery_level
Simulate a specific battery percentage.
| Parameter | Type | Required | Description |
|---|---|---|---|
level | number | Yes | 0–100 |
Battery level set to 15%.set_charging_state
Simulate plugging in or unplugging the charger.
| Parameter | Type | Required | Description |
|---|---|---|---|
charging | boolean | Yes | true = charging, false = on battery |
Charging state set to: not charging.set_gps
Override the device GPS location. Optional parameters for altitude, speed, bearing, and satellite count.
| Parameter | Type | Required | Description |
|---|---|---|---|
latitude | number | Yes | -90 to 90 |
longitude | number | Yes | -180 to 180 |
altitude | number | No | Meters above sea level |
speed | number | No | Meters per second |
bearing | number | No | Heading in degrees |
satellites | number | No | Visible satellite count |
GPS location set to 37.774929, -122.419416.set_dark_mode
Toggle system-wide dark mode.
| Parameter | Type | Required | Description |
|---|---|---|---|
enabled | boolean | Yes | true = dark mode on |
Dark mode has been enabled.set_font_scale
Set the system font scale. Useful for accessibility testing.
| Parameter | Type | Required | Description |
|---|---|---|---|
scale | number | Yes | 0.85, 1.0, 1.15, 1.3, or 1.5 |
| Scale | Label |
|---|---|
0.85 | Small |
1.0 | Default |
1.15 | Large |
1.3 | Larger |
1.5 | Largest |
System font scale set to 1.3x.set_network_speed
Throttle network to simulate real-world connectivity.
| Parameter | Type | Required | Description |
|---|---|---|---|
preset | string | Yes | Network condition preset |
| Preset | Description |
|---|---|
full | No throttling |
lte | 4G LTE |
hsdpa | 3G |
edge | 2.5G |
gprs | 2G |
gsm | 2G (slowest) |
Network speed set to EDGE (2.5G).set_animations
Control system animation speed. Set to 0 to disable animations entirely — recommended for automated test flows to eliminate timing variability.
| Parameter | Type | Required | Description |
|---|---|---|---|
scale | number | Yes | 0 = disabled, 1 = normal, 2+ = slow motion. Range: 0–10 |
Animation scale set to 0 (animations disabled).