All content in this course uses:

タッチ入力とレイキャストの設定後に、検出した平面上へポータルのゲームオブジェクトをインスタンス化する方法を学びます。

平面の上にポータルをインスタンス化する

このポータルのために、多くの設定作業を行ってきました。具体的には、ポータルのテーマを選択し、平面の検出を設定し、ユーザーがタッチした位置を検出し、シーンへのレイキャストを使用して有効な平面がタッチされたかどうかを特定しました。このチュートリアルでは、環境内の選択された平面上に、ポータルのゲームオブジェクトを実際にスポーン（またはインスタンス化）します。

このポータルのために、多くの設定作業を行ってきました。具体的には、ポータルのテーマを選択し、平面の検出を設定し、ユーザーがタッチした位置を検出し、シーンへのレイキャストを使用して有効な平面がタッチされたかどうかを特定しました。ここでは、環境内で選択された平面上に

のゲームオブジェクトを実際にスポーン（または

このチュートリアルを完了すると、プロジェクトは以下のビデオデモのようになります。

このポータルをシーンにスポーンする上で最もやっかいなのは、それらのうち 1 つだけをスポーンするという点です。新しい 

 ノードを使用して、何百ものポータルを一度に誤ってスポーンしないようにする必要があります。

概要

シーンに新しいオブジェクト（ゲームオブジェクト）をスポーンする場合、それは「

」と呼ばれることがよくあります。オブジェクトの新しいインスタンス（バージョン）を作成するためです。今回は、

プレハブの新しいインスタンスを作成します。

このオブジェクトをインスタンス化するときには、以下の入力を定義する必要があります。

これらの入力についてそれぞれ詳しく見ていきましょう。

 入力には、インスタンス化したいプレハブを選択します。アプリケーションで机や床の水平な平面を検出する場合は、上からのぞき込むことができる水平なポータルを選択します。アプリケーションで壁やドアの垂直な平面を検出する場合は、窓のようにのぞき込むことができる垂直なポータルを選択します。

 にあります。3 つすべての環境に対して水平と垂直のオプションが用意されています。

目標は、ポータルを平面と同じ位置に配置することです。平面の位置を取得するために、

 ノードを使用します。その後、

のゲームオブジェクトをインスタンス化するときにその同じ位置を使用できます。

ポータルの回転も、平面の回転と一致している必要があります。

 ノードを使用して平面の位置を取得したのと同じように、

 ノードを使用して平面の回転を取得します。

オブジェクトをインスタンス化する方法

このポータルをインスタンス化する方法について理解できたので、ビデオを視聴するか、以下の手順に従って、ビジュアルスクリプトを更新しましょう。

 スクリプトグラフが開いた状態になっていることを確認します。

 シーケンスの末尾に、新しい 

 ノードを追加して、シーケンスの末尾に結び付けます。必ず、次の 3 つの入力を持つ 

 入力には、オブジェクトピッカー（丸）を使用して水平または垂直な

 ノードにアタッチし、次にそれを 

  アプリケーションをビルドして実行し、新しい機能をプレビューします。有効な平面をタッチすると、平面の中央にポータルがスポーンするはずです。

垂直な平面に関するトラブルシューティング

：垂直な平面とポータルを使用している場合は、（以下のように）ポータルが壁に張りつく形ではなく、下向きに回転してスポーンすることに気づかれるでしょう。

ご安心ください。次のステップで修正します。

ポータルをインスタンス化する

垂直なポータルを使用している場合は、このステップを完了してポータルのスポーンの回転を修正してください。水平なポータルを使用している場合は、このステップを完了する必要はありませんが、平面上のオブジェクトの向きを設定する方法について深く理解するために、ひととおり読んでおくことをお勧めします。

垂直なポータルを作成しようとすると、ポータルが下向きにスポーンすることに気づきます。

問題は、垂直な平面が床から見て 90 度回転しているという点にあります。ポータルの回転を平面と一致するように設定すると、ポータルも床から見て 90 度回転することになります。

これを可視化するために、垂直なポータルが水平な平面上にスポーンする様子を以下の画像に示します。

しかし、この平面を 90 度回転して、垂直な壁の位置に置くとどうなるかをご覧ください。ポータルは下向きに回転します。

この下向きの回転を修正するには、ポータルウィンドウを逆向きに回転させて平らに置き、垂直な平面上にスポーンしたときにはポータルも垂直になるようにする必要があります。

