Take and boot the emulator
emu_startLease and boot a shared Android emulator, or reuse a running one, then prepare it for automation: animations off, screen on, keyguard dismissed, clock reset. Use before device-changing tools.
Instructions
Lease the AVD to this session and boot it (or reuse it when it already runs), then make it predictable for automation (animations off, screen stays on, keyguard dismissed, clock reset). Call this before any other device-changing tool. On BUSY another session holds the emulator: do not retry in a loop and never release its lease; wait, or ask the person. Runs as a job: if the result is a job_id, call emu_job with it. Calling it again under your own lease only renews the lease. Always call emu_release when done.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "emu_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| avd | No | AVD name (default "unity-test", or the EMU_AVD environment variable of the server). | |
| hours | No | Lease length in hours from now (default 4). | |
| headless | No | Start the emulator without a window (default false). | |
| wait_sec | No | How long this call waits for the job (default 50, max 600). If the job is still running, the call returns a job_id for emu_job. | |
| cold_boot | No | Ignore the quick-boot snapshot (slower, a clean boot; default false). | |
| boot_timeout_sec | No | Time for the emulator to appear and finish booting (default 300). |