주요 내용으로 이동

설정 참고 사항

이 문서에는 다음 내용이 나열되어 있습니다. /settings/ 엔드포인트가 반환하는 모든 설정과 각 설정의 키、유형(출처: type_hint)와 제약(출처: metadata.constraint.range, 그리고 해당되는 경우 locked).

locked 실행 시 다음으로 설정:읽기 전용。구성 파일을 통해 또는 Haply Hub 설정 페이지에서 수정할 수 있지만, 변경 사항이 적용되려면서비스 완전히 재시작. 아래 표에서 이러한 설정은 다음과 같이 표시되어 있습니다. 부팅。

구성​

서비스 시작 시 설정을 재정의하는 데 사용되는 구성 파일은 다음 위치에 있습니다:

플랫폼위치
WindowsC:\ProgramData\Haply\Inverse\haply-inverse-service-config.json
macOS/Library/Application Support/Haply/Inverse/haply-inverse-service-config.json
리눅스/etc/haply-inverse-service/haply-inverse-service-config.json

프로필은 하나의평면 JSON 객체, 키를 재정의 값에 매핑합니다. 키는 반드시 /settings/ HTTP 라우팅에서 반환되는 유효한 설정 키 (참조: API 참조). 지정되지 않은 키에는 서비스의 기본값이 적용됩니다.

예를 들어, 네트워크 구성의 적용 예시는 다음과 같습니다:

{
"communication/http/port": 8400,
"communication/websocket/port": 8500,
"communication/events/port": 9000,
"communication/bind_all_interfaces": true
}

유형 매핑​

API가 반환하는 유형 힌트는 다음 JSON 데이터 구조와 일치합니다:

  • STRING → string
  • BOOL → bool
  • INT → int
  • FLOAT → float
  • ARR_STRING → string[]
  • VEC3 → vec3(포함) {x, y, z} (의 대상)
  • GENERIC → json(임의의 구조화된 값)

communication/…​

HTTP, WebSocket 및 이벤트 스트림 서버의 네트워크 포트와 바인딩 주소. 대부분의 항목은시작 시에만적용됩니다.

키유형제약설명
communication/serial/enabledbool—직렬 포트 장치의 통신을 활성화하거나 비활성화합니다.
communication/bind_addressstring시작 시에만HTTP 및 WebSocket 서버가 바인딩된 IP 주소.
communication/bind_all_interfacesbool시작 시에만서버를 다음 위치에 바인딩합니다. 0.0.0.0 localhost가 아니라.
communication/http/portint시작 시에만HTTP REST API 포트(기본값) 10000).
communication/websocket/portint시작 시에만v3.1 메인 WebSocket 포트(기본값 10001).
communication/websocket/legacy_portint시작 시에만v3.0 이전 버전의 WebSocket 포트(기본값) 10000).
communication/events/portint시작 시에만이벤트 스트림 WebSocket 포트 (기본값) 10020).

devices/…​

devices/detection/…​

직렬 포트 스캔 정책. 모든 항목은 고급 옵션입니다.

키유형제약설명
devices/detection/scan_period_msint범위 100–10000; 시작 시에만시리얼 포트 스캔 간격(밀리초).
devices/detection/handshake_timeout_sint범위 1–15각 포트의 핸드셰이크 시간 초과 기간(초).
devices/detection/max_retriesint범위 1–10각 포트에 대한 최대 핸드셰이크 재시도 횟수.
devices/detection/failure_log_delay_sint범위 1–60검출 실패 로그를 다시 기록하기 전의 지연 시간(초).
devices/detection/block_looping_portsbool—순환 포트가 감지되면 장치가 준비 상태로 전환되는 것을 차단합니다.
devices/detection/excluded_portsjson—검증 시 건너뛰어야 할 시리얼 포트 경로.
devices/detection/additional_portsstring[]—무조건 스캔할 추가 시리얼 포트 경로.
devices/detection/allowed_vendor_id_filterstring[]—포트 열거 시 허용되는 USB 제조업체 ID.
devices/detection/port_name_substring_filterstring[]—일치 대상이며, 플랫폼에 따라 달라지는 포트 이름의 부분 문자열.
devices/detection/wireless_verse_grip_description_filterstring[]—무선 VerseGrip 감지를 위한 포트 설명자 문자열.
devices/detection/inverse3x_description_filterstring[]—Inverse3x 검출에 사용되는 포트 설명자 문자열.
devices/detection/extra_ports (사용 중단됨)string[]—다음으로 변경해 주세요 devices/detection/additional_ports. 읽기 및 쓰기 작업은 스펙 키로 투명하게 전달됩니다.

devices/inverse*/…​

