跳到主要内容

鼠标弹起

三种手机控制模式下都可用

不带坐标的按下 / 弹起是纯粹的鼠标键动作,模式 1/2/3 都支持。

⚠️ 触控模式(2/3)下按下 / 弹起不会附带任何移动,mouse_mode 传什么都一样。

3~8 键的行为变了(2026-09-12 起)

按钮 3~8(中键与侧键)以前是发不出去的:接口返回成功,手机毫无反应。 现在已修正,这几个键能正常发到手机。

⚠️ 对调用方的影响:如果你的脚本此前靠"按钮 3 没反应"来占位、或用它当空操作, 现在会真的按下去。左键(1)与右键(2)的行为一个字没变。

⚠️ mouse_mode 对 3~8 键不起作用:这几个键只有相对鼠标能发,传什么都一样。

快狠准的按下 / 弹起现在带坐标了(2026-09-12 起)

快狠准(绝对定位)下,以前按下与弹起会落在 (0,0)。现在落在指针此刻所在的位置: 前面调过移动(/mouse/move,或 /mouse/click、/mouse/swipe 内部那一步) 就用那个落点,没调过则取硬件当前记着的指针位置。

⚠️ 接口字段一个都没加:坐标由内核自己记,不需要在 /mouse/down、/mouse/up 里传 x、y。

⚠️ 对调用方的影响:先移动再按下的老写法结果完全不变。 只有"不移动直接按下"的落点变了——从 (0,0) 变成指针当前所在处。

调用说明​

  • 请求参数
参数类型说明备注
fun字符串/mouse/up请求功能名
id字符串设备唯一ID多个设备用逗号隔开
button字符串1左键,2右键,3中键,4,5,6,7,8键为空默认左键,最多支持8个键
mouse_mode整数本次用哪种移动方式不传或 0=按全局配置,1=强制相对移动,2=强制快狠准
  • httpGet请求示例
curl --request GET \
--url 'http://192.168.9.9:9911/api/mouse/up?id=5C:F7:E6:CE:65:22'
  • httpPost请求示例
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/mouse/up \
--form id=5C:F7:E6:CE:65:22
  • httpPost json请求示例【websocket也可发送同样json请求】
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/mouse/up",
"data": {
"id":"5C:F7:E6:CE:65:22"
}
}'

响应结果​

{
"data": {
"code": 0,
"id": "5C:F7:E6:CE:65:22",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/mouse/up"
}
  • 响应data数据字段说明
    无