Skip to content
Tài liệu tham khảo API
/
/
/
Chạm - Nhấp

Chạm - Nhấp

Request

Chạm vào một điểm trên màn hình cloud phone.

  • Điều kiện tiên quyết: cloud phone phải đang bật và không bị thành viên khác chiếm giữ. Chỉ hỗ trợ trên Các mẫu tương thích; các mẫu thiết bị khác từ chối lệnh gọi.
  • Tọa độ: pos phải chứa đúng hai giá trị, [x, y]. Chúng không được đối chiếu với độ phân giải màn hình — một điểm nằm ngoài màn hình vẫn được chuyển thẳng tới dịch vụ thiết bị.
  • Hoàn tất: đồng bộ. data.status là finish khi thao tác đã xong, hoặc pending khi dịch vụ thiết bị đưa nó vào hàng đợi. Một số mẫu luôn báo finish. Không có endpoint nào để hỏi vòng một thao tác pending.
  • Thử lại: không có cơ chế chống trùng. Hai lệnh gọi là hai lần chạm, nên thử lại mù quáng sau khi hết thời gian chờ có thể tạo thành chạm hai lần.
  • Lưu ý: duration được nhận ở đây nhưng bị bỏ qua; chỉ nhấn giữ mới đọc nó.

Các mã lỗi nghiệp vụ đã ghi nhận: 33300, 33301, 33401. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Bodyapplication/jsonrequired
idstringrequired

ID điện thoại đám mây

Example:"1558968155668507"
posArray of integers, = 2 itemsrequired

Tọa độ nhấp [x, y]. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0).

Example:
[
  540,
  960
]
durationinteger

Thời gian nhấn giữ tính bằng mili giây (dùng cho nhấn giữ). Nếu bỏ qua, thời gian mặc định sẽ được sử dụng.

Example:2000
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/touch/click \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1558968155668507",
    "pos": [
      540,
      960
    ]
  }'

Responses

Thao tác thành công

Bodyapplication/json
codeinteger

Mã trạng thái, 0 nghĩa là thành công

Example:0
msgstring or null

Thông báo phản hồi

Example:"success"
dataobject
Response
{
  "code": 0,
  "msg": "success",
  "data": {
    "status": "finish"
  }
}