Tap at coordinates.

Type text.

Initialize the device factory. Args: device_type: The type of device to use (ADB or HDC).

Initialize HDC connection manager. Args: hdc_path: Path to HDC executable.

Initialize iOS connection manager. Args: wda_url: WebDriverAgent URL (default: http://localhost:8100).

Initialize ADB connection manager. Args: adb_path: Path to ADB executable.

Initialize all timing configurations.

Load values from environment variables if present.

Load values from environment variables if present.

Load values from environment variables if present.

Default confirmation callback using console input.

Default confirmation callback using console input.

Default takeover callback using console input.

Default takeover callback using console input.

Handle back gesture (swipe from left edge).

Handle back button action.

Handle API call action (placeholder for summarization).

Handle API call action (placeholder for summarization).

Handle double tap action.

Handle double tap action.

Handle home button action.

Handle home button action.

Handle interaction request (user choice needed).

Handle interaction request (user choice needed).

Handle app launch action.

Handle app launch action.

Handle long press action.

Handle long press action.

Handle note action (placeholder for content recording).

Handle note action (placeholder for content recording).

Handle swipe action.

Handle swipe action.

Handle takeover request (login, captcha, etc.).

Handle takeover request (login, captcha, etc.).

Handle tap action.

Handle tap action.

Handle text input action.

Handle text input action.

Handle wait action.

Handle wait action.

Send a keyevent to the device.

Press the back button. Args: device_id: Optional HDC device ID. delay: Delay in seconds after pressing back. If None, uses c

Press the back button. Args: device_id: Optional ADB device ID. delay: Delay in seconds after pressing back. If None, uses c

Check if an app is installed on the iOS device. Args: app_name: The display name of the app. wda_url: WebDriverAgent URL.

Check if the model API is accessible and the specified model exists. Checks: 1. Network connectivity to the API endpoint 2. Model ex

Clear text in the currently focused input field. Args: device_id: Optional HDC device ID for multi-device setups. Note:

Clear text in the currently focused input field. Args: wda_url: WebDriverAgent URL. session_id: Optional WDA session ID.

Get the current conversation context.

Get the current conversation context.

Detect current keyboard and switch to ADB Keyboard if available. Args: device_id: Optional HDC device ID for multi-device setups.

Detect current keyboard and switch to ADB Keyboard if needed. Args: device_id: Optional ADB device ID for multi-device setups.

Helper function for creating 'do' actions.

Double tap at the specified coordinates. Args: x: X coordinate. y: Y coordinate. device_id: Optional HDC device ID.

Double tap at the specified coordinates. Args: x: X coordinate. y: Y coordinate. device_id: Optional ADB device ID.

Enable TCP/IP debugging on a USB-connected device. This allows subsequent wireless connections to the device. Args:

Batch task example / 批量任务示例

Remote device example / 远程设备示例

Step-by-step execution example (for debugging) / 单步执行示例（用于调试）

Task example with callbacks / 带回调的任务示例

Execute an action from the AI model. Args: action: The action dictionary from the model. screen_width: Curre

Get app information from iTunes API using App Store ID. Args: app_store_id: The numeric App Store ID (e.g., "414478124" for WeChat).

Get app information from iTunes API using bundle ID. Args: bundle_id: The iOS bundle ID. Returns: Dictionary with app i

Get the app name from a package name. Args: package_name: The HarmonyOS bundle name. Returns: The display name of the a

Get the app name from a package name. Args: package_name: The Android package name. Returns: The display name of the ap

Get the app name from an iOS bundle ID. Args: bundle_id: The iOS bundle ID. Returns: The display name of the app, or No

Get the currently focused app name. Args: device_id: Optional ADB device ID for multi-device setups. Returns: The app n

Get detailed information about a device. Args: device_id: Device ID. If None, uses first available device. Retu

Get detailed information about a device. Args: device_id: Device UDID. If None, uses first available device. Re

Get detailed information about a device. Args: device_id: Device ID. If None, uses first available device. Retu

Get the IP address of a connected device. Args: device_id: Device ID. If None, uses first available device. Ret

Get the device name. Args: device_id: Device UDID. If None, uses first available device. Returns: D

Get the package name for an app. Args: app_name: The display name of the app. Returns: The HarmonyOS bundle name, or No

Get the package name for an app. Args: app_name: The display name of the app. Returns: The Android package name, or Non

Get the device pasteboard (clipboard) content. Args: wda_url: WebDriverAgent URL. Returns: Pasteboard content or None i

Get the screen dimensions. Args: wda_url: WebDriverAgent URL. session_id: Optional WDA session ID. Returns: Tup

Capture a screenshot from the connected HarmonyOS device. Args: device_id: Optional HDC device ID for multi-device setups. t

Capture a screenshot from the connected Android device. Args: device_id: Optional ADB device ID for multi-device setups. tim

Get screenshot as PNG bytes. Args: wda_url: WebDriverAgent URL. session_id: Optional WDA session ID. device_id: Opti

Get the global timing configuration. Returns: The global TimingConfig instance.

Press the home button. Args: device_id: Optional HDC device ID. delay: Delay in seconds after pressing home. If None, uses c

Press the home button. Args: device_id: Optional ADB device ID. delay: Delay in seconds after pressing home. If None, uses c

Check if a device is connected. Args: device_id: Device ID to check. If None, checks if any device is connected.

Check if a device is connected. Args: device_id: Device ID to check. If None, checks if any device is connected.

Check if the on-screen keyboard is currently shown. Args: wda_url: WebDriverAgent URL. session_id: Optional WDA session ID.

Launch an app by name. Args: app_name: The app name (must be in APP_PACKAGES). device_id: Optional HDC device ID. de

Launch an app by name. Args: app_name: The app name (must be in APP_PACKAGES). device_id: Optional ADB device ID. de

Quick helper to list connected devices. Returns: List of DeviceInfo objects.

Quick helper to list connected devices. Returns: List of DeviceInfo objects.

Get a list of all supported app names. Returns: List of app names.

Long press at the specified coordinates. Args: x: X coordinate. y: Y coordinate. duration_ms: Duration of press in m

Long press at the specified coordinates. Args: x: X coordinate. y: Y coordinate. duration_ms: Duration of press in m

Get the appropriate device module (adb or hdc).

Sensitive operation confirmation callback / 敏感操作确认回调