설정 안내
이 문서는 다음에서 반환되는 모든 설정을 나열합니다. /settings/ 그들의 키, 유형 (출처: type_hint), 그리고 제약 조건 (출처: metadata.constraint.range + locked (해당되는 경우).
A locked 설정은 실행 시 읽기 전용. 설정 파일을 통해 또는 다음을 통해 변경할 수 있습니다. Haply Hub 설정 페이지, 하지만 시스템을 완전히 재시작해야 합니다 변경 사항이 적용되려면. 이 항목들은 표시되어 있습니다 부팅 아래 표에서.
구성
서비스 시작 시 설정을 재정의하는 구성 파일은 다음 위치에 있습니다:
| 플랫폼 | 위치 |
|---|---|
| Windows | C:\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→stringBOOL→boolINT→intFLOAT→floatARR_STRING→string[]VEC3→vec3(객체와{x, y, z})GENERIC→json(임의의 구조화된 값)
communication/…
HTTP, WebSocket 및 이벤트 스트림 서버의 네트워크 포트와 바인드 주소입니다. 대부분의 항목은 부팅 시에만 사용됩니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
communication/serial/enabled | bool | — | 직렬 장치 통신을 활성화하거나 비활성화합니다. |
communication/bind_address | string | 부팅 | HTTP 및 WebSocket 서버가 바인딩되는 IP 주소. |
communication/bind_all_interfaces | bool | 부팅 | 서버를 다음 위치에 바인딩합니다 0.0.0.0 localhost 대신에. |
communication/http/port | int | 부팅 | HTTP REST API 포트 (기본값) 10000). |
communication/websocket/port | int | 부팅 | Main v3.1 WebSocket 포트 (기본값) 10001). |
communication/websocket/legacy_port | int | 부팅 | Legacy v3.0 WebSocket 포트 (기본값) 10000). |
communication/events/port | int | 부팅 | 이벤트 스트림 WebSocket 포트 (기본값) 10020). |
devices/…
devices/detection/…
직렬 포트 스캔 정책. 모든 항목은 고급 설정입니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
devices/detection/scan_period_ms | int | 범위 100–10000; 부팅 | 직렬 포트 스캔 간격 (ms). |
devices/detection/handshake_timeout_s | int | 범위 1–15 | 포트별 악수 시간 제한 (초). |
devices/detection/max_retries | int | 범위 1–10 | 포트당 최대 핸드셰이크 재시도 횟수. |
devices/detection/failure_log_delay_s | int | 범위 1–60 | 탐지 실패 후 재로그인까지의 대기 시간(초). |
devices/detection/block_looping_ports | bool | — | 루핑 포트가 감지되면 블록 장치의 준비 상태를 확인합니다. |
devices/detection/excluded_ports | json | — | 탐지 과정에서 건너뛸 직렬 포트 경로. |
devices/detection/additional_ports | string[] | — | 무조건 스캔할 추가 직렬 포트 경로. |
devices/detection/allowed_vendor_id_filter | string[] | — | 포트 열거 중에 허용되는 USB 공급업체 ID. |
devices/detection/port_name_substring_filter | string[] | — | 일치시킬 플랫폼별 포트 이름의 부분 문자열. |
devices/detection/wireless_verse_grip_description_filter | string[] | — | 무선 VerseGrip 감지를 위한 포트 설명의 부분 문자열. |
devices/detection/inverse3x_description_filter | string[] | — | Inverse3x 감지를 위한 포트 설명의 부분 문자열. |
devices/detection/extra_ports (사용 중단됨) | string[] | — | 사용 devices/detection/additional_ports 대신. 읽기 및 쓰기 작업은 표준 키로 투명하게 전달됩니다. |
devices/inverse*/…
모든 Inverse3 계열 장치에 적용되는 전역 기본값입니다. 세션별 설정 변경 사항이 우선 적용됩니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
devices/inverse*/filters/force_scale/gain | float | 범위 0.0–2.0 | 모든 기기에 적용되는 글로벌 출력 배율. |
devices/inverse*/filters/force_gate/gain | float | 범위 0.0–1.0 | 새 세션의 기본 강제 게이트 이득. |
devices/inverse*/control_timeout_ms | int | 범위 50–10,000 | 장치 제어 잠금 해제까지의 대기 시간(ms). |
devices/inverse*/query_orientation_on_idle | bool | — | 장치가 유휴 상태일 때 펌웨어에서 본체 방향을 조회합니다. |
devices/presets
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
devices/presets | json | — | 장치 유형별 기본 장치 구성 사전 설정 (마운트 변환, 기준 등) 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_threshold | int | — | 배터리 잔량이 이 수치 이하로 떨어지면 배터리 부족 경고가 표시됩니다. |
devices/wireless_verse_grip/battery/critical_threshold | int | — | 임계 배터리 경고가 발령되는 배터리 잔량 기준치. |
devices/wireless_verse_grip/battery/reset_margin | int | — | 배터리 경고가 해제되기 전의 히스테리시스 여유량. |
devices/wireless_verse_grip/filters/orientation_filter | json | 부팅 | 무선 VerseGrip 방향용 One Euro Filter 구성. |
features/…
features/calibration/…
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/calibration/hall_threshold | int | 범위 1–32 | 보정 시 펜이 부착된 것으로 간주되는 홀 센서 레벨. |
features/grip_hook/…
자동 그리프-훅 동작 — 그리프를 수직으로 잡고 있는 동안 커서가 고정됩니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/grip_hook/enabled | bool | — | 그립을 수직으로 잡았을 때 그립 후크 자동 잠금 기능을 활성화합니다. |
features/grip_hook/use_hall | bool | — | 그립 감지 시 방향 대신 홀 센서 임계값을 사용하십시오. |
features/grip_hook/hall | int | 범위 1–32 | 그립 잠금을 작동시키는 홀 센서 값의 임계값. |
features/grip_hook/hold_duration | int | 범위 10–1000 | 트리거 발생 후 잠금을 유지하는 시간(ms). |
features/navigation/bubble/…
버블 내비게이션 모듈의 기본값 — 다음 조건이 충족될 때 세션으로 전달됩니다. bubble 행동이 먼저 활성화됩니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/navigation/bubble/center | vec3 | — | 버블의 기본 중심 위치. |
features/navigation/bubble/max_velocity | float | — | 속도 구역 내 최대 항해 속도 (m/s). |
features/navigation/bubble/velocity_zone_width | float | — | 기포 표면 바깥쪽 속도 영역의 폭 (m). |
features/navigation/bubble/reset_velocity_on_entry | bool | — | 커서가 버블에 들어갈 때 속도를 0으로 초기화합니다. |
features/navigation/bubble/spring_inner | float | — | 기포 중심부의 탄성 계수 (N/m). |
features/navigation/bubble/spring_surface | float | — | 기포 표면의 탄성 계수 (N/m). |
features/navigation/bubble/spring_outer | float | — | 외부 경계에서의 탄성 계수 (N/m). |
features/navigation/bubble/damping_inner | float | — | 기포 중심에서의 감쇠 계수 (Ns/m). |
features/navigation/bubble/damping_surface | float | — | 기포 표면의 감쇠 계수 (Ns/m). |
features/navigation/bubble/damping_outer | float | — | 외부 경계에서의 감쇠 계수 (Ns/m). |
features/navigation/bubble/wall_stiffness | float | — | 외부 경계의 단단한 벽의 강성(N/m). |
features/navigation/bubble/bump_width | float | — | 기포 표면의 촉감 돌기 너비 (m). |
features/navigation/bubble/bump_stiffness | float | — | 기포 표면의 촉감 돌기의 강성(N/m). |
features/safe_trajectory/…
엔드 이펙터 동작을 위한 속도 제한기.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/safe_trajectory/enabled | bool | — | 안전 궤도 속도 제한 기능을 활성화하십시오. |
features/safe_trajectory/max_vel | float | 범위 0.01–2.0 | 허용되는 엔드 이펙터 최대 속도 (m/s). |
features/screensaver/…
Inverse3 세션이 실행 중이지 않을 때 재생되는 대기 애니메이션.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/screensaver/enabled | bool | — | Inverse3 대기 화면 애니메이션 기능을 활성화합니다. |
features/screensaver/speed | float | 범위 0.001–0.2 | 스크린세이버 애니메이션 속도. |
features/screensaver/distracted_speed | float | 범위 0.001–0.2 | 사용자가 가까이 있지만 상호작용을 하지 않을 때의 애니메이션 속도. |
features/sdf/…
서명 거리 필드 햅틱 효과 모듈(SDF HFX).
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/sdf/enabled | bool | — | SDF 햅틱 효과 모듈을 활성화하거나 비활성화합니다. |
features/sdf/state_output | bool | — | 기본적으로 장치 출력 페이로드에 SDF 상태를 포함합니다. |
features/sdf/max_count | int | 범위 0–128 | 활성화된 SDF 효과의 최대 개수 (0 = 무제한). |
features/sdf/events/created | bool | — | 새로운 SDF 이펙트가 생성될 때 이벤트를 발생시킵니다. |
features/sdf/events/deleted | bool | — | SDF 이펙트가 삭제될 때 이벤트를 발생시킵니다. |
features/sdf/events/updated | bool | — | SDF 효과가 업데이트될 때 이벤트를 발생시킵니다. |
features/sdf/probe_on_zero_force/enabled | bool | — | 가해지는 힘이 0에 가까울 때 SDF 필드를 자동 탐색합니다. |
features/sdf/probe_on_zero_force/delay | float | 범위 0.001–60.0 | 압력이 0으로 떨어진 후 자동 프로빙이 시작되기까지의 지연 시간(초). |
features/verse_grip_pairing/…
Inverse3 (유선 또는 무선) Verse Grip 간의 추적 기능을 연결하거나 해제합니다. Haply 페어링 UI를 구동합니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
features/verse_grip_pairing/enabled | bool | — | 페어링 / 연결 및 분리 추적 기능을 활성화합니다. |
features/verse_grip_pairing/hall_threshold_vg | int | 범위 1–32 | 유선 VerseGrip이 연결된 것으로 간주되는 홀 레벨. |
features/verse_grip_pairing/hall_threshold_wvg | int | 범위 1–32 | 무선 VerseGrip이 장착된 것으로 간주되는 홀 레벨. |
features/verse_grip_pairing/detach_debounce_ms | int | 범위 0–1000 | 분리 작업을 실행하기 전의 디바운스 대기 시간(ms). |
features/verse_grip_pairing/heartbeat_ms | int | 범위 100–10,000 | 강제 재알림 간격 (ms). |
features/verse_grip_pairing/force_attached | bool | — | 첨부된 상태를 영구적으로 true, 홀 센서를 우회하여 (하드웨어 고장 시 임시 해결책). |
serialization/…
변환 출력 형식 — WebSocket 및 HTTP JSON 페이로드에 적용됩니다.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
serialization/explicit_fields | bool | — | 시리얼화된 출력에 기본값과 동일한 변환 필드를 포함합니다(예: position: {0,0,0}, rotation: {w:1,…}). 클라이언트가 모든 필드가 명시적으로 포함되기를 요구할 때 유용합니다. 기본값: false. |
serialization/force_complete_transforms | bool | — | 항상 출력 position, rotation, 그리고 scale 모든 트랜스폼 출력에서, 방향 정보만 제공하는 장치(Verse Grip, Wireless Verse Grip)를 포함하여(이 장치들은 그렇지 않으면 오직 rotation. 포함한다 serialization/explicit_fields. 기본값: false. |
session/…
세션 스케줄러 및 명령어 파이프라인 제한 사항.
| 키 | 유형 | 제약 조건 | 설명 |
|---|---|---|---|
session/min_simulation_rate_hz | int | 범위 20–500 | 경고가 발생하기 전까지 허용되는 최소 장치 시뮬레이션 주파수(Hz). |
session/commands/zoh_window_ms | int | — | 0차 홀드 창 — 이 창(ms) 내에 수신된 프로브를 억제합니다. |
session/commands/drop_warning_threshold | int | — | 경고가 표시되기 전까지의 기간 내에 취소된 명령어의 수. |
session/commands/drop_warning_window_ms | int | — | 누락된 명령어를 계산하기 위한 슬라이딩 윈도우 크기(ms). |
session/commands/tick_on_empty_batch | bool | — | 예약하기 main_loop 웹소켓 배치 전체가 손실된 경우에도 틱이 발생합니다. |