トリガー一覧

トリガーは「ユーザーの操作・時間経過・ノード退出」を検知して、ストア変数の操作や接続先ノードへの遷移を行うルールです。

アイコン	種別	説明
👆	タップ（tap）	画面タップ・クリックで発火。ボタン UI またはホットスポット UI として表示。位置指定可能。
💬	テキスト（text）	画面上の任意位置にテキストオーバーレイとして表示。接続先を設定するとタップで遷移も可能。
👋	スワイプ（swipe）	上下左右いずれかの方向スワイプ・ドラッグ（28px以上）で発火。
📄	ページ送り（page）	左スワイプ/下スワイプ → 次へ（next）、右スワイプ/上スワイプ → 前へ（prev）。prevは接続先不要（履歴から自動戻り）。
⏱	タイマー（timer）	シーン表示から指定秒数後に自動発火。カウントダウン表示付き。
⏩	再生終了（ended）	メディア（動画・音声）の再生終了を検知して自動発火。
⚡	条件・アクション（exit）	ノードを退出する際に必ず実行されるトリガー。毒ダメージ・状態変化など「常に発生する効果」に使用。

TIP

条件・アクション（exit）は他のトリガーの後に実行されます。例：スワイプで「攻撃+10・体力-1」、条件・アクションで「毒ダメージ-1（必ず）」→ 合計体力-2。

タップ（tap）

フィールド	説明
ラベル	ノードカードおよびデバッグ表示に使用する名前
表示スタイル	🔘 ボタン（枠＋テキスト） / 👆 ホットスポット（波紋丸ドット） / 🚫 非表示（UIなし）
表示テキスト	ボタンに表示するテキスト（省略→ラベルを使用）。矢印プリセットから選択可。
フォントサイズ	デフォルト 16px（最小値も16px）。プロジェクト解像度を基準とした比率で描画。
テキスト色	プリセット + カラーピッカー
エフェクト	タップ時のリップル（波紋）・枠線・グロー演出（デフォルトON）。色・濃度（0〜200%）・大きさ（20〜300%）を個別調整可能。暗い背景で目立たない時は濃度を上げると視認しやすい。
表示座標	📍 指定ボタン後にノードプレビューをクリックして設定（X%, Y%）。未指定の場合 HUD 下部に表示。
表示タイミング	showAt〜hideAt 秒の間のみ表示（動画再生時間に連動）
接続先	遷移先ノードを選択（ドロップダウン または キャンバスでドラッグ接続）
外部リンク	タップ時に別タブで開くURL（任意）。視聴者には毎回、リスク表示と同意確認のダイアログが表示されます。

表示テキストがある場合（ボタン＋テキストモード）

表示スタイルが 🔘 ボタンで表示テキストを設定している場合、テキスト（text） の表示設定と同じ4項目（自動改行・ボックス・文字揃え・背景(板)）を利用できます。

テキスト（text）

動画上にテキストを表示するトリガーです。「💬 テキスト表示」と「⌨️ 入力フォーム」の2つのモードがあります。

💬 テキスト表示モード

フィールド	説明
ラベル	ノードカードに表示する名前。複数行入力に対応し、プレイヤーでも改行されて表示される
表示テキスト	画面上に表示するテキスト（改行可）。省略するとラベルを使用。 でストア変数の値を埋め込める
フォントサイズ	デフォルト 16px（最小値も16px）
テキスト色	プリセット + カラーピッカー
表示座標	動画上の表示位置（X%, Y%）。未設定の場合 HUD に表示
表示タイミング	showAt〜hideAt（動画時間連動）
接続先	未接続でもテキスト表示のみ可能。接続時のみタップで遷移
自動改行	ONで指定幅に応じて自動的に折り返す（デフォルト）。手入力した改行（Enter）は常に反映される
ボックス	テキストボックスの幅（px）。空欄なら実際のテキスト長に自動追従。数値指定で固定幅になり文字揃えが効く
文字揃え	左／中央／右揃え。ボックスが「自動」幅のときは余白が無いため常に中央寄りに見える
背景（板）	文字の下の半透明の背景板の表示ON/OFF（デフォルトON）。OFFでも文字の可読性のためテキストシャドウは残る
条件未達成時のテキスト	条件を満たしていない間だけ表示する代替テキスト（任意）。「条件未達成時は非表示にする」がONの場合は使用されない

⌨️ 入力フォームモード

プレイヤーがテキストを入力できるフォームを表示します。

