본문으로 이동

버전 3.5로 마이그레이션

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

여기에 나열된 모든 구식 표기법은 하위 호환성을 보장하기 위해 서비스에서 여전히 허용됩니다. 업그레이드 시에도 정상 작동하는 기능이 중단되는 일은 없으므로, 편하신 시기에 마이그레이션을 계획하시기 바랍니다.

API 버전 3.0 et 3.x​

이 서비스는 두 가지 JSON 형식을 동시에 노출합니다: 기존 형식 3.0 항구에서 10000 그리고 현재 형식 3.x 항구에서 10001. 이 두 가지는 하위 호환성을 보장하기 위해 계속 제공됩니다 — 통합 기능 3.0 업그레이드 시에도 변경 없이 계속 작동합니다.

주의

API 버전에 대한 지원 3.0 ~을 위해 버려질 것이다 4.0.

  • API 3.0

    • 다음 자료에 자세히 기록되어 있습니다. 문서 페이지 3.0.x.
    • HTTP sur http://localhost:10000/3.0/.
    • Websockets 항구에서 10000.

  • API 3.x

    • 다음 자료에 자세히 기록되어 있습니다. 문서 페이지 3.x.
    • HTTP sur 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 (ou defaults)
workspace_centerarm_front_centered

사전 설정은 기기를 통해 다음과 같은 방법으로 적용됩니다. inverse3[*].configure.preset (ou 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 참조 — 위에서 나열된 현재 HTTP 경로 및 더 이상 사용되지 않는 엔드포인트에 대한 대체 경로를 보여주는 Swagger UI 인터페이스.