Version: 3.5.x

Übersicht über die Einstellungen

Dieses Dokument listet alle Einstellungen auf, die von der /settings/ Endpunkt mit ihrem Schlüssel, Typ (aus type_hint) und **Einschränkungen ** (aus metadata.constraint.range + locked (sofern zutreffend).

A locked Die Einstellung ist nur-Lese-Zugriff zur Laufzeit. Dies kann über die Konfigurationsdatei oder über die Haply Hub Einstellungsseite, aber Es ist ein vollständiger Neustart des Dienstes erforderlich damit die Änderungen wirksam werden.

Konfiguration

Die Konfigurationsdatei, mit der die Einstellungen beim Start des Dienstes überschrieben werden können, befindet sich hier:

Plattform	Standort
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`

Die Konfigurationsdatei ist eine einfaches JSON-Objekt Zuordnung von Einstellungsschlüsseln zum Überschreiben von Werten. Die Schlüssel müssen gültige Einstellungsschlüssel sein, die von der /settings/ HTTP Route. Für alle nicht angegebenen Schlüssel wird die Standardeinstellung des Dienstes verwendet.

Hier ist zum Beispiel eine zufällige Überschreibung der Netzwerkkonfiguration:

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

Typzuordnung

Erläuterungen zu Typ-Hinweisen:

ARR_STRING → string[]
VEC3 → vec3 (Objekt mit {x,y,z})
GENERIC → json (beliebig strukturierter Wert)

Zu erledigen: Fertigstellen + Beschreibungen

`devices/…`

Schlüssel	Typ	Zwänge
`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`	Bereich 1–60
`devices/detection/max_number_retry`	`int`	Bereich 1–10
`devices/detection/period`	`int`	Bereich 100–10000; gesperrt
`devices/detection/timeout`	`int`	Bereich 1–15
`devices/force_scale`	`float`	Bereich 0–2
`devices/inverse/body_orientation_query_on_idle`	`bool`	—
`devices/verse_grip/advanced/euro_one_filter`	`json`	gesperrt
`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/…`

Schlüssel	Typ	Zwänge
`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`	Bereich 0,001–60
`features/HFX/sdf/update_events`	`bool`	—
`features/grip_hook/enabled`	`bool`	—
`features/grip_hook/hall`	`int`	Bereich 1–32
`features/grip_hook/hold_duration`	`int`	Bereich 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`	Bereich 0,01–2
`features/screensaver/distracted_speed`	`float`	Bereich 0,001–0,2
`features/screensaver/enabled`	`bool`	—
`features/screensaver/speed`	`float`	Bereich 0,001–0,2
`features/synth/enabled`	`bool`	—
`features/synth/oscillator1/amplitude`	`float`	Bereich 0–10
`features/synth/oscillator1/frequency`	`float`	Bereich 5–20.000
`features/synth/oscillator1/shape`	`json`	Bereich 0–1
`features/synth/oscillator2/amplitude`	`float`	Bereich 0–10
`features/synth/oscillator2/frequency`	`float`	Bereich 5–20.000
`features/synth/oscillator2/shape`	`json`	Bereich 0–1

`networking/…`

Schlüssel	Typ	Zwänge
`networking/events/port`	`int`	gesperrt
`networking/expose_servers_on_network`	`bool`	gesperrt
`networking/http/port`	`int`	gesperrt
`networking/legacy/port`	`int`	gesperrt
`networking/simulation/port`	`int`	gesperrt

`session/…`

Schlüssel	Typ	Zwänge
`session/safeties/device_drive_timeout`	`int`	Bereich 50–10000, Schrittweite 10
`session/safeties/slowest_sim_rate`	`int`	Bereich 20–500

`system/…`

Schlüssel	Typ	Zwänge
`system/serial_enable`	`bool`	—

Konfiguration​

Typzuordnung​

devices/…​

features/…​

networking/…​

session/…​

system/…​