00. 장비 목록
HTTP REST API를 통해 연결된 모든 Haply 기기를 감지합니다. WebSocket이 필요하지 않습니다. 런타임 환경이 활성화되어 있는지, 하드웨어를 인식하는지 확인하는 간단한 스모크 테스트입니다.
학습 내용:
- 조회
GET /devices, 음 Inverse3, VerseGrip 및 무선 VerseGrip 기기를 나열하기 - JSON 응답에서 장치 ID를 추출하고, 장치 유형별로 그룹화하기
- 세션 선택기를 사용하여 세션의 원시 장치 좌표와 애플리케이션 공간 뷰 간을 전환하기
진행 절차
- 보내주세요
GET http://localhost:10001/devices. - JSON 응답을 파싱하세요 — 최상위 수준에 세 개의 배열이 있습니다:
inverse3,verse_grip,wireless_verse_grip. - 장치 ID를 유형별로 그룹화하여 표시하십시오. 빈 배열은 해당 유형의 장치가 감지되지 않았음을 의미합니다.
- 만약 한 세션 선택기 als
?session=<selector>이 옵션이 추가되면, 해당 세션의 장치에 대한 응답이 필터링되고 좌표가 해당 애플리케이션 공간으로 변환됩니다(기저, 장착 및 작업 공간 적용). Python 예제에서는 이를 CLI 인수로--session SELECTOR준비됨 (승인됨):profile:instance,#id,:-1,:0, …) — 다음에서와 동일한 플래그와 도움말 텍스트를 사용하여 튜토리얼 08 (HTTP 원격 구성) 사용되므로, 여기서 찾은 선택자를 바로 그곳에 삽입할 수 있습니다. C++ 예제에서는 선택자 없이 쿼리를 수행합니다.
매개변수
| 매개변수 | 표준 | Zweck |
|---|---|---|
| 서비스 URL | http://localhost:10001 | HTTP의 기본 URL |
| 종점 | /devices | 장치 인식의 종단점 |
| 세션 선택기 | (keiner) | ?session=:0, ?session=:-1, ?session=:my_profile:0, ?session=co.haply.hub::*:0 (글로브 와일드카드 지원) — 참조 셀렉토렌. 파이썬 예제에서는 다음과 같이 --session SELECTOR 사용 가능 (다음과 동일한 플래그: 튜토리얼 08). |
중요한 코드
- 파이썬
- C++ (nlohmann)
- C++ (Glaze)
이 파이썬 예제에서는 세션 선택기를 argparse 인수로 --session SELECTOR bereit. 이 인수가 없으면 장치가 원시 장치 좌표로 반환되며, 인수가 지정되면 선택된 세션으로 필터링되어 애플리케이션 좌표계로 변환됩니다. 도움말 텍스트는 다음의 내용과 동일합니다. 튜토리얼 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++ 버전은 다음을 사용합니다. libhv HTTP 및 nlohmann/json 파싱용입니다. 이 도구는 최상위 수준의 각 키를 수동으로 검사하여 contains() 배열이 비어 있지 않은 경우 배열을 순회합니다. C++ 예제에는 세션 선택기를 위한 CLI 인수가 포함되어 있지 않으므로 — 다음을 추가하십시오. ?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
Glaze 변형은 JSON의 형식을 반영하는 간단한 구조체(Struct)를 선언하며, 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());
}
또한 튜토리얼 00은 SDK와 함께 로컬에 설치되어 있습니다. 서비스의 설치 디렉터리 내 다음 경로를 확인해 보세요. tutorials/00-haply-inverse-device-list/ nach.