セレクタ
セレクタは、HTTPリクエストやWebSocketコマンドがどのデバイスおよびどのセッションを対象としているかを特定します。
デバイス選択ツール — URLパス
すべてのデバイスレベルのHTTPルートで次のように使用されます /{device_type}/{id_or_index}/….
| ルートの例 | セレクターの意味 |
|---|---|
inverse3/0 | インデックスInverse3 最初のInverse3 (0から始まる) |
inverse3/A14 | デバイスIDInverse3 A14 |
inverse3/* | すべてのInverse3Inverse3 (ワイルドカード) |
*inverse/* | Inverseシリーズ全機種(Inverse3、Inverse3x、Minverse) |
verse_grip/0 | インデックスによる最初の有線VerseGrip |
wireless_verse_grip/* | すべてのワイヤレス・バースグリップ |
*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回 |
:-1 | インデックス別:前回のセッション |
profile_name | このプロファイルでの初回セッション(曖昧な表現である可能性があります) |
profile_name:0 | プロフィールとインデックス0を含む最初のセッション |
:default:0 | プロフィールを使用した初回セッション default インデックス0の位置で |
例:
GET /inverse3/0/config/navigation?session=:default:0
WebSocketセッションにはセレクタは必要ありません
WebSocket接続では、 は セッション — あなたの configure そして
commands エントリは自動的に現在のセッションのデバイスを対象とします。セッション
セレクタが必要なのは、 HTTP リクエスト(セッションをまたぐ
リモートコントロールを含む — 参照 セッション).