ドキュメント

インタラクション(ロジックノード)

ロジックは、体験が反応する仕組みです。「ノード」パネルで、イベント(起こること)とアクション(行うこと)をワイヤーでつなぎます。コードは不要です。

仕組み

ノードはカードの形をしています。イベントノードの出力とアクションノードの入力を、端子(丸い点)の間にワイヤーをドラッグしてつなぎます。イベントが発生すると、つながったアクションが実行されます。アクションは何個でも続けてつなげられます。

イベントとアクションを接続します。ここでは、オブジェクトをタップするとアニメーションが再生されます。

キャンバスを右クリックするか、パレットから、ノードを追加できます。ノードは色分けされていて、イベントは琥珀色、アクションは空色です。

複数のノードをまとめて操作するには、Shiftキーを押しながら何もない場所をドラッグして範囲選択するか、Shiftキーを押しながらクリックして(Ctrl/Cmdキーを押しながらのクリックでも可)選択にノードを追加します。選択したノードはドラッグでまとめて移動でき、Deleteキーでまとめて削除できます。右クリックメニューからも同じ操作ができます。

イベント

イベント発生条件
シーン開始時シーンが最初に表示されたとき(ターゲットが見つかったとき、または「シーンへ移動」で切り替わってきたとき)。
タップ時選んだオブジェクト(3Dオブジェクト、または画面上のUIオーバーレイ要素)をユーザーがタップしたとき。
衝突時選んだ2つのオブジェクトが触れたとき。下の衝突判定を参照してください。
手で触れた時 / 手が離れた時選んだインタラクティブなオブジェクトに、手や指が触れ始めたとき、または触れるのをやめたとき。ハンドインタラクションと物理を参照してください。
つかんだ時 / 放した時選んだインタラクティブなオブジェクトが持ち上げられたとき、または放されたとき。

アクション

アクション動作
シーンへ移動別のシーンに切り替えます。切り替え効果(フェード、拡大ポップ、上へスライド、スピン)とその長さも指定できます。
サウンドを再生取り込んだ音声クリップを、スライダーで決めた音量で再生します(ループ再生も選べます)。開始時の出力はすぐに実行され、サウンド後は音声が最後まで再生されたときに実行されます(ループ中は実行されず、先に停止、同じ音声の再生し直し、シーンの切り替えが起きた場合も実行されません)。
サウンドを停止再生中のサウンドを止めます。選んだ音声クリップを再生しているものはすべて停止し、先頭に戻ります。
動画を再生選んだ動画オブジェクトを、音量(0で無音)と速度を指定して、ループあり・なしで再生します。開始時はすぐに実行され、動画後は動画が最後まで再生されたときに実行されます(ループ中は実行されず、先に停止、同じオブジェクトでの再生し直し、シーンの切り替えが起きた場合も実行されません)。タップするまで音声を止めるブラウザでは無音で再生されます。
動画を停止選んだ動画オブジェクトを止めて、先頭まで巻き戻します。
アニメーションを再生オブジェクトでアニメーションクリップを再生します(キーフレームクリップ、またはモデルに埋め込まれたアニメーション)。開始時の出力はすぐに実行されます。アニメーション後はクリップが最後まで再生されたときに実行されます。ループするクリップでは実行されず、先にアニメーションを停止、同じオブジェクトでの別のアニメーションを再生、シーンの切り替えが起きた場合も実行されません。
アニメーションを停止再生中のアニメーションを止め、その時点の状態で静止させます。
オブジェクトを表示 / オブジェクトを非表示オブジェクトを表示・非表示にします。
フェード指定した秒数でオブジェクトをフェードイン、またはフェードアウトします。フェードインはオブジェクトを表示し、本来の不透明度(インスペクターの不透明度)まで上げます。フェードアウトは見えなくなるまで下げてから非表示にするので、タップできなくなります。出力につないだ処理はフェードが終わってから実行されます。同じオブジェクトで新しいフェードが始まると、今の状態から引き継ぎます。
待機指定した秒数だけ待ってから、つながっている次のアクションを実行します。
物理を設定 / インタラクティブを設定衝突判定のあるオブジェクトの重力、または触れたりつかんだりできるかどうかを、オンまたはオフにします。
「押して動かせる」を設定衝突判定と物理のあるオブジェクトを、開いた手で押して動かせるようにするか、できないようにします。
オブジェクトを押す物理のあるオブジェクトをひと押しします。
オブジェクトをリセットオブジェクトを、シーン開始時に置かれていた場所へ静止した状態で戻します。

