アクション
アクション は、キー・ゲームパッド・MIDI 機器のボタンに Studio 側の操作を割り当てて、ワンタッチで実行する仕組みです。 リモートアプリの 「アクション」 ページで、アクションの登録・割り当て・実行を行います。
アクションセットとアクション
アクションは アクションセット という単位でまとめて管理します。
| 用語 | 役割 |
|---|---|
| アクションセット | 1 つの入力割り当て（キー / ボタン）と、それに紐づく複数の アクション をまとめた単位。1 つのボタンを押すと、セット内のアクションがまとめて実行されます。 |
| アクション | 個々の操作。「関数を呼び出す」または「プロパティを変更する」のいずれかです。1 つのアクションセットに複数のアクションを入れられます。 |
アクションセット（入力 = 例: ゲームパッドの A ボタン）
├─ アクション ライトをオン/オフ
├─ アクション カメラを切り替え
└─ アクション 表情を変更
表示の切り替え
ページ右上のトグルで、リスト表示 と カード表示 を切り替えられます。
| 表示 | 用途 |
|---|---|
| リスト表示 | アクションセットの追加・削除・有効/無効の切り替え・入力割り当て・詳細編集など、管理を行います。 |
| カード表示 | 有効なアクションセットだけがカードで並び、タップで実行します。本番中の操作パネルとして使います。 |
アクションセットを管理する（リスト表示）
追加・削除
- ページ右上の 「アクションセットを追加」（＋）で空のアクションセットを作成します。
- 一覧でセットを選び、「アクションセットを削除」（−）で削除します。
有効化・無効化
各アクションセットは 有効化 / 無効化 を切り替えられます。カード表示には有効なセットだけが並ぶため、本番で使うセットだけを有効にしておきます。
入力を割り当てる
各アクションセットに、実行のトリガーとなる入力（キー / ボタン）を割り当てます。「入力を割り当て」 を押すと割り当て待ちになり、Studio 側のマシンでキーまたはゲームパッド・MIDI 機器のボタンを押す と、そのボタンが登録されます。
キーボードには対応していません。
アクションを追加・編集する
一覧でアクションセットを選ぶと、右側の詳細でそのセットに含まれるアクションを編集できます。アクション一覧の 「＋」 から追加するアクションの種類（関数の呼び出し / プロパティの変更）を選び、対象や値を設定します。
アクションのモード
プロパティを変更するアクションには、ボタンの挙動を決める モード があります。
| モード | 挙動 |
|---|---|
| トグル | 押すたびに ON / OFF が切り替わります。 |
| ホールド | 押している間だけ ON になり、離すと OFF に戻ります。 |
| バリュー | 数値（float）プロパティを連続値で駆動します。 |
関数を呼び出すアクションはモードを持たず、押すたびに実行されます（ボタン固定）。
グループ（排他切り替え）
アクションセットには グループ を設定できます。同じグループに属するトグルのアクションセットは排他になり、1 つを ON にすると同じグループの他のセットが自動的に OFF になります（ラジオボタンのような動作）。 たとえば複数の表情やカメラアングルを 1 つだけ選びたいときに使います。
コントロールから「アクション化」する
アクションは「アクション」ページで一から作るほかに、アプリ各所のコントロール（ボタンやトグル）から直接作ることもできます。
まず、割り当てモードを ON にする必要があります。
割り当てモードを ON にすると対応するコントロールの横に 「アクション化」（⚡）ボタンが表示されます。
これを押すと確認ダイアログが開き、
- アクション名 を確認・変更し、
- （ON/OFF 系のコントロールなら）モード（トグル / ホールド）を選び、
- 任意で 入力（キー）を割り当て（後から割り当ててもかまいません）、
「決定」 を押すと、そのコントロールを操作するアクションセットが 1 つ作成されます。「キャンセル」 では何も作成されません。すでにアクション化済みのコントロールは「追加済み」と表示されます。
表情をボタンに割り当てる具体的な手順は 表情のキーバインド を参照してください。表情カードの割り当ても、この「アクション化」と同じ仕組みで動作します。