로딩 중...

Haply 장치용 서비스 런타임 및 런타임 SDK입니다. 편리한 설치 프로그램으로 묶여 있습니다. "external" 서비스라고도 합니다.
3.5.8은 핫플러그 및 재연결과 마운트 프리셋에 중점을 둔 패치 릴리스입니다. 공개 C API는 3.5.7과 동일하게 유지되며, 제거된 라우트도 없습니다. 기본 설정을 사용하는 클라이언트에 적용되는 모든 변경 사항은 3.5.7에 포함되었던 버그에 대한 수정이며, 진단 메시지도 더 명확해졌습니다. 이번 주기의 새로운 기능은 SDK의 옵트인 스테이지 스위치 뒤에 있으며, 이 스위치는 기본적으로 꺼져 있습니다. 따라서 기본 설정 클라이언트에는 보이지 않습니다.
3.5.7과 달리, 이번 릴리스는 기본 설정 클라이언트가 관찰하는 동작을 여덟 곳에서 변경합니다. 다섯 가지는 광범위한 변경입니다. 디바이스는 해당 세션이 등록하기 전까지 세션에서 제외됩니다. state.current_cursor_position은 애플리케이션 공간으로 이동합니다. 힘 게이트는 세션별로 적용됩니다. 마운트 쓰기에는 단위 회전이 필요합니다. 가운데 정렬 프리셋은 디바이스의 현재 회전값을 기준으로 적용되며, custom 또는 defaults를 보고할 수 있습니다. 나머지 세 가지는 범위가 더 좁습니다. Minverse에서 arm_front와 defaults는 세션 마운트를 초기화하고 state.body_orientation 값이 변경됩니다. 그리고 device-connection-loop은 디바이스 이름이 없는 리시버에 대해서도 발생할 수 있습니다. 각 항목은 누가 이를 알아차리는지, 그리고 어떻게 마이그레이션하는지와 함께 잠재적 호환성 변경 사항에 나열되어 있습니다.
엔지니어링 참고용 변경 로그(__CODE_code-1__)에는 스테이지 게이트 API의 세부 사항, 이번 수정 사항의 내부 동작 방식, 설계 기록 참조 및 이슈 참조가 정리되어 있습니다.
device-safety-triggered 이벤트도 다시 전달됩니다. 3.5.7에서는 서비스가 재시작되기 전까지 이 기능들이 유실되었습니다.device-connection-loop 이벤트를 하나씩 받습니다. 다시 연결하면 그립 기능이 즉시 복구됩니다.state.body_orientation과 디바이스 마운트 기준값이 Y축을 기준으로 90도 회전하지 않게 되었습니다. 이제 캘리브레이션 자세에서 디바이스가 다시 항등(identity) 값으로 읽힙니다.state.current_cursor_position은 이제 바로 옆의 cursor_position과 같이 세션의 애플리케이션 공간에서 보고됩니다. 따라서 명령으로 보낸 위치가 전송할 때 사용한 좌표계 그대로 되돌아옵니다.device not found 경고를 한 번 기록하고, 10초마다 누락된 명령 수와 함께 알림을 남기며, 디바이스가 다시 발견되면 device found again 줄을 한 번 기록합니다. 명령마다 한 줄씩 기록하던 이전 방식은 벤치 테스트에서 2.5초 동안 16,939줄을 기록했습니다.POST /ports/{port}/reset은 이제 응답하지 않는 리시버의 백오프도 취소하므로, 다음 재오픈 시도가 즉시 실행됩니다.핫플러그 및 재연결
GET /devices?session=)으로 전달됩니다.Unable to serialize 줄 2,178개, 수신기를 한 번 다시 꽂았을 때 3ms 동안 11개).마운트 및 프리셋
configure.mount가 0 또는 NaN 스케일을 허용하여 모든 힘 및 위치 목표가 inf/NaN이 되었으며, HTTP는 [1, 5.5] 범위를 벗어나는 유효한 스케일을 거부했습니다. 이제 두 전송 방식 모두 동일한 규칙을 적용합니다. 즉, 어떤 축에서도 0에 가깝지 않은 모든 유한한 스케일을 허용합니다.DELETE config/mount는 config.preset에 이전 프리셋 이름을 남겨 두어, 이를 다시 적용하면 삭제된 마운트가 되살아났습니다. 또한 Minverse에서는 arm_front / defaults가 현재 마운트를 재설정하지 않고 유지했습니다.state.body_orientation과 저장된 마운트 기준값이 Y축 기준 1/4 회전만큼 어긋났습니다(왼손 좌표계 장치는 항등 기준값을 Y축 기준 +90도 회전으로 보고했습니다).장치 구성
config.gravity_compensation(v3.0 및 v3.1)과 GET /{device_type}/{id}/config/gravity_compensation이 갱신되며, 장치를 보유한 각 세션은 다음 메시지에서 전체 응답을 한 번 받습니다. 3.5.7에서는 장치의 변경 알림이 무시되어, 장치가 재연결될 때까지 이전 값이 유지되었습니다. 이전 펌웨어는 이 알림을 보내지 않으므로 해당 버전에서는 아무런 변화가 없습니다.와이어 값
XZ-Y: 전송 (x, 0.090, 0.197), 에코 (x, -0.197, 0.090)). 이제 v3.1 전체 프레임과 스트리밍 프레임에서 세션 기저와 마운트를 사용해 변환됩니다. 3.5.0부터 존재했던 문제입니다.session_id가 256에서 래핑되었습니다(세션 290이 34로 읽힘). 같은 프레임의 session.session_id에는 실제 ID가 담겨 있었습니다. 이제 문서화된 uint32 스키마와 일치하도록 전체 32비트 ID가 사용됩니다. 3.5.0부터 존재했던 문제입니다.GET /devices?session=). 3.5.7에서는 핫플러그 구간 동안 장치가 기본 값만 담긴 상태로 나타났습니다. JSON 구조는 변경되지 않았으며, 모든 커스텀 그립이 제외된 경우 기본 출력에는 custom_verse_grip: []이 그대로 유지됩니다. 영향을 받는 경우: 프레임 간 배열 위치로 장치를 인덱싱하거나, 한 프레임에서 장치가 누락되면 연결 해제로 처리하거나, 첫 프레임의 기본 값만 읽는 클라이언트. 마이그레이션: device_id로 장치를 식별하고, 장치가 포함된 첫 프레임을 연결 시점으로 간주하며, 배열 포함 여부가 아닌 이벤트 채널로 연결 해제를 감지합니다.cursor_position 및 명령된 목표 값과 일치합니다.GET/POST/DELETE /{device_type}/{id}/config/filters/force_gate 및 config.filters.force_gate.gain은 장치의 실시간 gain이 아닌 세션 자체의 값(기본값 0.3)을 반환합니다. 영향을 받는 경우: 관찰 또는 설정 세션에서 gate를 설정했거나, 장치의 실시간 값을 기대하며 값을 읽어 오던 클라이언트. 마이그레이션: force gate는 구동 중인 세션에서 설정하십시오. 실제 적용되는 값을 확인하려면 구동 세션의 값을 읽으십시오.POST|PATCH config/mount는 제곱 노름이 1e-3 이상 벗어난 쿼터니언에 대해 400 invalid mount transform (non-finite, non-unit rotation or ~zero scale axis)을 반환합니다. WebSocket configure.mount는 경고를 기록하고 이전 mount를 유지합니다. 3.5.7에서 거부되던 [1, 5.5] 범위를 벗어난 scale도 이제 허용됩니다. 영향을 받는 경우: 정규화되지 않은 쿼터니언을 전송했거나 서비스가 scale 상한을 적용하는 것에 의존하던 클라이언트. 마이그레이션: 전송 전에 쿼터니언을 정규화하고, 원하는 scale 범위는 클라이언트 UI에서 적용하십시오.arm_front_centered / led_front_centered는 적용 시점의 현재 장치 회전을 기준으로 위치를 결정합니다. 적용 후 장치가 1도 이상 회전하면 config.preset은 custom을 반환하며 config.preset에 대한 session-updated가 발생합니다. 클라이언트가 쓰기 작업을 하지 않아도 재연결이나 inkwell 재보정 후에도 이 동작이 적용됩니다. 세션 범위의 DELETE config/mount 후에는 defaults를 반환합니다. 영향을 받는 경우: config.preset 이름에 따라 동작을 분기하는 클라이언트. 마이그레이션: 장치를 이동한 후 다시 중앙 정렬하려면 preset을 재적용하십시오. custom은 "preset이 더 이상 현재 자세를 설명하지 않음"을 의미하는 것으로 처리하십시오.arm_front_centered 위치는 x = -0.13에서 x = -0.12로 변경되었습니다(하드웨어에서 수동 조정). 영향을 받는 Minverse 사용자: 해당 preset에서 커스텀 mount가 유지되기를 기대했거나 이전 중심점을 기준으로 보정한 사용자. 마이그레이션: 이전 중심점을 기준으로 수행한 Minverse 보정을 다시 확인하십시오.device_id는 해당 포트에서 마지막으로 준비 상태로 확인된 ID이며, 한 번도 없었다면 빈 값입니다. attempts는 해당 에피소드의 실패 시도 횟수이고, window_ms는 첫 실패 이후 경과 시간입니다. 페이로드 구조는 변경되지 않았습니다. 영향을 받는 경우: device_id가 비어 있지 않다고 가정하는 클라이언트. 마이그레이션: 빈 device_id를 처리하십시오.이 릴리스의 사용 가능한 전체 다운로드: