跳至主要内容
版本:3.5.x

选择器

选择器用于确定HTTP请求或 WebSocket命令的目标设备会话

设备选择器 — URL 路径

用于所有设备级 HTTP 路由中,作为 /{device_type}/{id_or_index}/….

路线示例选择器的含义
inverse3/0FirstInverse3 索引排序(从 0 开始)
inverse3/A14Inverse3 设备 ID) A14
inverse3/*所有Inverse3 (通配符)
*inverse/*所有 Inverse 系列设备(Inverse3、Inverse3x、Minverse)
verse_grip/0首款带线VerseGrip(按索引排序)
wireless_verse_grip/*全无线 VerseGrips
*verse_grip/*所有VerseGrip系列设备(有线、无线、定制)

规则:

  • GET 不接受通配符选择器(存在歧义)→ 400
  • POSTDELETE 接受通配符 — 该操作将应用于所有匹配项

支持 {device_type} 值: inverse3, verse_grip, wireless_verse_grip, 或家族通配符 *inverse, *verse_grip.

会话选择器 — ?session=<expr> 查询参数

会话作用域的 HTTP 端点(basis、mount、preset、filters、navigation、SDF) 需要一个 ?session=<expr> 查询参数,用于确定在哪个会话上下文中 进行操作。

表达含义
(省略)所有会话(允许在 DELETE (仅限)
#123123ID 为 123 的会话
:0按索引排列的第一节
:-1按索引查看上一节
profile_name首次使用此配置文件(可能存在歧义)
profile_name:0首次会话,包含个人资料 + 索引 0
:default:0首次会话(使用个人资料) default 在索引 0 处

示例:

GET /inverse3/0/config/navigation?session=:default:0
WebSocket 会话不需要选择器

在 WebSocket 连接中,你 本次会话 — 您的 configurecommands 条目会自动针对当前会话中的设备。会话 选择器仅在以下情况下需要: 超文本传输协定 请求(包括跨会话 远程控制 — 参见 会话).