본문으로 건너뛰기

3.5로 전환

이 페이지는 Inverse Service 3.5 통합 업그레이드 가이드입니다. 이 가이드에서는 서비스에 남아 있는 모든 비권장 항목을 다룹니다. 구체적으로는,4.0 삭제될 예정인 구형 3.0 와이어 포맷, 더 이상 권장되지 않는 HTTP 엔드포인트, 그리고 더 이상 권장되지 않는 세션 채널 시뮬레이션 명령어입니다.

여기에 나열된 모든 비권장 항목은 하위 호환성을 위해 계속해서 와이어를 통해 수신됩니다. 업그레이드하더라도 아무런 문제가 발생하지 않습니다. 편리한 시기에 맞춰 마이그레이션을 계획해 주십시오.

3.0 그리고 3.x API 버전​

이 서비스는 두 가지 JSON 형식을 동시에 제공합니다. 포트 10000 의 레거시 3.0 포맷 및 포트 10001 의 현재 3.x 포맷입니다. 두 가지 모두 하위 호환성을 위해 계속 사용할 수 있도록 유지됩니다.3.0 의 통합 기능은 업그레이드 후에도 변경 없이 계속 작동합니다.

경고

4.0 그럼 3.0 API 버전에 대한 지원이 종료됩니다.

  • 3.0 API

    • 자세한 내용은 3.0.x 문서 페이지에 기재되어 있습니다.
    • HTTP 는 http://localhost:10000/3.0/ 에서 이용할 수 있습니다.
    • Websockets 는 포트 10000 에서 이용할 수 있습니다.

  • 3.x API

    • 자세한 내용은 3.x 문서 페이지에 기재되어 있습니다.
    • HTTP 는 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(또는 verse grip / 무선 verse grip 장치 항목의 configure.preset)를 사용합니다. 프리셋 이름의 전체 목록에 대해서는 시뮬레이션 참조 문서의 'Configure' 섹션 를 참조하십시오.

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.