openSystemTray
Access the system notification tray with a swipe-down gesture from the status bar. Automates the process on Android and iOS devices as part of the AutoMobile MCP server's mobile automation suite.
Instructions
Open the system notification tray by swiping down from the status bar
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| platform | Yes | Platform of the device |
Implementation Reference
- src/server/interactionTools.ts:406-427 (handler)The main handler function for the 'openSystemTray' tool. It creates a SwipeOnScreen instance and executes a downward swipe from the status bar (with system insets) to open the notification tray.const openSystemTrayHandler = async (device: BootedDevice, args: OpenSystemTrayArgs, progress?: ProgressCallback) => { try { const swipeOnScreen = new SwipeOnScreen(device); const result = await swipeOnScreen.execute( "down", { duration: 100, includeSystemInsets: true // to access status bar area }, progress ); return createJSONToolResponse({ message: "Opened system tray by swiping down from the status bar", observation: result.observation, ...result }); } catch (error) { throw new ActionableError(`Failed to open system tray: ${error}`); } };
- Zod schema for validating the input arguments of the 'openSystemTray' tool, requiring the platform.export const openSystemTraySchema = z.object({ platform: z.enum(["android", "ios"]).describe("Platform of the device") });
- src/server/interactionTools.ts:706-712 (registration)Registration of the 'openSystemTray' tool in the ToolRegistry, linking the name, description, schema, and handler.ToolRegistry.registerDeviceAware( "openSystemTray", "Open the system notification tray by swiping down from the status bar", openSystemTraySchema, openSystemTrayHandler, true // Supports progress notifications );
- src/server/interactionTools.ts:37-39 (schema)TypeScript interface defining the arguments for the 'openSystemTray' handler.export interface OpenSystemTrayArgs { platform: Platform; }