本文へスキップ
バージョン: 3.5.x

セレクタ

セレクタは、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 ワイルドカードセレクタを拒否する(曖昧なため) → 400
  • POST そして 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 または 123IDが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 リクエスト(セッションをまたぐ リモートコントロールを含む — 参照 セッション).