주요 콘텐츠로 건너뛰기
버전: 3.5.x

3.5로 마이그레이션

이 페이지는 Inverse Service 3.5에 대한 통합 업그레이드 가이드입니다. 이 가이드는 서비스에 여전히 남아 있는 모든 비추천 기능, 즉 레거시 3.0 다음에 삭제될 예정인 와이어 형식 4.0, 더 이상 사용되지 않는 HTTP 엔드포인트, 그리고 더 이상 사용되지 않는 세션 채널 시뮬레이션 명령어.

여기에 나열된 모든 비추천 기능은 하위 호환성을 위해 여전히 네트워크 상에서 허용됩니다. 업그레이드 시에도 아무런 문제가 발생하지 않으므로, 편하신 때에 마이그레이션을 진행하시기 바랍니다.

3.0 vs 3.x API 버전​

이 서비스는 두 가지 병렬 JSON 형식을 제공합니다: 레거시 3.0 형식 포트에서 10000 그리고 현재 3.x 포트의 형식 10001. 두 가지 모두 이전 버전과의 호환성을 위해 계속 제공됩니다 — 3.0 업그레이드 후에도 통합 기능은 변함없이 계속 실행됩니다.

경고

3.0 다음에 대한 API 버전 지원이 중단됩니다. 4.0.

  • 3.0 API

  • 3.x API

    • 전체 문서는 3.x 문서 페이지.
    • HTTP on http://localhost:10001/.
    • Websockets 항구에서 10001.
    • 기능이 개선되었으며 게임 엔진과의 연동 속도가 빨라졌습니다.

편리한 시간에 업그레이드하세요 — 기존 업무 흐름에 지장이 없습니다.

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

다음 엔드포인트는 여전히 사용 가능하지만, 사용 중단 예정 경고가 표시됩니다. 이 엔드포인트들은 4.0. 대신 대체 경로를 이용하십시오.

사용 중단된 경로교체
POST /force_scalePOST /settings/devices/force_scale
POST /gravity_compensationPOST /{type}/{id}/config/gravity_compensation
POST /torque_scalingPOST /{type}/{id}/config/torque_scaling
POST /device_handednessPOST /{type}/{id}/config/handedness
POST /serial_enablePOST /settings/system/serial_enable
POST /experimental/features/grip_dropped_simulation_stopperPOST /settings/features/grip_hook/enabled
POST /experimental/features/screensaver_enablePOST /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" } } } ] }

값 매핑:

옛날 coordinate_origin새로운 사전 설정
device_basearm_front (또는 defaults)
workspace_centerarm_front_centered

사전 설정은 다음을 통해 기기별로 적용됩니다 inverse3[*].configure.preset (또는 configure.preset (Verse Grip / 무선 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 참조 — 위에서 언급된 현재 HTTP 경로 및 더 이상 사용되지 않는 엔드포인트에 대한 대체 경로를 확인할 수 있는 Swagger UI.