以下の手順に従って、垂直なポータルを回転させ、垂直な平面に張りつくようにスポーンさせます。

 に移動し、使用しているポータルをダブルクリックして、シーンビューでプレハブを開きます。

 ゲームオブジェクトを選択し、シーンビューで 90 度回転させて上を向くようにします。ウィンドウの外面がシーンギズモの緑の Y 軸アームの方向を向き、ウィンドウの上部が青い Z 軸アームの方向を向くようにする必要があります。

 の親ゲームオブジェクトではなく、子ゲームオブジェクトを回転させる必要があります。最上位の親ゲームオブジェクトを回転させても、インスタンス化するとリセットされます。そのため、この親ゲームオブジェクトの回転を編集しても、オーバーライドされてしまいます。

 アプリケーションをビルドして実行し、新しい機能をプレビューします。垂直なポータルをインスタンス化すると、垂直な平面に張りつくように、正しい向きで表示されるはずです。

垂直なポータルの回転を修正する

前のステップでは、平面上に 1 つのポータルをスポーンしただけだと思われたかもしれません。しかし実際には、何百ものポータルをスポーンしていた可能性があります！

以下のビデオのデバッグ UI は、シーン内の現在のオブジェクトの数を表示しています。ご覧のように、ユーザーの指が画面に触れている間、ポータルは生成され続けます。

複数のポータルがスポーンされることは、現段階では大きな問題に見えないかもしれません。しかし、ポータル内にシーン全体をスポーンさせる段階になると、複数のポータルをインスタンス化することでアプリケーションの速度が大幅に低下するおそれがあります。

1 つのポータルをスポーンするプロセス

ノードシーケンスを複数回実行できないようにすることで、多数のポータルがスポーンされるのを防ぐことができます。以下のロジックを使用して、Boolean を使用してシーケンスを実行する回数を制限できます。

 変数を作成し、デフォルトで 

ノードシーケンスの末尾で、その Boolean を 

 の場合にのみシーケンスを実行します。

以下の図は、この Boolean のロジックを可視化したものです。

：スポーンされたオブジェクトの数をご自身のアプリケーションのデバッグ UI に表示したい場合は、以下のビジュアルスクリプトを確認してください。これは完全に任意です。

アクションが 1 回しか実行されないように制限する方法

前のステップで学習したように、この Boolean ロジックの設定は 3 段階のプロセスになります。ステージ 1 とステージ 2 を以下に示します。

ステージ 1：Boolean 変数を作成し、false に設定する

以下の手順に従って、新しい Boolean 変数を設定します。

「Script Graph」ウィンドウで TapToPlace スクリプトが開かれていることを確認します。

」タブで、「portalSpawned」という名前の新しい変数を追加し、その「

チェックボックスはオフのままにしてください。これは、デフォルトで 

ステージ 2：シーケンスの末尾で Boolean を false に設定する

ビデオを視聴するか、以下の指示に従って、Boolean 値を 

」ノードを結び付けます。変数の「

 ノードのチェックボックスをオンにして、新しい値を 

Boolean 値を設定する

これで、最初のインスタンス化シーケンスを実行した後に、portalSpawned の Boolean は true に設定されます。このプロセスの最終段階は、portalSpawned の Boolean が true の場合にシーケンスを再び実行しないようにすることです。このロジックを実装するには、

 出力が備わっています。これにより、Boolean を結び付けて、その Boolean が true の場合はあるシーケンスを開始し、その Boolean が false の場合は別のシーケンスを開始することができます。

ビデオを視聴するか、以下の指示に従って、スクリプトの開始時に portalSpawned の Boolean が false かどうかを確認しましょう。

 変数ノードに結び付けます。これは、「Blackboard」から変数をドラッグする代わりの方法です。

 出力フローを、シーケンスの残りの部分に結び付けます。これで、シーケンスの残りの部分は、

 が false の場合にのみ実行されます。

新しい Boolean 制御をテストする

シーン内には 1 つのポータルしかスポーンできなくなっているはずです。それをテストするために、最初に表示された平面の上にポータルをスポーンしてから、2 番目に表示された平面の上に 2 番目のポータルをスポーンしてみてください。2 番目のポータルをスポーンできなくなっているはずです。

ビジュアルスクリプティングスキルを試す任意の課題として、上の例のように、デバッグ UI を使用して現在の Boolean 値を表示してみることもできます。

If ノードを使用してシーケンスを 1 回だけ実行する

有効なポータルを表示した後は、アプリケーションで既存の AR 平面をすべて削除し、新しい AR 平面を表示しないようにする必要があります。ユーザーの注目は、注意をそらす機能しない半透明の平面ではなく、シーン内の 1 つのポータルだけに向けられる必要があります。

