Перейти до вмісту
Довідник API
/
Хмарні телефони
/
/Touch

Дотик - Натискання

Request

Натискає точку на екрані хмарного телефона.

  • Передумови: хмарний телефон повинен бути увімкнений і не може бути зайнятий іншим учасником команди. Підтримується лише на сумісних моделях; решта Сервісів відхиляють виклик.
  • Координати: pos має містити рівно два значення, [x, y]. Вони не звіряються з роздільністю екрана — точка за межами екрана передається Сервісу як є.
  • Завершення: синхронне. data.status дорівнює finish, коли жест виконано, або pending, коли Сервіс поставив його в чергу. Деякі моделі завжди повідомляють finish. Ендпоінта для опитування жесту у стані pending немає.
  • Повтор: дедуплікації немає. Два виклики — це два натискання, тому наосліп повторений запит після таймауту може дати подвійне натискання.
  • Примітка: duration тут приймається, але ігнорується; його читає лише довге натискання.

Задокументовані бізнес-помилки: 33300, 33301, 33401. Значення кодів див. у Error Codes. Будь-яка операція може додатково повернути загальні коди.

Security
Authorization
Bodyapplication/jsonrequired
idstringrequired

ID хмарного телефону

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

Координати натискання [x, y]. Система координат використовує лівий верхній кут екрана як початок координат (0, 0).

Example:
[
  540,
  960
]
durationinteger

Тривалість натискання в мілісекундах (використовується для тривалого натискання). Якщо не вказано, використовується значення за замовчуванням.

Example:2000
curl -i -X POST \
  https://api.morelogin.com/cloudphone/touch/click \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1558968155668507",
    "pos": [
      540,
      960
    ]
  }'

Responses

Операція виконана успішно

Bodyapplication/json
codeinteger

Код статусу, 0 означає успіх

Example:0
msgstring or null

Повідомлення відповіді

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