跳到主要内容

获取已连接硬件列表

调用说明​

  • 请求参数
参数类型说明备注
fun字符串/config/usb/get请求功能名
  • httpGet请求示例
curl --request GET \
--url 'http://192.168.9.9:9911/api/config/usb/get'
  • httpPost请求示例
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'content-type: multipart/form-data' \
--form fun=/config/usb/get
  • httpPost json请求示例【websocket也可发送同样json请求】
curl --request POST \
--url http://192.168.9.9:9911/api \
--header 'Content-Type: application/json' \
--data '{
"fun": "/config/usb/get",
"data": {
}
}'

响应结果​

 {
"data": {
"list": [
{
"vid": "720D",
"pid": "1F2D",
"uid": "1F2D24BD",
"ver": "4.4",
"state": 2,
"lan": 2,
"power": 2,
"phone_mode": 0
},
{
"vid": "720D",
"pid": "FF2D",
"uid": "FF2D24BD",
"ver": "4.4",
"state": 2,
"lan": 2,
"power": 2,
"phone_mode": 0
}
],
"code": 0,
"id": "",
"message": "成功"
},
"status": 200,
"message": "成功",
"msgid": 0,
"fun": "/config/usb/get"
}
想知道某台硬件此刻在什么模式,看 phone_mode(2026-08-28 新增)

/config/imserver/get 里也有一个 phone_mode,但那是全局配置, 意思是"希望所有硬件切到哪个模式"。这里这个是这一台的事实。

⚠️ 两者会不一致,而且这不是 bug:

  • 切模式是重启级操作,设备逐个重新枚举,那几秒里有的切过去了、有的还没
  • 4.4 老硬件永远切不过去,它的 phone_mode 恒为 0(不适用)

所以判断"这台现在能不能发触摸/能不能用相对移动",一律看这里这个, 别拿全局那个当判据。

⚠️ 老版本内核没有这个字段。解析时把缺省当作 0(不适用)处理即可。

  • 响应data数据字段说明
字段说明备注
vid-
pid-
uid硬件id-
ver硬件版本-
state状态0未连接,1和电脑连接,2且和手机连接
lan网卡开关状态-
power充电开关状态-
phone_mode这台硬件当前所处的手机端模式1 快狠准鼠标 / 2 单点触控 / 3 多点触控;0 表示不适用(4.4 老硬件没有模式概念)。2026-08-28 新增