# 触控 - 拖动

在云手机屏幕上从一点拖拽到另一点。
- **前置条件**：云手机必须已开机且未被其他成员占用。仅兼容机型 支持；不兼容机型会拒绝该调用。
- **说明**：**在部分机型上这与滑动是同一套实现**——服务端把拖拽直接转交给滑动逻辑，二者在该设备服务上无法区分。其他机型有独立的拖拽动作。
- **完成信号**：同步。`data.status` 为 `finish` 或 `pending`。
- **重试**：没有去重；再次调用会再拖拽一次。

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

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

## Request fields (application/json):

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

  - `pos1` (array, required)
    起始坐标 [x, y]
    Example: [540,1500]

  - `pos2` (array, required)
    结束坐标 [x, y]
    Example: [540,500]

  - `duration` (integer)
    滑动/拖动持续时间（毫秒）。值越大，操作越慢。
    Example: 300

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