補足

サウンドや動画が、そのシーンを超えて再生され続けることはありません。シーンへ移動で別のシーンに切り替わると、ループ再生のサウンドを含め、再生中のものはすべて自動的に停止します。

使用例

オブジェクトをタップしたら、それを表示し、サウンドを鳴らし、少し待ってから次のシーンへ移動する、という動きを作るには、次のようにします。

  1. タップ時ノードを追加して、オブジェクトを選びます。
  2. オブジェクトを表示 → サウンドを再生 → 待機(2秒) → シーンへ移動の順にワイヤーでつなぎます。

変数・演算・制御

さらに3つのノードカテゴリを使うと、スコアの記録、計算、条件による判断など、より高度な動作を作れます。パレットでは、折りたためる見出しの下にまとまっているので、使わないときは閉じておけます。

変数とは、体験の実行中に覚えたり変更したりできる、名前付きの値のことです。スコア、カウンター、オン/オフの状態などに使えます。変数は、左側の変数パネルで作成します。それぞれに名前、型(数値、テキスト、真偽値)、初期値を設定してください。変数はシーン専用(そのシーンが始まるたびにリセット)にも、グローバル(シーンをまたいで共有され、利用中ずっと保持)にもできます。

これらのカテゴリでは、2種類のワイヤーを使います。

  • フローワイヤー(これまでと同じ)は、次に何を実行するかを決めます。
  • 値ワイヤーは、数値、テキスト、真偽値を、あるノードの出力から別のノードの入力へ運びます(下の図では青色で表示)。
値のワイヤー(青)はノードにデータを渡します。ここでは、タップするたびにスコアが1ずつ増えます。
カテゴリノード
変数変数を設定(変数に値を入れる)と変数を取得(現在の値を読み取る)。
演算値(固定の値)、計算(足し算・引き算・掛け算・割り算・余り)、比較(等しい、より小さい、より大きいなど → 真または偽)、AND / OR / NOT(かつ・または・ではない)。
制御条件分岐(真の枝か偽の枝を実行)、条件ループ(条件が成り立つ間、繰り返す)、回数ループ(開始値から終了値まで数えながら繰り返す)。

変数を画面に表示するには、UIオーバーレイにテキスト要素を追加し、変数をリアルタイム表示オプションを設定します。すると、テキストに変数の値が表示され、値が変わった瞬間に更新されます。ライブスコアにぴったりです。

補足

変数の変更や、条件分岐・条件ループ・回数ループによる判断は、ロジックの実行中に即座に行われます。待機が遅らせるのは、その後のアクションだけです。変数の設定や条件のチェックは遅れません。また、ループには上限が設けられているので、体験がフリーズすることはありません。

衝突判定:2つのオブジェクトが触れたとき

衝突時イベントは、2つのオブジェクトがぶつかったときに発生します。

  1. それぞれのオブジェクトを選択し、インスペクターで衝突判定をオンにします。両方のオブジェクトでオンにする必要があります。
  2. 衝突時ノードを追加し、オブジェクトAとオブジェクトBを選びます。
  3. 起こしたい動作(サウンド、スコアの変更、シーンの切り替えなど)にワイヤーでつなぎます。
「衝突時」は、衝突判定を持つ2つのオブジェクトのボックスが触れたときに、1回だけ実行されます。

発生するのは、オブジェクトを囲むボックス同士が最初に重なったときの1回だけです。再び発生するのは、少なくとも0.25秒離れてからもう一度触れたときだけです。そのため、触れたままにしても、一瞬跳ね返ったり揺れたりしても、繰り返し発生することはありません。AとBの順序は関係ありません。衝突判定が使えるのは3Dのシーンオブジェクトで、画面上のUIオーバーレイ要素には使えません。

各オブジェクトを囲むボックスは、境界を変更した場合(メッシュ以外の種類に)はその境界に合わせ、それ以外は描画されたオブジェクトに合わせます。床をオンにした平面は常に固体として扱われるので、衝突時ノードで選ぶこともできます。

補足

ノードが指しているオブジェクトやシーンを削除すると、AR Worksはその参照を解除し、ノードに警告バッジを表示します。ノードが何も起こさないまま放置されることはなく、指定し直す必要があることがひと目でわかります。

ヒント

プレビューを使うと、ロジックをすぐにテストできます。ブラウザ上でオブジェクトをそのままタップして試せます。