裝置

管理裝置

手機的開機、關機與操作，以及每種狀態代表的意思。

狀態

狀態	意思
starting	正在建立、啟動或重新啟動，有一項工作正在處理它。
執行中	已開機，可從控制台、API 和 ADB 連線。
error	正在執行，但最近一次健康檢查未通過。
已關機	已關機，App 和資料都會保留。關機約 10 分鐘後，手機會移到儲存空間；按開機後幾分鐘就會回來。

開機、關機、重設與刪除

生命週期

GET    /v1/devices                                # your phones
POST   /v1/devices/{name}/start
POST   /v1/devices/{name}/stop
POST   /v1/devices/{name}/restart
POST   /v1/devices/{name}/reset                  # wipe apps and data, same model and Android
DELETE /v1/devices/{name}                         # for good

開機、關機和重新啟動會回應 202 和一項工作，用 GET /v1/jobs/{id} 追蹤進度。重設會在 1 到 5 分鐘內把手機恢復成全新狀態。關機會保留一切，重設和刪除則不會。刪除會移除手機及其資料，無法復原。啟動一台已關機一段時間的手機，可能需要幾分鐘。

截圖與單一步驟

不需即時畫面

GET  /v1/devices/{name}/screenshot?w=540     # PNG, or a smaller JPEG with w
POST /v1/devices/{name}/action  {"op":"open_app","package":"com.android.chrome"}

action 執行一個步驟：open_app、close_app、url、tap、swipe、text、key、scroll，以及文字輔助操作 find_text、tap_text、wait_text、screen_text。Agent 循環請改用讀取畫面與操作。

名稱

每台手機都有一個 API 名稱（例如 c3f9a41d2）、一個 label（它在控制台的名稱，或「機型 #N」）和一個 number。用 POST /v1/devices/{name}/label 替手機改名。