本文へスキップ

設定を参照

この文書は /settings/ エンドポイントが返すすべての設定を キー, タイプ(type_hint (基準)、 制約条件(metadata.constraint.range および該当する場合 locked (基準)とともに列挙します。

locked 設定は 実行時に読み取り専用です。設定ファイルや Haply 設定ページから変更することはできますが、変更が反映されるには サービス全体を再起動する必要があります. 以下の表では、これらの設定は ブートと表示されます。

構成​

サービス起動時に設定を上書きする構成ファイルの場所は以下の通りです:

プラットフォーム場所
WindowsC:\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/ 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起動時localhost の代わりに 0.0.0.0サーバーにバインドします。
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;起動時シリアルポートのスキャン間隔(ms)です。
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デバイス制御のロックを解除するまでの制限時間(ms)です。
devices/inverse*/query_orientation_on_idlebool—デバイスがアイドル状態のとき、ファームウェアが本体の向きを確認します。

devices/presets​

キータイプ制約条件説明
devices/presetsjson—デバイス種別ごとのデフォルトのデバイス構成プリセットです(inverse_arm_front_*, inverse_led_front_*, minverse_*, verse_grip_default, wireless_verse_grip_default, custom_verse_grip_default(マウント変換(mount transform)、基底など)。

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 Filterの設定です。

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トリガー発動後にロックを維持する時間(ms)です。

features/navigation/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—カーソルがバブルに入ると、速度を0にリセットします。
features/navigation/bubble/spring_innerfloat—バブルの中心におけるばね定数(N/m)です。
features/navigation/bubble/spring_surfacefloat—バブル表面におけるばね定数(N/m)です。
features/navigation/bubble/spring_outerfloat—外周境界におけるばね定数(N/m)です。
features/navigation/bubble/damping_innerfloat—バブルの中心における減衰係数(Ns/m)です。
features/navigation/bubble/damping_surfacefloat—気泡表面における減衰係数(Ns/m)です。
features/navigation/bubble/damping_outerfloat—外側の境界における減衰係数(Ns/m)です。
features/navigation/bubble/wall_stiffnessfloat—外周にある堅固な壁の剛性(N/m)です。
features/navigation/bubble/bump_widthfloat—バブル表面の触覚バンプの幅(m)です。
features/navigation/bubble/bump_stiffnessfloat—バブル表面の触覚バンプの剛性(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/…​

これは、符号付き距離場(Signed-distance-field)ハプティック効果モジュール(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 ハブのペアリングUIの基盤となります。

キータイプ制約条件説明
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デバウンス区間(ms)は、分離が確定する前の期間です。
features/verse_grip_pairing/heartbeat_msint範囲 100~10000強制再通知の間隔(ms)です。
features/verse_grip_pairing/force_attachedbool—ホールセンサーをバイパスして、取り付け状態を trueで恒久的に固定します(ハードウェア障害を回避するため)。

serialization/…​

出力形式の変換 — WebSocket および HTTP の JSON ペイロードに影響します。

キータイプ制約条件説明
serialization/explicit_fieldsbool—シリアル化された出力における、恒等デフォルト値のような transform フィールド(例: position: {0,0,0}, rotation: {w:1,…})も含まれます。クライアント側ですべてのフィールドが明示的に存在しなければならない場合に便利です。デフォルト値: false.
serialization/force_complete_transformsbool—方向のみを出力するデバイス(Verse Grip、Wireless Verse Grip)を含め、すべてのトランスフォーム出力において position, rotation, そして scaleを常に含みます。これらのデバイスは、そうでなければ rotationのみを出力します。 serialization/explicit_fieldsの動作が含まれます。デフォルト値: false.

session/…​

セッションスケジューラおよびコマンドパイプラインの制限です。

キータイプ制約条件説明
session/min_simulation_rate_hzint範囲 20~500警告が発生するまでの、許容される最小デバイスシミュレーション周期(Hz)です。
session/commands/zoh_window_msint—ゼロ次ホールドウィンドウ — この区間内に受信されたプローブを抑制します(ms)。
session/commands/drop_warning_thresholdint—警告が発生する前に、Windows内で実行されたコマンドの数です。
session/commands/drop_warning_window_msint—ドロップされたコマンドを集計するためのスライディングウィンドウのサイズ(ms)です。
session/commands/tick_on_empty_batchbool—WebSocketのバッチ全体が破棄された場合でも main_loop ティックをスケジュールします。