Spatial Mapping Collider

Spatial Mapping Collider コンポーネントによってホログラフィックコンテンツと現実のサーフェスの相互作用が可能になります。このコンポーネントは、サーフェスの情報を持つゲームオブジェクトの作成、更新、破棄を処理します。

コンポーネントは定期的にシステムへクエリを送り、現実世界で発生した変化を把握します。システムがサーフェスの変化を通知すると、Spatial Mapping Collider コンポーネントは、変化のあったサーフェスが Unity によってベイクされる順序付けをします。サーフェスがベイクされるたびに、Unity によって新しいゲームオブジェクトが生成されます。Mesh Filter と Mesh Collider コンポーネントも含みます。Mesh Collider を持つサーフェスは、Unity の他のメッシュと同様にレイキャストによってヒットすることが可能です。詳しくは、カメラからのレイ を参照してください。

ノート: このコンポーネントはサーフェスゲームオブジェクトの Mesh Collider コンポーネントのみを更新します。Mesh Renderer は更新しません。

ノート: Spatial Mapping Collider の更新は Spatial Mapping Mesh Renderer の更新よりも遅延が軽少です。つまり、コライダーの更新はレンダラーよりも速いということです。

Collider Settings

General Settings

SpatialMapping コンポーネントの一般設定

以下は Spatial Mapping Renderer と Spatial Mapping Collider コンポーネントで共通のプロパティーです。

Level of Detail (LOD)

Spatial Mapping コンポーネントでは、各コンポーネントが生成する空間メッシュの LOD を、以下の画像に表示された 3 種類 Low、Medium、High のいずれかに指定できます。

可能な場合は、Spatial Mapping Colliders の Level of Detail を Low に設定します。これにより、衝突計算のパフォーマンスが向上し、パワーの消費が軽減されます。ただし、Level of Detail を Low に設定すると、アプリケーションの視覚的効果に悪影響をもたらす可能性があります。

Spatial Mapping Collider の使用

サーフェスゲームオブジェクト

シーンで、Spatial Mapping Collider をゲームオブジェクトに加えると、 ゲームオブジェクトはランタイムにもう 1 組のサーフェスゲームオブジェクトを作成します。これは、親のサーフェスゲームオブジェクトの親にあたるシーンに表示されます。

Spatial Mapping Collider によって作成されたサーフェスゲームオブジェクトには、以下のコンポーネントが含まれます。

• Mesh Filter

• World Anchor

• Mesh Collider

シーンに複数の Spatial Mapping Collider コンポーネントを追加すると、各コンポーネントはそれぞれサーフェスゲームオブジェクトの組を生成します。例えば、シーン内の 2 つのゲームオブジェクトに Spatial Mapping Collider が含まれている場合、シーンにはランタイムに各コンポーネントによって生成された 2 組のサーフェスゲームオブジェクトが含まれます。これは、最適化においては注意する必要があります。注意: Spatial Mapping システムによって最初に生成されたとき、すべての サーフェスゲームオブジェクト は Default レイヤー に割り当てられています。ただし、レイキャスティングは実行に高価な計算が必要であるため、ゲームオブジェクトを特定のレイヤーに割り当てることが有効です。レイヤーを使用することで、どのゲームオブジェクトに対してレイキャスト計算を実行しているかをフィルタリングし、パフォーマンスを最適化することができます。デフォルト レイヤーに複雑なメッシュが多数ない場合は、衝突のレイキャストテストを実行してもパフォーマンスが大幅に低下することはありません。ただし、衝突を実行する際のレイキャストテストの複雑さを軽減するために、ゲームオブジェクトをレイヤーに整理するのが最善です。特定の Spatial Mapping Collider コンポーネントによって生成されたすべてのサーフェスゲームオブジェクトに割り当てられたレイヤーを変更するには、Collider Settings > Mesh Layer プロパティーを変更します。

サンプルスクリプト: タップジェスチャーイベントによる SpatialSurface レイキャスト

以下の例は、SpatialSurface レイヤーのゲームオブジェクトに対しレイキャストする方法と、GestureRecognizer を使ってタップジェスチャーイベントの検出時にレイキャストを始める方法を紹介しています。

using UnityEngine;
using System.Collections; 

//Gesture Recognizer に必須
using UnityEngine.XR.WSA.Input;


public class CustomLayerCollision : MonoBehaviour
{

    //ジェスチャーイベントを取得するためにこれを使用します

    private GestureRecognizer GR_recognizer;

    void Start()
    {
        //GestureRecognizer を初期化します

        GR_recognizer = new GestureRecognizer();

        //ジェスチャー取得を始めます

        GR_recognizer.StartCapturingGestures();

        //GestureRecognizer にどのイベントをリッスンするかを指示します

        GR_recognizer.SetRecognizableGestures(GestureSettings.Tap);

        //DetectCollisions メソッドに Tapped イベントをサブスクライブさせます

        //これにより GestureRecognizer がタップイベントを検出するたびに、このメソッドを呼び出します

        GR_recognizer.Tapped += DetectCollisions;

        //ユーザーがタップジェスチャーを始めると、DetectCollisions メソッドが   

        //Tapped イベントデリゲートによって呼び出され Raycasting を使って衝突テストを行います

        //詳しくは [GestureRecognizer API reference](../ScriptReference/XR.WSA.Input.GestureRecognizer.html) を参照してください。
    }
    //タップイベントでレイキャストを発射するメソッド
    public void DetectCollisions(TappedEventArgs tapEvent)
    {
        // Spatial Surface かUI レイヤーのすべてのゲームオブジェクトに対して
        // レイキャストします

        int layerMask = 1 << LayerMask.NameToLayer("SpatialSurface");

        //ユーザーの頭の position と forward 方向を使って Ray を構築します。
        Ray GazeRay = new Ray(tapEvent.headPose.position, tapEvent.headPose.forward);

        //Gaze から構築した Ray を使ってレイキャストし、衝突を行列 hits に保存します 

        RaycastHit[] hits = Physics.RaycastAll(GazeRay, float.MaxValue, layerMask);

        if (hits.Length > 0)
        {
            foreach (RaycastHit hit in hits)
            {
                Debug.Log(string.Format("Hit Object **\"**{0}**\"** at position **\"**{1}**\"**", hit.collider.gameObject, hit.point));
            }
        }
        else
        {
            Debug.Log("Nothing was hit.");
        }
    }
}

詳細は、ドキュメントの レイヤー と カメラからのレイ を参照してください。

–

• 2018–05–01 編集レビュー を行ってパブリッシュされたページ

• Hololens の空間マッピングは 2017.3 に更新