鼠标移动

手机控制模式会限制这个接口（2026-08-27 起）

「手机控制模式」（/config/imserver/set 的 phone_mode）决定了这次调用能不能做：

当前模式	相对移动	快狠准（绝对定位）
1 鼠标	✅	✅
2 单点触控	✅	❌ 返回 code=67
3 多点触控	❌ 返回 code=67	❌ 返回 code=67

⚠️ code=67（当前手机模式不支持此操作）与 code=56（硬件不支持）不是一回事： 56 要换硬件，67 改个模式就行。

⚠️ 改动之前这些情况会返回 0、但实际什么都没发生；现在明确返回 code=67，依赖返回值做判断的脚本请留意。

调用说明

• 请求参数

参数	类型	说明	备注
fun	字符串	/mouse/move	请求功能名
id	字符串	设备唯一ID	多个设备用逗号隔开
x	整数	x坐标	-
y	整数	y坐标	-
mouse_mode	整数	本次用哪种移动方式	不传或 0=按全局配置，1=强制相对移动，2=强制快狠准

• httpGet请求示例

curl --request GET \
  --url 'http://192.168.9.9:9911/api/mouse/move?id=5C:F7:E6:CE:65:22&x=100&y=100'

• httpPost请求示例

curl --request POST \
  --url http://192.168.9.9:9911/api \
  --header 'content-type: multipart/form-data' \
  --form fun=/mouse/move  \
  --form id=5C:F7:E6:CE:65:22 \
  --form x=100 \
  --form y=100

• httpPost json请求示例【websocket也可发送同样json请求】

curl --request POST \
  --url http://192.168.9.9:9911/api \
  --header 'Content-Type: application/json' \
  --data '{
    "fun": "/mouse/move",
    "data": {
        "id":"5C:F7:E6:CE:65:22",
        "x":100,
        "y":10
    }
}'

响应结果

{
  "data": {
    "code": 0,
    "id": "5C:F7:E6:CE:65:22",
    "message": "成功"
  },
  "status": 200,
  "message": "成功",
  "msgid": 0,
  "fun": "/mouse/move"
}

• 响应data数据字段说明
  无