All content in this course uses:

ユーザーが平面をタッチしたときに検出する

最終的には、ユーザーが平面をタッチしたときにポータルをスポーンします。このチュートリアルでは、まず、環境内で検出された平面に、ユーザーが正しくタッチしたかどうかを特定します。

この機能を実装するために、「レイキャスティング」と呼ばれる手法を使用します。

アプリケーションは、環境内にある垂直または水平の平面を検出できます。また、画面上でユーザーがタッチした位置も検出できます。次は、これら 2 つの機能を使用して、ユーザーがその平面のどれかに正しくタッチしたかどうかを特定する必要があります。

後ほど、ユーザーが平面をタッチしたらポータルをスポーンして、自分の物理環境のサーフェスを通してバーチャル世界を見ることができるようにします。

概要

）を原点からシーンを通るように発射し、その線が当たる物体を特定するプロセスです。これは少し魚釣りと似ています。魚釣りでは、釣り糸を投げてどのような魚が釣れるかを見ます。レイキャスティングでは、レイを発射して、そのレイがシーンの何に当たるかを見ます。

通常は、レイキャストが当たったすべてのオブジェクトを 

その後、そのリスト内のオブジェクトにアクセスして、望みの処理を実行します。

レイキャストはプログラミングにおいて非常に役立ちます。例えば、レイの発射は、ターゲットに武器が当たるかどうかや、近くにオブジェクトが存在するかどうかを判断する際に役立ちます。

このアプリケーションの場合は、レイキャストは画面上の何かがユーザーによって正しくタッチされたかどうかを判断する際に役立ちます。ユーザーが画面にタッチすると、アプリケーションはタッチした位置を原点として使用して、シーンに向かって真っすぐにレイを発射します。そのレイが平面に当たった場合、アプリケーションはそれを正しいタッチとして記録します。

レイキャスティングとは

以前に、シーンで検出される平面を管理するために AR Plane Manager コンポーネントを追加しました。同様に、シーンに発射されるレイを管理するには 

 コンポーネントが必要です。AR Raycast Manager にはまさに必要な機能が備わっています。画面タッチの位置からレイを発射し、そのレイがトラッカブルなオブジェクト（水平または垂直な平面など）と交差するかどうかを判断します。

以下の手順に従って、その新しいコンポーネントを追加します。

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

 「Inspector」で、新しい AR Raycast Manager コンポーネントを追加します。

AR Raycast Manager を追加する

 ビジュアルスクリプティングノードを利用する必要があります。

ただし、このノードをスクリプトグラフに追加しようとしても、ノードライブラリには見つかりません。今すぐグラフエディターでこのノードを検索してみてください。結果は見つかりません。

ここまでに、AR 開発または AR Foundation パッケージに固有のノードは実際には使用してきませんでした。デフォルトでは、ビジュアルスクリプティングライブラリには AR 固有のノードが含まれていません。AR Foundation ノードライブラリを手動でインポートする必要があり、その後で AR 固有のノードを追加できるようになります。

ビデオを視聴するか、以下の指示に従って、AR Foundation ノードライブラリをインポートしましょう。

  「Project Settings」ウィンドウの左側のパネルで、「

折りたたみ項目（三角形）を使用して「

」セクションを展開し、ノードアセンブリのリストの一番下までスクロールします。

)」を選択して、新しい項目をリストに追加します。

新しい項目のアセンブリのドロップダウンを選択し、「AR Foundation」と検索して、

」を選択して、「Script Graph」ウィンドウでこの新しいノードにアクセスできるようにします。

グラフエディターで、ファジーファインダーを使用して「AR Raycast Manager」と検索し、AR 固有のノードが利用できるようになっていることを確認します。

AR Foundation ノードライブラリを追加する

この機能を完成させるには、ビジュアルスクリプトに 2 つの新しい 

 変数を追加する必要があります。1 つは先ほど追加した AR Raycast Manager コンポーネント用、もう 1 つはレイキャストが当たったオブジェクトを格納する 

当たるオブジェクトを調べるためにレイキャストがシーンに向かって発射されると、当たったオブジェクトのリストが生成されることを思い出しましょう。そのリストを新しい変数に格納する準備をしておく必要があります。この場合は、「

」と呼ばれる特定の型のリストを使用します。「Aot」は Ahead Of Time（事前に）の略語です。なぜなら、このリストは事前に、つまりアプリケーションを実行する前に定義されるためです。

以下の手順に従って、AR Raycast Manager と Aot List 用の新しい変数を作成しましょう。

 スクリプトが開かれていることを確認します。

「arRaycastManager」という名前の新しい変数を作成し、その「

」のオブジェクトピッカー（丸）を選択し、「