모든 Inverse3 시리즈 장치에 적용되는 전역 기본값입니다. 세션 수준에서 설정을 재정의한 경우 해당 설정이 우선 적용됩니다.

키유형제약설명
devices/inverse*/filters/force_scale/gainfloat범위 0.0–2.0모든 장치에 적용되는 전역 힘 출력 배율.
devices/inverse*/filters/force_gate/gainfloat범위 0.0–1.0새 대화의 기본 게이트 게인.
devices/inverse*/control_timeout_msint범위 50–10000장치 제어 잠금을 해제하기 전까지의 시간 초과 기간(밀리초).
devices/inverse*/query_orientation_on_idlebool—장비가 유휴 상태일 때 펌웨어를 통해 본체의 자세를 조회합니다.

devices/presets​

키유형제약설명
devices/presetsjson—각 장비 유형의 기본 구성 프리셋(마운트 변환(mount transform), 베이스(basis) 등)은 다음을 포함합니다. inverse_arm_front_*、inverse_led_front_*、minverse_*、verse_grip_default、wireless_verse_grip_default、custom_verse_grip_default。

devices/wireless_verse_grip/…​

키유형제약설명
devices/wireless_verse_grip/battery/low_thresholdint—배터리 잔량이 해당 백분율보다 낮아지면 배터리 부족 경고가 발생합니다.
devices/wireless_verse_grip/battery/critical_thresholdint—배터리 잔량이 해당 백분율보다 낮아지면 배터리 잔량 심각 부족 경고가 발령됩니다.
devices/wireless_verse_grip/battery/reset_marginint—배터리 잔량 경고가 표시되기 전의 여유량을 제거합니다.
devices/wireless_verse_grip/filters/orientation_filterjson시작 시에만무선 VerseGrip 방식의 One Euro 필터 구성.

features/…​

features/calibration/…​

키유형제약설명
features/calibration/hall_thresholdint범위 1–32보정 기간 동안 홀 센서가 해당 전압 레벨에 도달하면 펜이 제자리에 장착된 것으로 판단합니다.

features/grip_hook/…​

자동 그립 후크 동작 — 그립이 수직 상태를 유지할 때 커서를 고정합니다.

키유형제약설명
features/grip_hook/enabledbool—손잡이를 수직으로 세운 상태에서는 그립 후크의 자동 잠금 기능이 활성화됩니다.
features/grip_hook/use_hallbool—그립 감지 방식이 자세 대신 홀 센서의 임계값을 사용하도록 변경되었습니다.
features/grip_hook/hallint범위 1–32그립 잠금을 작동시키는 홀 센서 값의 임계값.
features/grip_hook/hold_durationint범위 10–1000트리거된 후 잠금 상태가 유지되는 시간(밀리초).

features/navigation/bubble/…​

Bubble 내비게이션 모듈의 기본값은 처음 활성화될 때 bubble 실행 시 세션에 전달됩니다.

키유형제약설명
features/navigation/bubble/centervec3—버블의 중심에 대한 기본 위치.
features/navigation/bubble/max_velocityfloat—속도 구역 내의 최대 항법 속도(m/s).
features/navigation/bubble/velocity_zone_widthfloat—버블 표면 바깥쪽 속도 영역의 폭(m).
features/navigation/bubble/reset_velocity_on_entrybool—커서가 Bubble에 진입하면 속도를 0으로 재설정합니다.
features/navigation/bubble/spring_innerfloat—Bubble 중심부의 스프링 계수(N/m).
features/navigation/bubble/spring_surfacefloat—Bubble 표면의 탄성 계수(N/m).
features/navigation/bubble/spring_outerfloat—외부 경계에서의 스프링 계수(N/m).
features/navigation/bubble/damping_innerfloat—버블 중심부의 감쇠 계수(Ns/m).
features/navigation/bubble/damping_surfacefloat—Bubble 표면의 감쇠 계수 (Ns/m).
features/navigation/bubble/damping_outerfloat—외부 경계에서의 감쇠 계수(Ns/m).
features/navigation/bubble/wall_stiffnessfloat—외부 경계면의 경질 벽의 강성(N/m).
features/navigation/bubble/bump_widthfloat—Bubble 표면의 촉각 돌기 너비 (m).
features/navigation/bubble/bump_stiffnessfloat—Bubble 표면의 촉각 돌기 강성(N/m).

features/safe_trajectory/…​

말단 구동 장치의 운동 속도 제한기.

키유형제약설명
features/safe_trajectory/enabledbool—안전 주행 속도 제한 장치를 활성화하십시오.
features/safe_trajectory/max_velfloat범위 0.01–2.0허용되는 최대 엔드 액추에이터 속도(m/s).

