# 触控 - 单击

点按云手机屏幕上的一个坐标点。
- **前置条件**：云手机必须已开机且未被其他成员占用。仅兼容机型 支持；不兼容机型会拒绝该调用。
- **坐标**：`pos` 必须恰好包含两个值 `[x, y]`。**不会校验是否超出屏幕分辨率**——越界坐标会原样传给设备服务。
- **完成信号**：同步。`data.status` 为 `finish` 表示手势已完成，`pending` 表示设备服务已排队。部分机型始终返回 `finish`。没有可供轮询 `pending` 状态的接口。
- **重试**：没有去重。两次调用就是两次点按，超时后盲目重试可能造成双击。
- **说明**：这里接受 `duration` 但会忽略；只有长按会读取它。

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

Endpoint: POST /api/cloudphone/touch/click
Version: 2026-09-05

## 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