设置参考
本文档列出了由 /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 |
| Linux | /etc/haply-inverse-service/haply-inverse-service-config.json |
该配置文件是一个 扁平化 JSON 对象 将设置键映射以覆盖值。这些键必须是
/settings/ 超文本传输协定 路由。
未指定的键将使用服务的默认值。
例如，以下是一个随机的网络配置覆盖示例：
{
"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–20000 |
features/synth/oscillator1/shape | json | 范围 0–1 |
features/synth/oscillator2/amplitude | float | 范围 0–10 |
features/synth/oscillator2/frequency | float | 范围 5–20000 |
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 | — |