选择器
选择器用于确定HTTP请求或 WebSocket命令的目标设备及会话。
设备选择器 — URL 路径
用于所有设备级 HTTP 路由中,作为 /{device_type}/{id_or_index}/….
| 路线示例 | 选择器的含义 |
|---|---|
inverse3/0 | FirstInverse3 索引排序(从 0 开始) |
inverse3/A14 | Inverse3 设备 ID) A14 |
inverse3/* | 所有Inverse3 (通配符) |
*inverse/* | 所有 Inverse 系列设备(Inverse3、Inverse3x、Minverse) |
verse_grip/0 | 首款带线VerseGrip(按索引排序) |
wireless_verse_grip/* | 全无线 VerseGrips |
*verse_grip/* | 所有VerseGrip系列设备(有线、无线、定制) |
规则:
GET不接受通配符选择器(存在歧义)→400POST和DELETE接受通配符 — 该操作将应用于所有匹配项
支持 {device_type} 值: inverse3, verse_grip, wireless_verse_grip,
或家族通配符 *inverse, *verse_grip.
会话选择器 — ?session=<expr> 查询参数
会话作用域的 HTTP 端点(basis、mount、preset、filters、navigation、SDF)
需要一个 ?session=<expr> 查询参数,用于确定在哪个会话上下文中
进行操作。
| 表达 | 含义 |
|---|---|
| (省略) | 所有会话(允许在 DELETE (仅限) |
#123 或 123 | ID 为 123 的会话 |
:0 | 按索引排列的第一节 |
:-1 | 按索引查看上一节 |
profile_name | 首次使用此配置文件(可能存在歧义) |
profile_name:0 | 首次会话,包含个人资料 + 索引 0 |
:default:0 | 首次会话(使用个人资料) default 在索引 0 处 |
示例:
GET /inverse3/0/config/navigation?session=:default:0
WebSocket 会话不需要选择器
在 WebSocket 连接中,你 是 本次会话 — 您的 configure 和
commands 条目会自动针对当前会话中的设备。会话
选择器仅在以下情况下需要: 超文本传输协定 请求(包括跨会话
远程控制 — 参见 会话).