device_screenshot
Take a screenshot of a device (one frame). Returns the JPEG image PLUS, by default, a compact list of labeled UI elements with their bounds (in device-tap coord space — use directly with device_tap, no scaling). The bundled element list eliminates the second roundtrip to device_page_source and removes visual-estimation guesswork for tap targets that appear in the accessibility tree. Prefer device_tap_by_text for elements with a visible label; use these bounds only as a fallback. For continuous observation or debugging a stuck flow, use android_video_stream (live MJPEG) instead of polling screenshots. Set includeElements=false to skip the page-source fetch and return only the image. For routine per-action screen checks, android_mjpeg_screenshot is much faster — it reads the already-running video stream instead of taking a fresh capture, and bundles no element list; reserve this tool for when you need the labeled elements or a full-fidelity frame.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| udid | Yes | Device serial number (UDID) | |
| includeElements | No | Include the compact labeled-element list alongside the image (default: true). Set false to save tokens on screens you only need to look at, not interact with. |