便利なことに、AR Plane Manager には以下の 2 つのノードが含まれています。

：これを使用して、既存の平面をすべて無効にすることができます。

：これを使用して AR Plane Manager 全体を無効にし、新しい平面の生成を防ぐことができます。

これらのノードを使用するには、新しい 

 変数を作成する必要もあります。

ビデオを視聴するか、以下の指示に従って、既存の平面と新しく検出される平面をすべて無効にしましょう。

」タブで、「arPlaneManager」という名前の新しい変数を作成し、その「

」に設定します。オブジェクトピッカー（丸）を使用して、

 ゲームオブジェクトを選択します。

 ノードを追加します。新しいノードの「

」チェックボックスがオフになっていることを確認してください。これにより、トラッカブル平面が無効になります。

 ノードを追加します。このノードのチェックボックスがオフになっていることを確認してください。これにより、Plane Manager が無効になります。

  アプリケーションをビルドして実行し、新しい機能をプレビューします。ポータルがスポーンされると、すべての平面が消え、新しい平面は検出されなくなるはずです。

アプリケーションが期待どおり動作していることを確認したら、このタイミングで 

 ゲームオブジェクトを無効にし、

 ノードに関連するすべてのノードを切り離しましょう。

ポータルをスポーンした後にすべての平面を無効にする

さらなるスキルの向上や、新しいコンセプトの模索、現プロジェクトについての改善などを考えているのであれば、以下の任意のアクティビティもぜひ見るようにしてみてください。それぞれ「初級」、「中級」、「上級」のタグが付いているので、難易度を選択できます。

これらのアクティビティは完全に任意であるため、興味がなければこのステップをスキップしてもかまいません。

ただ、今回の学習体験を最大限に生かすためにも、このアクティビティのうち少なくとも 1 つは試してみることをお勧めします。頑張ってください！

初級：ポータルがスポーンされるときにパーティクルエフェクトを追加する

ポータルをスポーンさせるのは、とても不思議で魔法のような体験です。スポーンのアクションに伴って何かジュアルエフェクト（VFX）が発生すれば、ユーザーにとってさらにエキサイティングな体験となるでしょう。以下のガイダンスを使用するとこの課題の完了に役立ちます。

独自のパーティクルエフェクトを作成するか、アセットストアからダウンロードすることができます。

ポータルに使用したのと同じインスタンス化手法を使用してパーティクルシステムをインスタンス化できます。または、ポータルウィンドウ自体の子オブジェクトとしてパーティクルシステムをアタッチすることもできます。

さらにガイダンスが必要な場合は、「

」で VFX の詳細を学んでください。

中級：ポータルがスポーンされるときにサウンドを追加する

スポーンイベントに伴ってサウンドが発生すれば、ユーザーにとってさらに満足感のあるはっきりした体験となるでしょう。ポータルをスポーンするシーケンスにサウンドを追加してみましょう。以下のガイダンスを使用するとこの課題の完了に役立ちます。

 ゲームオブジェクトを作成し、その「

」プロパティにサウンドエフェクトを割り当てます。

 ノードを追加して、ポータルをスポーンするときにサウンドを再生します。

」でオーディオの詳細を学んでください。

上級：一度に 1 つの平面のみを許可する

環境内で検出される平面が数多くあると、ユーザーは少し圧倒されてしまうかもしれません。代わりに、検出された 1 つの平面だけが一度にシーンに存在できるようにすれば、ユーザー体験が改善されるかもしれません。以下のガイダンスを使用するとこの課題の完了に役立ちます。

「LimitPlanes」という名前の新しいスクリプトマシンを作成して、その機能を制御します。このような追加の機能は、メインスクリプトとは別に管理すると便利です。

 ノードを使用して、現在の AR Plane 型のゲームオブジェクト数を取得します。

 ノードを使用して、シーン内に 1 つ以上の AR 平面が存在するかどうかを確認します。

シーン内に 1 つ以上の平面が存在する場合は、AR Plane Manager を無効にします。

 ノードを使用して、AR Plane Manager が存在する場合にのみこのシーケンスを実行します。

：現在の平面の数を表示するデバッグ UI は、デモのために設定されたものです。この課題では要求されていません。

他にもトライしてほしいこと

このチュートリアルでは、環境内で検出された平面上に 1 つのポータルをインスタンス化する処理を制御できました。次のチュートリアルでは、ポータルウィンドウの背後に 1 つのシーン全体をデザインし、モバイルでのパフォーマンス用に最適化します。

Unity Version 2021.3