Input — アクション入力(コントローラー)

FloatSoda.OVR のアクション入力は、Unity Input System に似た語彙(ActionMap → Action → DefaultBinding)で VRコントローラーのボタン・トリガー・スティックを扱うAPIです。定義はすべてC#コードで完結し、アクションマニフェストJSONは自動生成されます。ユーザーがJSONファイルを書くことはありません。

オーバーレイUI上のポインタ操作(ボタンのクリック等)はウィジェットのヒットテストが担当します。このページのアクション入力は「UIの外」のアプリレベル入力(ショートカット、掴む、スクロール等)用です。

最小の例

using FloatSoda.OVR.Input;

var grab = new InputAction<bool>
{
    Name = "grab",
    SuggestedPath = "/user/hand/right/input/trigger/click",
};

builder.Services.AddFloatSoda(new FloatSodaOptions
{
    AppKey = new AppKey("com.example.myoverlay"),
    InputActionMaps = [new InputActionMap { Name = "main", Actions = [grab] }],
});

grab.OnPerformed += _ => Console.WriteLine("トリガーが引かれた");
grab.OnReleased += () => Console.WriteLine("トリガーが離された");
// 毎フレームの値参照は grab.Value

アクションの型

InputAction<T> の T は次の3つだけです。それ以外の型は初期化時に例外になります。

型	用途	イベント
`bool`	ボタン/クリック	`OnPerformed`(押下エッジ)/ `OnReleased`
`float`	トリガー引き量など1軸	`OnPerformed`(値が変化したフレーム)
`System.Numerics.Vector2`	スティック/トラックパッド	`OnPerformed`(値が変化したフレーム)

Unity Input System との対応

Unity Input System	FloatSoda	OpenVR (IVRInput)
InputActionAsset	`FloatSodaOptions.InputActionMaps`	アクションマニフェストJSON(自動生成)
InputActionMap	`InputActionMap`	アクションセット `/actions/{name}`
InputAction	`InputAction<T>`	アクション `/actions/{map}/in/{name}`
InputBinding	`DefaultBinding` / `SuggestedPath`	デフォルトバインディングJSON(自動生成)
`action.performed`	`OnPerformed`	—
`action.ReadValue<T>()`	`Value`	`GetDigitalActionData` / `GetAnalogActionData`
`map.Enable()` / `Disable()`	`InputActionMap.Enabled`	`UpdateActionState` の対象選択

バインディングの決定権はSteamVRにある

Unityと最も違う点です。DefaultBinding / SuggestedPath は 初期割り当ての「提案」 であり、実際のバインディングはSteamVRが管理し、ユーザーがSteamVRのコントローラーバインディングUIでいつでも変更できます。このため次のAPIは 意図的に存在しません。

実行時にバインディングを追加/変更する(AddBinding / ApplyBindingOverride 相当)
アクションから現在のバインディングを列挙する(action.bindings 相当)
composite binding(複数ボタンの合成)を定義する

デフォルトバインディングの書き方

SuggestedPath — 1本のOpenVR入力パスを全コントローラー種別(Index / Vive Wand / Oculus Touch)へ複製します。まずはこれで十分です。
DefaultBindings — コントローラー種別ごとにパスを変えたいときに使います。指定した種別にだけ出力されます。

パスはOpenVR正規表記です(SteamVRのバインディングUIに表示される表記と一致します)。

/user/hand/right/input/trigger/click   … トリガーをボタンとして(bool)
/user/hand/right/input/trigger/pull    … トリガー引き量(float)
/user/hand/right/input/thumbstick      … スティック(Vector2)
/user/hand/left/input/a/click          … 左手Aボタン(bool)

注意: オーバーレイアプリとアクションセットの競合

FloatSodaアプリはオーバーレイアプリなので、シーンアプリ(VRChat等のゲーム本体)と同時に動きます。同じ物理入力をシーンアプリも使っている場合の優先はSteamVRのアクションセット優先度に従います。ゲームの操作と衝突しにくい入力(使われていないボタン、非利き手側など)をデフォルトに選ぶことを推奨します。

生成物の場所

アクションマニフェスト一式は %TEMP%/FloatSoda/{AppKey}/input/ に毎起動時に生成され、 IVRInput.SetActionManifestPath で登録されます。デバッグ時はこのJSONを直接確認できます。