Thiết bị

Quản lý thiết bị

Bật, tắt và điều khiển điện thoại, và hiểu ý nghĩa của từng trạng thái.

Trạng thái

Trạng thái	Ý nghĩa
starting	Đang được tạo, bật hoặc khởi động lại. Có một job đang chạy cho máy.
đang chạy	Đang bật và truy cập được từ bảng điều khiển, API và ADB.
error	Đang chạy, nhưng lần kiểm tra tình trạng gần nhất thất bại.
đã tắt	Đã tắt. Ứng dụng và dữ liệu được giữ nguyên. Sau khoảng 10 phút, máy đã tắt được chuyển vào lưu trữ; Bật lại sẽ đưa máy về trong vài phút.

Bật, tắt, đặt lại và xóa

Vòng đời

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

Bật, tắt và khởi động lại trả về 202 kèm một job; theo dõi bằng GET /v1/jobs/{id}. Đặt lại đưa máy về như mới trong 1 đến 5 phút. Tắt giữ nguyên mọi thứ; Đặt lại và Xóa thì không. Xóa gỡ bỏ máy cùng dữ liệu và không thể hoàn tác. Bật một máy đã tắt lâu có thể mất vài phút.

Ảnh chụp màn hình và thao tác đơn

Không cần luồng trực tiếp

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 chạy một bước: open_app, close_app, url, tap, swipe, text, key, scroll, cùng các hàm hỗ trợ văn bản find_text, tap_text, wait_text, screen_text. Với vòng lặp của agent, hãy dùng Observe và act.

Tên máy

Mỗi điện thoại có một tên API như c3f9a41d2, một label (tên trên bảng điều khiển, hoặc “Model #N”) và một number. Đổi tên máy bằng POST /v1/devices/{name}/label.