ドキュメント
インタラクション(ロジックノード)
ロジックは、体験が反応する仕組みです。「ノード」パネルで、イベント(起こること)とアクション(行うこと)をワイヤーでつなぎます。コードは不要です。
仕組み
ノードはカードの形をしています。イベントノードの出力とアクションノードの入力を、端子(丸い点)の間にワイヤーをドラッグしてつなぎます。イベントが発生すると、つながったアクションが実行されます。アクションは何個でも続けてつなげられます。
キャンバスを右クリックするか、パレットから、ノードを追加できます。ノードは色分けされていて、イベントは琥珀色、アクションは空色です。
複数のノードをまとめて操作するには、Shiftキーを押しながら何もない場所をドラッグして範囲選択するか、Shiftキーを押しながらクリックして(Ctrl/Cmdキーを押しながらのクリックでも可)選択にノードを追加します。選択したノードはドラッグでまとめて移動でき、Deleteキーでまとめて削除できます。右クリックメニューからも同じ操作ができます。
イベント
| イベント | 発生条件 |
|---|---|
| シーン開始時 | シーンが最初に表示されたとき(ターゲットが見つかったとき、または「シーンへ移動」で切り替わってきたとき)。 |
| タップ時 | 選んだオブジェクト(3Dオブジェクト、または画面上のUIオーバーレイ要素)をユーザーがタップしたとき。 |
| 衝突時 | 選んだ2つのオブジェクトが触れたとき。下の衝突判定を参照してください。 |
| 手で触れた時 / 手が離れた時 | 選んだインタラクティブなオブジェクトに、手や指が触れ始めたとき、または触れるのをやめたとき。ハンドインタラクションと物理を参照してください。 |
| つかんだ時 / 放した時 | 選んだインタラクティブなオブジェクトが持ち上げられたとき、または放されたとき。 |
アクション
| アクション | 動作 |
|---|---|
| シーンへ移動 | 別のシーンに切り替えます。切り替え効果(フェード、拡大ポップ、上へスライド、スピン)とその長さも指定できます。 |
| サウンドを再生 | 取り込んだ音声クリップを、スライダーで決めた音量で再生します(ループ再生も選べます)。開始時の出力はすぐに実行され、サウンド後は音声が最後まで再生されたときに実行されます(ループ中は実行されず、先に停止、同じ音声の再生し直し、シーンの切り替えが起きた場合も実行されません)。 |
| サウンドを停止 | 再生中のサウンドを止めます。選んだ音声クリップを再生しているものはすべて停止し、先頭に戻ります。 |
| 動画を再生 | 選んだ動画オブジェクトを、音量(0で無音)と速度を指定して、ループあり・なしで再生します。開始時はすぐに実行され、動画後は動画が最後まで再生されたときに実行されます(ループ中は実行されず、先に停止、同じオブジェクトでの再生し直し、シーンの切り替えが起きた場合も実行されません)。タップするまで音声を止めるブラウザでは無音で再生されます。 |
| 動画を停止 | 選んだ動画オブジェクトを止めて、先頭まで巻き戻します。 |
| アニメーションを再生 | オブジェクトでアニメーションクリップを再生します(キーフレームクリップ、またはモデルに埋め込まれたアニメーション)。開始時の出力はすぐに実行されます。アニメーション後はクリップが最後まで再生されたときに実行されます。ループするクリップでは実行されず、先にアニメーションを停止、同じオブジェクトでの別のアニメーションを再生、シーンの切り替えが起きた場合も実行されません。 |
| アニメーションを停止 | 再生中のアニメーションを止め、その時点の状態で静止させます。 |
| オブジェクトを表示 / オブジェクトを非表示 | オブジェクトを表示・非表示にします。 |
| フェード | 指定した秒数でオブジェクトをフェードイン、またはフェードアウトします。フェードインはオブジェクトを表示し、本来の不透明度(インスペクターの不透明度)まで上げます。フェードアウトは見えなくなるまで下げてから非表示にするので、タップできなくなります。出力につないだ処理はフェードが終わってから実行されます。同じオブジェクトで新しいフェードが始まると、今の状態から引き継ぎます。 |
| 待機 | 指定した秒数だけ待ってから、つながっている次のアクションを実行します。 |
| 物理を設定 / インタラクティブを設定 | 衝突判定のあるオブジェクトの重力、または触れたりつかんだりできるかどうかを、オンまたはオフにします。 |
| 「押して動かせる」を設定 | 衝突判定と物理のあるオブジェクトを、開いた手で押して動かせるようにするか、できないようにします。 |
| オブジェクトを押す | 物理のあるオブジェクトをひと押しします。 |
| オブジェクトをリセット | オブジェクトを、シーン開始時に置かれていた場所へ静止した状態で戻します。 |
補足
使用例
オブジェクトをタップしたら、それを表示し、サウンドを鳴らし、少し待ってから次のシーンへ移動する、という動きを作るには、次のようにします。
- タップ時ノードを追加して、オブジェクトを選びます。
- オブジェクトを表示 → サウンドを再生 → 待機(2秒) → シーンへ移動の順にワイヤーでつなぎます。
変数・演算・制御
さらに3つのノードカテゴリを使うと、スコアの記録、計算、条件による判断など、より高度な動作を作れます。パレットでは、折りたためる見出しの下にまとまっているので、使わないときは閉じておけます。
変数とは、体験の実行中に覚えたり変更したりできる、名前付きの値のことです。スコア、カウンター、オン/オフの状態などに使えます。変数は、左側の変数パネルで作成します。それぞれに名前、型(数値、テキスト、真偽値)、初期値を設定してください。変数はシーン専用(そのシーンが始まるたびにリセット)にも、グローバル(シーンをまたいで共有され、利用中ずっと保持)にもできます。
これらのカテゴリでは、2種類のワイヤーを使います。
- フローワイヤー(これまでと同じ)は、次に何を実行するかを決めます。
- 値ワイヤーは、数値、テキスト、真偽値を、あるノードの出力から別のノードの入力へ運びます(下の図では青色で表示)。
| カテゴリ | ノード |
|---|---|
| 変数 | 変数を設定(変数に値を入れる)と変数を取得(現在の値を読み取る)。 |
| 演算 | 値(固定の値)、計算(足し算・引き算・掛け算・割り算・余り)、比較(等しい、より小さい、より大きいなど → 真または偽)、AND / OR / NOT(かつ・または・ではない)。 |
| 制御 | 条件分岐(真の枝か偽の枝を実行)、条件ループ(条件が成り立つ間、繰り返す)、回数ループ(開始値から終了値まで数えながら繰り返す)。 |
変数を画面に表示するには、UIオーバーレイにテキスト要素を追加し、変数をリアルタイム表示オプションを設定します。すると、テキストに変数の値が表示され、値が変わった瞬間に更新されます。ライブスコアにぴったりです。
補足
衝突判定:2つのオブジェクトが触れたとき
衝突時イベントは、2つのオブジェクトがぶつかったときに発生します。
- それぞれのオブジェクトを選択し、インスペクターで衝突判定をオンにします。両方のオブジェクトでオンにする必要があります。
- 衝突時ノードを追加し、オブジェクトAとオブジェクトBを選びます。
- 起こしたい動作(サウンド、スコアの変更、シーンの切り替えなど)にワイヤーでつなぎます。
発生するのは、オブジェクトを囲むボックス同士が最初に重なったときの1回だけです。再び発生するのは、少なくとも0.25秒離れてからもう一度触れたときだけです。そのため、触れたままにしても、一瞬跳ね返ったり揺れたりしても、繰り返し発生することはありません。AとBの順序は関係ありません。衝突判定が使えるのは3Dのシーンオブジェクトで、画面上のUIオーバーレイ要素には使えません。
各オブジェクトを囲むボックスは、境界を変更した場合(メッシュ以外の種類に)はその境界に合わせ、それ以外は描画されたオブジェクトに合わせます。床をオンにした平面は常に固体として扱われるので、衝突時ノードで選ぶこともできます。
補足
ヒント