00. Liste des appareils

Détecte tous Haply connectés via l'API REST HTTP — aucun WebSocket n'est nécessaire. Un simple test de fonctionnement permettant de vérifier que l'environnement d'exécution est opérationnel et détecte le matériel.

Ce que vous apprendrez :

• Interrogation GET /devices pour répertorier les appareils Inverse3, VerseGrip et Wireless VerseGrip
• Lecture des identifiants des appareils dans la réponse JSON, regroupés par type d'appareil
• Utilisation d'un sélecteur de session pour basculer entre les coordonnées brutes du périphérique et la vue dans l'espace applicatif d'une session

Flux de travail

1. Envoyer GET http://localhost:10001/devices.
2. Analyser la réponse JSON — trois tableaux de niveau supérieur : inverse3, verse_grip, wireless_verse_grip.
3. Affichez les identifiants des périphériques regroupés par type. Les tableaux vides indiquent qu'aucun périphérique de ce type n'a été détecté.
4. Si un sélecteur de session est joint en annexe sous la forme ?session=<selector>, la réponse est filtrée pour les appareils de cette session et les coordonnées sont converties dans son espace d'application (base, montage et espace de travail appliqués). L'exemple Python expose cette fonctionnalité sous forme d'argument de ligne de commande ; les exemples C++ effectuent la requête sans sélecteur.

Paramètres

Paramètres	Par défaut	Objectif
URL du service	http://localhost:10001	URL de base HTTP
Point d'extrémité	/devices	Point de terminaison de détection des périphériques
Sélecteur de session	(aucun)	?session=:0, ?session=:-1, ?session=:my_profile:0 — voir Sélecteurs. Exposé sous forme d'argument CLI dans l'exemple Python.

Code d'accès

Python

L'exemple Python expose le sélecteur de session sous forme d'argument de ligne de commande. Sans cet argument, les périphériques sont renvoyés sous forme de coordonnées brutes dans l'espace périphérique ; avec cet argument, ils sont filtrés en fonction de la session sélectionnée et convertis dans l'espace applicatif.

def main():
    session = sys.argv[1] if len(sys.argv) > 1 else 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)

La variante C++ utilise libhv pour HTTP et nlohmann/json pour l'analyse. Il vérifie manuellement chaque clé de premier niveau avec contains() et parcourt le tableau s'il n'est pas vide. Les exemples en C++ ne prennent pas en charge l'argument CLI « session-selector » — ajouter ?session=<selector> à l'URL si vous avez besoin des coordonnées de l'espace d'application.

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)

La variante Glaze déclare des structures simples qui reflètent la structure JSON — Glaze les remplit par réflexion à la compilation. Non contains() Vérifications nécessaires : les tableaux manquants sont renvoyés comme vides 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());
}

Source : Python · C++ · C++ Glaze

À lire également : Conventions JSON · Sélecteurs · Sessions