TriggerとResponse
Triggerは利用者の操作やシーン内の状態変化を検知し、Responseに登録した動作を開始します。 ElementsからTriggerとResponseを追加して設定します。
基本構成
設定は次の順序で行います。
- Elementsから「Response」を追加します。
- Responseへ実行するActionを追加し、対象Elementと値を設定します。
- 利用場面に合うTriggerを追加します。
- Triggerのプロパティで作成したResponseを選択します。
- Previewまたは公開先のルームで動作を確認します。
1つのResponseには複数のActionを登録できます。 待機を挟む場合は「Sleep」をActionの間へ追加します。
Triggerの種類
| Element | 発火条件 | 主な設定 |
|---|---|---|
| Active Trigger | 利用者が対象モデルを操作したときに発火します。 | 対象モデル、Response、同期 |
| Passive Trigger | 利用者がボックス範囲へ入ったとき、または出たときに発火します。 | 入場時Response、退場時Response、同期 |
| 2D Active Trigger | 画面上のボタンを操作したときに発火します。 | ボタン名、Response、同期 |
| JS Event Trigger | プラグインなどが発行するイベントを受け取ったときに発火します。 | イベント名、Response、同期 |
JS Event Triggerは詳細モードでのみ追加できます。 ほかの3つのTriggerとResponseはシンプルモードにも表示されます。
ResponseのAction
| Action | 動作 |
|---|---|
| Animation Model Play | AnimationModelのアニメーションを再生します。 |
| Animation Model Stop | AnimationModelのアニメーションを停止します。 |
| Audio Play | Audioを再生します。 |
| Audio Play Stop | Audioの再生を停止します。 |
| Change Visible | 対象Elementの表示と非表示を切り替えます。 |
| Change Troika Text | Troika Textの文字列を変更します。 |
| Move Room | 別のルームへ移動します。 |
| Sleep | 次のActionまで、指定した秒数だけ待機します。 |
| Warp | Way Pointへワープします。 |
| 2D View | 画像または動画を2D表示します。 |
| Hide 2D View | 表示中の2D Viewを閉じます。 |
| JS Call Event | プラグインへカスタムイベントを送ります。 |
| Play Sound | 指定した効果音を再生します。 |
| Stop Sound | 指定した効果音を停止します。 |
| Stop All Responses | 実行中のResponseを停止します。 |
Actionによって、選択できる対象Elementが異なります。 たとえばWarpはWay Pointを、Change Troika TextはTroika Textを対象にします。
同期
Triggerの同期は初期状態では無効です。
- 無効の場合は、Triggerを発火させた利用者の画面だけでResponseを実行します。
- 有効の場合は、接続中の全利用者が同じResponseを実行します。
- 同期したResponseの最新状態は、ルームが空になるまで保持されます。その間に途中入室した利用者にも復元されます。
同期はシーンへ永続保存されません。 ルームから全員が退出すると保持された状態は消え、次に入室したときはシーンの初期状態から始まります。
Warp、Move Room、2D Viewなども、同期を有効にすると全利用者側で実行されます。 個人だけに表示する画面や移動には同期を使 用しないでください。 表示や演出を全員でそろえる場合は同期を有効にし、複数端末と途中入室の両方で確認してください。
Active Trigger
Active Triggerでは、操作対象のモデルと実行するResponseを指定します。 対象モデルが利用者から操作できる配置になっていることをPreviewで確認してください。
Passive Trigger
Passive Triggerはボックス形状の範囲を持ちます。 Transformで位置と大きさを調整し、入場時と退場時に別のResponseを設定できます。
境界上でActionが繰り返されないように、範囲と利用者の動線を確認してください。
2D Active Trigger
2D Active Triggerは、利用者の画面に表示するボタン名とResponseを設定します。 短く意味の分かるボタン名を使い、実行結果をPreviewで確認してください。
JS Event Trigger
JS Event Triggerは、プラグインなどが発行するイベント名を受け取ってResponseを実行しま す。 設定できるのは、イベント名、実行するResponse、および同期です。
イベントの発行方法と詳細値はJS Call Eventsを参照してください。
リンク先は開発者向けのプラグイン実装ガイドです。
過去に作成したシーンを編集する場合
以前の形式のTriggerは、Spokeで開いても新しい形式へ自動では変わりません。 詳細モードのElementsには、同じ名前の古いTriggerが残っていることがあります。 Capture、Prevent Default、Stop Propagation、Once、Enabledがあるものは以前の形式です。 新しく追加する場合は、同期とResponseを設定する形式を使ってください。 既存シーンでは、対象Element、Response、同期設定が意図どおりかを確認し、Previewでテストしてから公開してください。