# 触控 - 长按

长按云手机屏幕上的一个坐标点。
- **前置条件**：云手机必须已开机且未被其他成员占用。仅兼容机型 支持；不兼容机型会拒绝该调用。
- **取值**：`duration` 是按住时长（毫秒），上限 60000。**没有下限**，因此负值也能通过校验并被传给设备服务。在部分机型上省略 `duration` 时默认为 1000 毫秒。
- **完成信号**：同步。`data.status` 为 `finish` 或 `pending`。
- **重试**：没有去重；再次调用会再长按一次。

已记录的业务错误码：`33300`, `33301`, `33401`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /cloudphone/touch/longClick
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    云手机 ID
    Example: 1558968155668507

  - `pos` (array, required)
    点击坐标 [x, y]。坐标系以屏幕左上角为原点 (0, 0)。
    Example: [540,960]

  - `duration` (integer)
    按压持续时间（毫秒），用于长按。如果省略，则使用默认时长。
    Example: 2000

## Response 200:

  - `200` (unknown)
    操作成功

## Response 200 fields (application/json):

  - `code` (integer)
    状态码，0 表示成功
    Example: 0

  - `msg` (string | null)
    响应消息
    Example: success

  - `data` (object)

  - `data.status` (string)
    执行状态
    Example: finish