00. デバイス一覧

HTTP REST API を通じて、接続されているすべてのHaply 検出します。WebSocket は不要です。ランタイムが起動しており、ハードウェアを検出できているかを確認するための簡単な動作確認テストです。

学習内容：

• クエリの実行 GET /devices Inverse3、VerseGrip、およびWireless VerseGripデバイスを一覧表示する
• JSONレスポンスからデバイスIDを読み取り、デバイスタイプごとにグループ化する
• セッションセレクタを使用して、デバイスの生座標とセッションのアプリケーション空間ビューを切り替える

ワークフロー

1. 送信 GET http://localhost:10001/devices.
2. JSONレスポンスを解析する — 3つの最上位の配列： inverse3, verse_grip, wireless_verse_grip.
3. デバイスIDをタイプごとにグループ分けして出力します。配列が空の場合は、そのタイプのデバイスが検出されていないことを意味します。
4. もし……なら セッションセレクタ は次のように付加されます ?session=<selector>, レスポンスはそのセッションのデバイスにフィルタリングされ、座標はそのアプリケーション空間（基底、マウント、ワークスペースが適用された状態）に変換されます。Pythonのサンプルでは、これを --session SELECTOR CLI引数（以下の形式を受け付けます :profile:instance, #id, :-1, :0, …) — 同じヘルプテキストを持つ同じフラグが チュートリアル 08（HTTP リモート設定） で使用されるため、ここで見つけたセレクタをそのままそこに貼り付けることができます。C++のサンプルでは、セレクタなしでクエリを実行しています。

パラメータ

パラメータ	デフォルト	目的
サービスのURL	http://localhost:10001	HTTPのベースURL
エンドポイント	/devices	デバイス検出エンドポイント
セッションセレクタ	(なし)	?session=:0, ?session=:-1, ?session=:my_profile:0, ?session=co.haply.hub::*:0 （glob ワイルドカードに対応） — 参照 セレクタ. 暴露されたとして --session SELECTOR Pythonのサンプルでは（同じフラグとして チュートリアル 08).

キーコード

Python

このPythonサンプルでは、セッションセレクタを --session SELECTOR argparse の引数です。これを指定しない場合、デバイスは生のデバイス空間座標で返されます。指定すると、選択されたセッションにフィルタリングされ、アプリケーション空間に変換されます。ヘルプテキストは次のように表示されます チュートリアル 08（HTTP リモート設定） つまり、ここで見つけたセレクタを、そのままそこに貼り付けることができます。

def parse_args():
    parser = argparse.ArgumentParser(
        description="List connected Haply Inverse devices via the HTTP API.")
    parser.add_argument(
        "--session", type=str, default="",
        help=(
            "Session selector. Formats:\n"
            "  :profile:instance   by profile name (e.g. ':my_profile:0')\n"
            "  pattern:instance    glob wildcard in profile (e.g. 'co.haply.hub::*:0')\n"
            "                      '*' matches any sequence, '?' one character\n"
            "  #session_id         by numeric id (e.g. '#42' — quote in shells to escape '#')\n"
            "  :-1                 the last active session\n"
            "  :0                  the first session"
        ))
    return parser.parse_args()

def main():
    args    = parse_args()
    session = args.session or None

    url = f"{BASE_URL}/devices"
    if session:
        url += f"?session={session}"
        print(f"Querying devices for session '{session}' (application space)\n")
    else:
        print("Querying all detected devices (device space)\n")

    r = requests.get(url, timeout=3)
    r.raise_for_status()
    data = r.json()

    print_devices("Inverse3", data.get("inverse3"))
    print_devices("Wired Verse Grip", data.get("verse_grip"))
    print_devices("Wireless Verse Grip", data.get("wireless_verse_grip"))

C++ (nlohmann)

C++版では libhv HTTP用と、パース用にnlohmann/jsonを使用しています。これは、各トップレベルキーを contains() かつ、配列が空でない場合はそれを反復処理します。C++のサンプルでは、セッションセレクタのCLI引数は公開されていません — append ?session=<selector> アプリケーション空間の座標が必要な場合は、URLにアクセスしてください。

HttpResponsePtr resp = requests::get("localhost:10001/devices");
if (resp == nullptr) { /* ... error ... */ return 1; }

json data = json::parse(resp->body);

if (data.contains("inverse3") && !data["inverse3"].empty()) {
    printf("Inverse3 found:\n");
    for (auto &element : data["inverse3"]) {
        printf("   (id: %s)\n", element["device_id"].get<std::string>().c_str());
    }
}
// ... same pattern for verse_grip and wireless_verse_grip

C++ (Glaze)

Glazeのバリアントは、JSONの構造を反映したプレーンな構造体を宣言します。Glazeはコンパイル時のリフレクションを通じてこれらを埋めます。いいえ contains() 確認事項：欠落している配列は空として返される std::vector<>.

static constexpr glz::opts glz_settings{.error_on_unknown_keys = false};

struct device_entry { std::string device_id; };
struct devices_response {
    std::vector<device_entry> inverse3;
    std::vector<device_entry> verse_grip;
    std::vector<device_entry> wireless_verse_grip;
};

// In main():
HttpResponsePtr resp = requests::get("localhost:10001/devices");
devices_response data;
if (auto err = glz::read<glz_settings>(data, resp->body)) {
    printf("JSON parse error: %s\n", glz::format_error(err, resp->body).c_str());
    return 1;
}

for (const auto &dev : data.inverse3) {
    printf("   (id: %s)\n", dev.device_id.c_str());
}

SDKインストーラーに同梱

チュートリアル 00 も SDK とともにローカルにインストールされています。次の場所を確認してください tutorials/00-haply-inverse-device-list/ サービスのインストールディレクトリの下に。

出典： Python·C++·C++ Glaze

関連項目： JSONの規約·セレクタ·セッション