Get Orientation
mobile_get_orientationRetrieve the current screen orientation of a mobile device for automation testing or UI adaptation, using the device identifier from available options.
Instructions
Get the current screen orientation of the device
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"device": "<device>"
},
"name": "mobile_get_orientation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | Yes | The device identifier to use. Use mobile_list_available_devices to find which devices are available to you. |
Implementation Reference
- src/server.ts:464-475 (registration)Registration of the 'mobile_get_orientation' MCP tool. The inline handler requires an active device/robot and delegates to its getOrientation() method, formatting the result as a string.
tool( "mobile_get_orientation", "Get the current screen orientation of the device", { noParams }, async () => { requireRobot(); const orientation = await robot!.getOrientation(); return `Current device orientation is ${orientation}`; } ); - src/android.ts:316-319 (helper)AndroidRobot implementation of getOrientation(): queries device settings via adb for user_rotation (0=portrait, else landscape).
public async getOrientation(): Promise<Orientation> { const rotation = this.adb("shell", "settings", "get", "system", "user_rotation").toString().trim(); return rotation === "0" ? "portrait" : "landscape"; } - src/webdriver-agent.ts:385-392 (helper)WebDriverAgent implementation of getOrientation() used by iOS devices and simulators: performs HTTP GET to /orientation endpoint within a WDA session and lowercases the result.
public async getOrientation(): Promise<Orientation> { return this.withinSession(async sessionUrl => { const url = `${sessionUrl}/orientation`; const response = await fetch(url); const json = await response.json(); return json.value.toLowerCase() as Orientation; }); }