フィールド	説明
保存先変数	入力内容を保存する text型ストア変数を選択
接続先	入力送信後に遷移するノード
表示座標	動画上の表示位置。未設定の場合 HUD 下段に表示

TIP

入力フォームには text型ストア変数が必要です。ストアパネルから先に「text」型の変数を作成してください。

— 変数埋め込み

テキスト表示に を書くと、実行時にストア変数の現在値に置き換えます。

書き方	表示例
ダメージを受けた	12ダメージを受けた
の冒険	アリスの冒険
スコア：点	スコア：850点

活用例：プレイヤー名入力とリザルト画面

1. ストアに text型変数「プレイヤー名」を追加（初期値: 空欄）
2. オープニングノードにテキストトリガーを追加 → 入力フォームモード
3. 保存先変数: 「プレイヤー名」、接続先: 次のシーンへ
4. ENDノードのテキストトリガー（テキスト表示モード）に 、クリアおめでとう！ と設定
5. プレイヤーが入力した名前がエンディングに表示される

スワイプ（swipe）

フィールド	説明
スワイプ方向	↑ 上 / ↓ 下 / ← 左 / → 右（方位ピッカーで選択）
表示タイミング	showAt〜hideAt（コンパスヒント表示に反映）
接続先	遷移先ノード

TIP

プレイヤー画面の四隅にコンパスヒント（矢印 + ラベル）が表示されます。条件未達成の場合は 🔒 が付加されます。

ページ送り（page）

pageDir	発火条件	接続先
next（▶▶）	左スワイプ または 下スワイプ	指定ノードへ遷移
prev（◀◀）	右スワイプ または 上スワイプ	不要（履歴スタックから自動で前のノードへ戻る）

HUD の「↩ 戻る」ボタンも page prev を参照します。

タイマー（timer）

フィールド	説明
秒数	シーン表示後に自動遷移するまでの秒数（デフォルト 5）
カウンター表示	↗ 右上（小） / ↓ 中央下（バー） / ＋ 中央リング / 🚫 非表示

videoEnd・動画終了との連携

クリップに videoEnd が設定されている場合、または videoEnd 未設定でループ無しの動画が自然終了した場合：

• タイマーの秒数が動画の実質長以下であれば、動画終了時点で即座に timer トリガーが発火します
• タイマーの秒数が動画の実質長より長い場合は、動画終了時点では発火させず、タイマー自身の残り時間が切れるまで最終フレームで待ちます

再生終了（ended）

メディア（動画・音声）の再生が自然に終了したとき自動発火するトリガーです。タイマーを使わずに「動画を最後まで見たら次のシーンへ」を実現できます。

フィールド	説明
接続先	再生終了後に遷移するノード
条件	条件を満たしたときのみ発火。複数設定時は最初にマッチするものが実行される

タイマーとの優先順位

同じノードにタイマーと再生終了の両方を設定した場合：

• タイマーの秒数 ≤ メディア実質長 → タイマーが優先（動画終了と同時にタイマー発火）
• タイマーの秒数 ＞ メディア実質長 → 再生終了が発火し、タイマーはキャンセル

TIP

静止画クリップには再生終了イベントがないため、タイマーで代替してください。

効果音（トリガー共通）

tap / swipe / timer などすべてのトリガーに 🔊 効果音 を設定できます。トリガーが発火（条件クリア後）した瞬間に音声が再生されます。

フィールド	説明
URL 入力欄	再生する音声ファイルの URL を直接入力（R2 メディアURL など）
📁 ボタン	ローカルファイルを選択（blob URL として一時利用）
ボリュームスライダー	再生音量を 0〜100% で調整（デフォルト 100%）

対応フォーマット：mp3 / wav / aac / ogg など、ブラウザがネイティブ対応する音声形式。

WARNING

接続先ノードが未設定のトリガーは発火しないため、効果音も再生されません。

必須トリガー（トリガー共通）

トリガーの設定パネルにある 🔒 必須 チェックボックスは、tap / text / swipe / page / timer に設定できます。ON にすると、そのトリガーを未経験のシーンではシークバーがロックされ、シークでトリガーの発生位置を飛び越えられなくなります。

状況	シークバー
必須トリガーを未経験のまま初めて訪れたシーン	🔒 ロック（操作不可）
同じシーンを2回目以降に訪れた場合	ロック解除
必須トリガーが無いシーン	常にロックなし

TIP

タイマー（自動発火）トリガーにも設定できます。直前にある回避用のスワイプ・タップトリガーを必須にしておけば、シークで「危険な自動発火の直前だけ」を飛び越えて回避することを防げます。