주요 내용으로 이동

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 업그레이드 후에도 통합된 기능은 별도의 수정 없이 계속 실행될 것입니다.

주의

3.0 API 버전 지원은 4.0 중단됩니다.

  • 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) 세션 단위의 전역 설정 스위치가 아니라, 장치별로 하나씩 적용됩니다. 전체 사전 설정 이름 목록은 시뮬레이션 참조 문서의 ‘구성’ 장。

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.