features/screensaver/…​

장치가 연결되지 않았을 때, ‘ Inverse3 ’ 장치에서 재생되는 유휴 애니메이션입니다.

키유형제약설명
features/screensaver/enabledbool—Inverse3 기기에서 유휴 화면 보호기 애니메이션을 활성화합니다.
features/screensaver/speedfloat범위 0.001–0.2화면 보호기 애니메이션 속도.
features/screensaver/distracted_speedfloat범위 0.001–0.2사용자가 가까이 다가왔으나 직접 조작하지 않았을 때의 애니메이션 속도.

features/sdf/…​

기호 거리 필드(SDF) 촉각 효과 모듈(SDF HFX).

키유형제약설명
features/sdf/enabledbool—SDF 햅틱 효과 모듈을 활성화하거나 비활성화합니다.
features/sdf/state_outputbool—기본적으로 장치 출력 부하에 SDF 상태가 포함됩니다.
features/sdf/max_countint범위 0–128동시에 활성화할 수 있는 SDF 효과의 최대 개수 (0 (표시 제한 없음).
features/sdf/events/createdbool—새로운 SDF 효과를 생성할 때 이벤트가 발생합니다.
features/sdf/events/deletedbool—SDF 효과를 삭제할 때 발생하는 이벤트입니다.
features/sdf/events/updatedbool—SDF 효과를 업데이트할 때 이벤트가 트리거됩니다.
features/sdf/probe_on_zero_force/enabledbool—가해지는 힘이 0에 가까워지면 SDF 장을 자동으로 감지합니다.
features/sdf/probe_on_zero_force/delayfloat범위 0.001–60.0힘이 0으로 떨어진 후, 자동 감지가 시작되기 전까지의 지연 시간(초).

features/verse_grip_pairing/…​

Inverse3 (유선 또는 무선) Verse Grip과의 연결/해제 상태를 추적합니다. Haply 허브의 페어링 인터페이스를 지원합니다.

키유형제약설명
features/verse_grip_pairing/enabledbool—페어링 활성화 / 연결-추적 해제.
features/verse_grip_pairing/hall_threshold_vgint범위 1–32홀 레벨이 이 값에 도달하면 유선 VerseGrip이 연결된 것으로 간주됩니다.
features/verse_grip_pairing/hall_threshold_wvgint범위 1–32홀 레벨이 이 값에 도달하면 무선 VerseGrip이 연결된 것으로 간주됩니다.
features/verse_grip_pairing/detach_debounce_msint범위 0–1000이전 데드밴드 기간(밀리초)을 확인합니다.
features/verse_grip_pairing/heartbeat_msint범위 100–10000강제 재알림 간격(밀리초).
features/verse_grip_pairing/force_attachedbool—연결 상태를 영구적으로 다음으로 강제 설정합니다. true, 홀 센서를 우회함 (하드웨어 고장에 대비한 임시 해결책).

serialization/…​

출력 형식 설정 변경 — WebSocket 및 HTTP JSON 페이로드에 영향을 미칩니다.

키유형제약설명
serialization/explicit_fieldsbool—직렬화 출력에는 기본값과 동일한 변환 필드(예: position: {0,0,0}、rotation: {w:1,…}). 클라이언트가 각 필드가 반드시 명시적으로 존재해야 한다고 요구할 때 유용합니다. 기본값:false。
serialization/force_complete_transformsbool—각 변환 결과에는 항상 다음을 포함해야 합니다. position、rotation 와 scale, 방향 정보만 제공하는 장치(Verse Grip, Wireless Verse Grip)를 포함하여——그렇지 않으면 이러한 장치는 오직 rotation. 이 설정은 다음을 포함합니다. serialization/explicit_fields 기능. 기본값:false。

session/…​

세션 스케줄러와 명령 파이프라인의 제한 사항.

키유형제약설명
session/min_simulation_rate_hzint범위 20–500장비 시뮬레이션 속도(Hz)의 최소 허용값으로, 이 값보다 낮을 경우 경고가 발생합니다.
session/commands/zoh_window_msint—0차 유지 창 — 이 창 내에서 수신된 탐지를 억제합니다(밀리초).
session/commands/drop_warning_thresholdint—창 내에서 버려진 명령의 수가 이 값에 도달하면 경고가 발생합니다.
session/commands/drop_warning_window_msint—버려진 명령을 집계하는 데 사용되는 슬라이딩 윈도우 크기(밀리초).
session/commands/tick_on_empty_batchbool—WebSocket 배치 전체가 버려지더라도 한 번은 스케줄링됩니다. main_loop 틱。