」を選択します（これには AR Raycast Manager コンポーネントが含まれています）。

「hits」という名前の別の新しい変数を作成し、その「

」は空のままにしておきます。アプリケーションの実行中に、レイキャストはこのリストにオブジェクトを追加します。

これで、レイキャストを実装するために必要なすべての変数が揃いました。

レイキャスティング用の変数を追加する

アプリケーションがレイキャストを実行するのは、ユーザーがタッチした位置を特定した直後、デバッグ UI にメッセージを送信する前です。

ビデオを視聴するか、以下の手順に従って、グラフに 

 ノード用のスペースを作ります。

ファジーファインダーを使用して 

AR Raycast Manager: Raycast (Screen Point, Hit Results, Trackable Types)

：必ず上記の特定の入力を持つ 

 ノードを選択してください。よく似た入力を持つ別のノードが存在しますが、同じ機能は提供されません。

 ノードの前にレイキャストが実行されるように、各ノードを切り離して結び付け直します。

 ノードをシーケンス内の正しい位置に配置できました。

ノードシーケンスに Raycast ノードを追加する

特定の入力を使用してレイキャストを設定する準備が整いました。このノードに必要なすべての入力は、

 ノードを選択した状態の「Graph Inspector」で確認できます。

ビデオを視聴するか、以下の手順に従って、

 ノードの入力を設定しましょう。

 変数をクリックして、グラフエディターにドラッグします。

」に設定して、選択可能なすべてのオプションを選択解除してから、「

Raycast ノードの入力を設定する

もう一度、デバッグ UI を使用してアプリケーションが期待どおりに動作していることを確認しましょう。ここでは、ユーザーが有効な平面をタッチした場合は「

」、有効な平面以外のものをタッチした場合は「

」と表示するようにデバッグ UI を設定します。これによって、アプリケーションでポータルを配置できる平面をユーザーが選択しているかどうかを、アプリケーションが正しく記録していることを確認できます。

 ノードを使用して、タッチした位置を UI に表示できるテキストに変換しました。しかしここでは、

 ノードを使用して異なるアプローチを取ることができます。

 ノードを選択して「Graph Inspector」を確認すると、出力が Boolean であることがわかります。つまり、レイキャストが平面に当たったかどうかを示す true または false の値です。

ここでは、タッチした位置をデバッグ UI に表示する代わりに、その Boolean を表示します。つまり、

 ノードを使用する必要があります。

ビデオを視聴するか、以下の手順に従って、デバッグ UI のメッセージを 

 ノードの Boolean 出力に置き換えましょう。

 ノードを検索して、代わりに選択します。

 ノードに結び付ける必要があります。

  アプリケーションをビルドして実行し、新しい機能をプレビューします。有効な平面にタッチすると、UI に「

」と表示されるはずです。有効な平面以外をタッチすると、UI に「

おめでとうございます！レイキャスティングを使用して、ユーザーが画面上でタッチしたものを検出することができました。

レイキャストの結果をデバッグ UI に表示する

スキルをさらに向上させたい場合、または新しいコンセプトを探求したい場合、またはプロジェクトを改善したい場合は、以下のオプションのアクティビティを調べてください。

このアクティビティは完全に任意なので、興味がなくても問題ありません。このステップはただスキップするだけで構いません。

ただ、今回の学習体験を最大限に生かすためにも、この種の課題を試してみることをお勧めいたします。頑張ってください！

中程度：より具体的なデバッグメッセージを連結する

このチュートリアルでは、デバッグ UI に「true」または「false」というブーリアン値を表示しました。これはあまりわかりやすいデバッグメッセージとは言えません。「plane touched: true（平面にタッチ：true）」や「plane touched: false（平面にタッチ：false）」といった、より具体的な内容を表示すべきです。

このようなメッセージを表示するには、連結を使用する必要があります。プログラミングの用語では、「

」とは通常、複数の文字列を 1 つにつなげるプロセスを指します。普通のテキスト文字列（「plane touched:」など）をより動的なデータ（Boolean 値など）と連結して、そのデータを読みやすくする場合がよくあります。アプリケーションで、より有用な連結したデバッグメッセージを実装できるかどうか試してみてください。

以下のガイダンスを使用するとこの課題の完了に役立ちます。

「plane touched: 」というシンプルな文字列を 1 つ目の入力に、Raycast の Boolean を 2 つ目の入力に結び付けます。

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

このチュートリアルでは、レイキャストを使用して、ユーザーが画面上の有効な平面ターゲットにタッチしたかどうかを特定しました。次のチュートリアルでは、シーンに

のゲームオブジェクトを実際にスポーンして、ユーザーが選択した平面の上に配置します。

Unity Version 2021.3