Перейти к содержимому
Справочник 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"
  }
}