독립형 Inverse

Haply 기기용 서비스 런타임 및 런타임 SDK입니다. 편리한 설치 프로그램으로 묶여 있습니다. “external” 서비스라고도 합니다.

v3.5.7

출시일 2026년 10월 13일 오후 8시 15분

...시스템 감지 중...

릴리스 노트

하이라이트 {#highlights}

Minverse 잉크웰에 스타일러스를 도킹하면 이제 스타일러스가 암을 따라 곧바로 향합니다. 도킹된 스타일러스의 방향(heading) 값이 135도에서 180도로 변경됩니다. 이는 기본 세션에서 3.5.6 버전 대비 예상되는 유일한 시각적 차이입니다. 게이트나 옵트인 없이 적용되며, 핸들 펌웨어 1.3.1 이상을 사용하는 모든 사용자에게 해당됩니다. 자세한 내용은 아래 수정 사항에서 설명합니다.

세션 중 기기의 방향 정보가 이제 실시간으로 반영됩니다. state.body_orientation이 애플리케이션은 기기가 구동을 시작하면 고정되던 기존 방식과 달리 20 Hz로 기기 상태를 추적합니다 (Inverse3 / Minverse 펌웨어 7.9 이상, 기본적으로 활성화됨).

기기 설정을 재설정하면 이제 해당 기기에 실제로 저장된 값이 복원됩니다. config/torque_scaling, config/중력 보정, config/손잡이에 대한 DELETE는 서비스에서 컴파일된 공장 기본 상수 대신 기기가 전원을 켰을 때의 값을 반환합니다. 따라서 왼손 모드로 저장된 기기가 더 이상 오른손 모드로 재설정되지 않습니다.

기기 범위 설정 변경 시 더 이상 기본 이벤트 채널로 알림이 전송되지 않습니다. 공유 마운트 또는 body-orientation 쓰기 작업이 한 번 발생할 때마다 기기를 보유한 각 세션마다 세션 업데이트됨가 발생했으며, 이들 중 어느 것도 디바이스를 명시하지 않았습니다. 디바이스를 보유한 모든 세션은 여전히 다음 스냅샷에서 갱신됩니다.

내부 개선 사항 {#internal-improvements}

새로운 devices/*inverse/body_orientation_poll_interval_ms 설정(기본값) 50 ms, 0(비활성화, 허용 범위 0–5000)을 통해 실시간 방향 값 읽기 주기를 조정할 수 있습니다. 단, 50 ms 장치 동작 타이머가 실질적인 최소값으로 작용합니다.

펌웨어 7.9 미만의 기기에서는 이제 방향 값이 사용되는 곳마다 별도로 경고가 표시됩니다. 따라서 구형 펌웨어에서는 devices/*idle 상태에서의 방향 조회 역방향 조회이 기능을 켜면 이 설정이 작동하지 않는다는 경고가 표시되며, 이전처럼 아무런 메시지 없이 넘어가지 않습니다.

더 이상 최신 위치 데이터를 제공하지 않는 기기에 대해서는 이제 한 번만 경고합니다. 이전에는 마지막으로 수신된 값을 영구적으로 그대로 보고했습니다. 저장된 값 자체는 변경되지 않으므로 기기는 계속 사용할 수 있습니다.

세션 범위의 config/mount 또는 config/body_orientation 쓰기 작업은 이전과 마찬가지로 기본 이벤트 채널로 알림을 전송합니다. 기기 범위 관련 알림만 제거되었으며, 손잡이, 토크 스케일링, 중력 보정세션별 알림은 그대로 유지됩니다.

수정 사항 {#fixes}

Minverse 잉크웰 도킹 보정 결과, 도킹된 스타일러스가 45도 부족하게 설정되었습니다. 잉크웰 보정 시 도킹된 스타일러스에 설정되는 방향 값이 135도에서 180도로 변경되었으며, 이 값은 devices/*inverse/inkwell/dock_heading_deg 설정이 완료되었습니다. 2026년 9월 22일, 핸들 펌웨어 1.3.1 버전의 스타일러스가 장착된 Minverse에서 측정을 진행했습니다. 기존 135도 값은 도킹된 펜의 각도를 45도 부족하게 만들었기 때문에, 요(yaw) 추정기가 이를 보정해야 했습니다(관측값 +42~+50도). 이제 잔차는 약 5도 이내로 줄었습니다. 단계적 적용 대상이 아닙니다. 도킹 보정 절차는 항상 실행되므로, 핸들 펌웨어 1.3.1 이상을 사용하는 모든 사용자의 도킹된 펜 게시 방향 값이 45도 변경됩니다. 이 하한치 미만인 경우 펌웨어가 해당 값을 무시하고 전체 자세를 즉시 조정하므로, 해당 사용자에게는 변화가 없습니다.

state.body_orientation이전에는 디바이스가 유휴 상태일 때만 갱신되었습니다. 따라서 애플리케이션이 강제 스트리밍을 시작하는 순간 값이 고정되었고, 모든 사용처에서 오래된 핸드셰이크 스냅샷을 읽게 되었습니다. 이제 기존 모션 타이머를 통해 폴링되며, 세션 중에 실시간으로 갱신됩니다.

config/torque_scaling, config/중력 보정, config/손잡이에 대한 DELETE는 디바이스 자체 저장 설정 위에 컴파일된 공장 초기값을 기록했습니다. 그래서 ‘기본값으로 재설정’ 시 디바이스의 실제 전원 켜짐 상태가 달라졌으며, config/손잡이는 저장된 값과 상관없이 항상 오른쪽로 고정되었습니다. 이제 세 항목 모두 저장된 값을 복원하며, 디바이스에서 한 번도 읽히지 않은 필드에 한해 기존 상수로 대체합니다.

디바이스 수준 설정 변경 한 건이 해당 디바이스를 보유한 각 세션마다 이벤트 하나를 발생시켰습니다. 페이로드에는 session_id, 프로필, 범위...만 포함되어 있고 디바이스 식별자가 없었기 때문에, 구독자는 복사본을 할당하거나 중복을 제거할 수 없었습니다. 디바이스 주소 지정 방식을 대체할 알림이 마련될 때까지 디바이스 범위 알림은 보류됩니다. 세션별 갱신은 그대로 유지됩니다.

잠재적인 호환성 문제 항목 {#potential-breaking-changes}

config/torque_scaling 삭제, config/중력 보정, config/손잡이재설정의 의미로 변경합니다. 응답 및 기록되는 값은 이제 서비스에 고정된 상수가 아니라 기기에 저장된 설정입니다. 응답 형식은 변경되지 않으며, 값은 저장된 설정이 공장 출하 시 설정된 상수와 다른 기기에서만 달라집니다. 하지만 리터럴 상수(false / {enabled: true, scaling_factor: 0.0} / 오른쪽)를 기대했던 연동은 다른 값을 받게 됩니다.

state.body_orientation은 정확한 형식과 티어를 그대로 유지하지만 값의 의미가 달라집니다. 스트리밍 클라이언트에 있어 사실상 정적이었던 필드가 이제 20 Hz로 변합니다. 연결 후 이를 상수로 취급하던 사용처는 별도의 옵트인 절차 없이도 새로운 동작을 보게 됩니다.

장치 범위 쓰기가 원인인 경우, `:10020` 구독자는 옵트인 없이 `config.mount` 또는 `config.body_orientation`에 대한 `session-updated`를 더 이상 수신하지 않습니다. 사용이 중단된(deprecated) 플랫 본문_방향 범위도 같은 경로를 따르며 기본 채널로 다시 새어 나가지 않습니다. 마이그레이션: 이벤트를 갱신 트리거로 취급하지 말고 세션 스냅샷에서 값을 읽어오십시오. 스냅샷은 별도의 옵트인 없이도 보유 중인 모든 세션에서 계속 갱신됩니다. 이에 대응하는 세션 범위 이벤트와 손잡이 / 토크 스케일링 / 중력 보정 알림은 영향을 받지 않습니다.

도킹된 스타일러스의 게시된 방향 값이 45도 변경됩니다. 여기서는 단지 상호 참조만 제공합니다. 이는 버그 수정 사항이며, 하이라이트 및 수정 사항에 게시되어 있습니다. 핸들 펌웨어 1.3.1 이상을 사용하는 모든 사용자에게 별도의 옵트인 절차 없이 관찰 가능한 값이 변경되므로, 이 항목에도 기록합니다. 기존 135도 기준값에 맞춰 자체 애플리케이션을 보정해 둔 경우에는 실제 마이그레이션 작업이 필요합니다. 모양(shape)은 변경되지 않습니다.

지원 중단 예정 기능 {#deprecations}

이번 릴리스에서 새롭게 지원이 중단된 항목은 없습니다. devices/*idle 상태에서의 방향 조회 역방향 조회은 새로운 폴링 간격이 0이 아닐 때마다 중복(redundant)이 되지만, 3.5.7에서는 의도적으로 사용 중단로 표시하지 않았습니다. 해당 기능의 지원 중단은 3.6 버전에서 예정되어 있습니다.