3.5로 마이그레이션

이 페이지는 Inverse Service 3.5에 대한 통합 업그레이드 가이드입니다. 이 가이드에서는 해당 서비스에 여전히 포함된 모든 비추천 기능, 즉 더 이상 사용되지 않는 Wire 형식을 다룹니다. 3.0, 그 제거는 4.0 구식 HTTP 엔드포인트와 세션 채널용 구식 시뮬레이션 명령어를 제거할 예정입니다.

여기에 나열된 모든 비추천 기능은 하위 호환성을 위해 프로토콜 측면에서 계속 허용됩니다. 업그레이드 시에도 문제가 발생하지 않습니다. 편하신 시기에 마이그레이션을 진행하시기 바랍니다.

API 버전 `3.0` vs. `3.x`

이 서비스는 두 가지 병렬 JSON 형식을 제공합니다: 레거시 형식 3.0 auf Port 10000 그리고 현재 형식 3.x auf Port 10001. 하위 호환성을 위해 두 가지 모두 계속 사용할 수 있습니다. 3.0-업그레이드 후에도 통합 작업은 변함없이 계속 진행됩니다.

경고

API 버전에 대한 지원 3.0 ~에 사용됩니다 4.0 제거됨.

3.0 API
- 전체 내용은 3.0.x-문서 페이지 설명되어 있다.
- HTTP unter http://localhost:10000/3.0/.
- Websockets auf Port 10000.
3.x API
- 전체 내용은 3.x-문서 페이지 설명되어 있다.
- HTTP unter http://localhost:10001/.
- Websockets auf Port 10001.
- 기능이 개선되었으며 게임 엔진과의 연동 속도가 빨라졌습니다.

편하신 때에 업그레이드를 계획하세요. 기존 워크플로에는 아무런 영향이 없습니다.

사용 중단된 HTTP 엔드포인트

다음 엔드포인트들은 계속 허용되지만, 사용 중단 경고가 표시됩니다. 이 엔드포인트들은 4.0 제거되었습니다. 대신 대체 경로를 이용하십시오.

사용되지 않는 경로	에르자츠
`POST /force_scale`	`POST /settings/devices/force_scale`
`POST /gravity_compensation`	`POST /{type}/{id}/config/gravity_compensation`
`POST /torque_scaling`	`POST /{type}/{id}/config/torque_scaling`
`POST /device_handedness`	`POST /{type}/{id}/config/handedness`
`POST /serial_enable`	`POST /settings/system/serial_enable`
`POST /experimental/features/grip_dropped_simulation_stopper`	`POST /settings/features/grip_hook/enabled`
`POST /experimental/features/screensaver_enable`	`POST /settings/features/screensaver/enabled`

구식 경로 하나하나가 http-route-deprecated-이벤트 채널에서 기존 경로와 그 대체 경로를 모두 포함하는 이벤트를 선택합니다.

세션 채널용 구식 명령어

다음 두 가지 세션 수준 시뮬레이션 명령어는 더 이상 사용되지 않는 것으로 표시되어 있으며, 향후 주요 버전 업데이트 시 제거될 예정입니다. 다만 프로토콜 측면에서는 계속해서 허용됩니다. 새로운 통합에서는 대신 ‘대체’ 열에 나열된 configure-항목을 사용합니다.

구식 명령어 하나하나가 command-deprecated-이벤트 채널에서 이벤트를 비활성화합니다.

`session.set_coordinate_origin` → `inverse3[*].configure.preset`

// Old — deprecated
{ "session": { "set_coordinate_origin": { "coordinate_origin": "workspace_center" } } }

// New — canonical
{ "inverse3": [ { "device_id": "…", "configure": { "preset": { "preset": "arm_front_centered" } } } ] }

값 할당:

Alter `coordinate_origin`	새로운 프리셋
`device_base`	`arm_front` (또는 `defaults`)
`workspace_center`	`arm_front_centered`

프리셋은 기기별로 inverse3[*].configure.preset angewendet (또는 configure.preset (Verse Grip 또는 Wireless Verse Grip의 장치 항목에서), 세션 전체에 적용되는 스위치로 사용되지 않습니다. 프리셋 이름의 전체 목록은 구성 섹션 시뮬레이션 참조 자료에서.

`session.set_basis` → `session.configure.basis`

// Old — deprecated
{ "session": { "set_basis": { "basis": { "permutation": "X-ZY" } } } }

// New — canonical
{ "session": { "configure": { "basis": { "permutation": "XZ-Y" } } } }

축의 부호 규칙이 변경되었습니다.

참고 자료

채용 참고 자료
WebSocket 프로토콜 — 전체 스냅샷 및 스트리밍 프레임의 구조.
AsyncAPI 참조 — 모든 v3.1 페이로드에 대한 기계 가독형 스키마.
HTTP API 참조 — Swagger UI를 통해 현재 사용 중인 HTTP 경로와, 위에 나열된 더 이상 사용되지 않는 엔드포인트를 대체하는 경로를 확인할 수 있습니다.

API 버전 3.0 vs. 3.x​

사용 중단된 HTTP 엔드포인트​

세션 채널용 구식 명령어​

session.set_coordinate_origin → inverse3[*].configure.preset​

session.set_basis → session.configure.basis​

참고 자료​