버전: 3.5.x

설정 안내

이 문서는 다음에서 반환되는 모든 설정을 나열합니다. /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 경로. 명시되지 않은 키는 서비스 기본값을 사용합니다.

예를 들어, 다음은 임의의 네트워킹 구성 재정의 예시입니다:

{
  "networking/http/port": 8400,
  "networking/simulation/port": 8500,
  "networking/events/port": 9000,
  "networking/expose_servers_on_network": true
}

유형 매핑

형식 힌트 설명:

ARR_STRING → string[]
VEC3 → vec3 (객체와 {x,y,z})
GENERIC → json (임의의 구조화된 값)

할 일: 완료 + 설명 추가

`devices/…`

키	유형	제약 조건
`devices/detection/advanced/allowed_vendor_id_filter`	`string[]`	—
`devices/detection/advanced/inverse3x_description_filter`	`string[]`	—
`devices/detection/advanced/port_name_substring_filter`	`string[]`	—
`devices/detection/advanced/wvg_description_filter`	`string[]`	—
`devices/detection/blacklisted_ports`	`json`	—
`devices/detection/block_on_loop`	`bool`	—
`devices/detection/detection_failure_log_delay`	`int`	범위 1–60
`devices/detection/max_number_retry`	`int`	범위 1–10
`devices/detection/period`	`int`	범위 100–10000; 잠금
`devices/detection/timeout`	`int`	범위 1–15
`devices/force_scale`	`float`	범위 0–2
`devices/inverse/body_orientation_query_on_idle`	`bool`	—
`devices/verse_grip/advanced/euro_one_filter`	`json`	잠김
`devices/verse_grip/battery/critical_threshold`	`int`	—
`devices/verse_grip/battery/low_threshold`	`int`	—
`devices/verse_grip/battery/reset_margin`	`int`	—
`devices/workspace/defaults`	`json`	—

`features/…`

키	유형	제약 조건
`features/HFX/sdf`	`bool`	—
`features/HFX/sdf/created_events`	`bool`	—
`features/HFX/sdf/delete_events`	`bool`	—
`features/HFX/sdf/probe_on_zero_force`	`bool`	—
`features/HFX/sdf/probe_on_zero_force_delay`	`float`	범위 0.001–60
`features/HFX/sdf/update_events`	`bool`	—
`features/grip_hook/enabled`	`bool`	—
`features/grip_hook/hall`	`int`	범위 1–32
`features/grip_hook/hold_duration`	`int`	범위 10–1000
`features/grip_hook/use_hall`	`bool`	—
`features/navigation/bubble/avatar_boundaries_max`	`vec3`	—
`features/navigation/bubble/avatar_boundaries_min`	`vec3`	—
`features/navigation/bubble/bubble_center`	`vec3`	—
`features/navigation/bubble/damping_coef_at_center`	`float`	—
`features/navigation/bubble/damping_coef_at_inner_radius`	`float`	—
`features/navigation/bubble/damping_coef_at_outer_radius`	`float`	—
`features/navigation/bubble/reset_velocity_on_entry`	`bool`	—
`features/navigation/bubble/spring_coef_at_center`	`float`	—
`features/navigation/bubble/spring_coef_at_inner_radius`	`float`	—
`features/navigation/bubble/spring_coef_at_outer_radius`	`float`	—
`features/navigation/bubble/velocity_zone_bump_region_width`	`float`	—
`features/navigation/bubble/velocity_zone_bump_stiffness`	`float`	—
`features/navigation/bubble/velocity_zone_inner_radius`	`float`	—
`features/navigation/bubble/velocity_zone_max_velocity`	`float`	—
`features/navigation/bubble/velocity_zone_outer_radius`	`float`	—
`features/navigation/bubble/wall_spring_stiffness`	`float`	—
`features/safe_trajectory/enabled`	`bool`	—
`features/safe_trajectory/max_vel`	`float`	범위 0.01–2
`features/screensaver/distracted_speed`	`float`	범위 0.001–0.2
`features/screensaver/enabled`	`bool`	—
`features/screensaver/speed`	`float`	범위 0.001–0.2
`features/synth/enabled`	`bool`	—
`features/synth/oscillator1/amplitude`	`float`	범위 0–10
`features/synth/oscillator1/frequency`	`float`	범위 5–20,000
`features/synth/oscillator1/shape`	`json`	범위 0–1
`features/synth/oscillator2/amplitude`	`float`	범위 0–10
`features/synth/oscillator2/frequency`	`float`	범위 5–20,000
`features/synth/oscillator2/shape`	`json`	범위 0–1

`networking/…`

키	유형	제약 조건
`networking/events/port`	`int`	잠김
`networking/expose_servers_on_network`	`bool`	잠김
`networking/http/port`	`int`	잠김
`networking/legacy/port`	`int`	잠김
`networking/simulation/port`	`int`	잠김

`session/…`

키	유형	제약 조건
`session/safeties/device_drive_timeout`	`int`	범위 50–10000, 단위 10
`session/safeties/slowest_sim_rate`	`int`	범위 20–500

`system/…`

키	유형	제약 조건
`system/serial_enable`	`bool`	—

구성​

유형 매핑​

devices/…​

features/…​

networking/…​

session/…​

system/…​

구성