画像追跡コロカライゼーション（Image Tracking Colocalization）の使い方

イメージトラッキングのコロカライゼーションを使えば、VPSが有効なロケーションがなくても、イメージターゲットを使って共有AR体験をトリガーすることができます。 イメージがAR経験の起点になります。 つまり、テストやデモ用に印刷した画像を持ち運ぶことができます。

前提条件

1. 共有AR(Shared AR) Unity プロジェクトが必要です。
2. このコードはUnityの Netcode for Game Objectsを使用しています。 ルームをセットアップしたら、そのAPIをネットワークに使うことになる。

手順

共有ARプロジェクトで画像のコロカライゼーションを設定する：

1. Hierarchyで XR Origin を選択します。 Inspector ウィンドウで、 Add Componentをクリックし、 Shared Space Managerを追加します。
2. Shared Space Manager の Inspectorのオプション：
   1. ColocalizationType を ImageTrackingColocalizationに設定する。
   2. SharedSpaceManager スクリプトで、イメージトラッキングとルームオプションを追加し、 SharedSpaceManager.StartSharedSpace()に渡します。
3. StartHost() または StartClient() を通常どおり呼び出す。

ヒント

プロジェクトのためにユニークなルーム名を選びたいでしょう。また、全員が同じルームに入らずに複数の同時体験をしたい場合は、セッションごとに異なるルーム名が必要です。 Shared AR Image Tracking サンプルでは、このような理由からPINコードを使用している。

画像を使ってコロカライズする：

1. 共有ルームを特定する画像を選んでください。 サンプル画像は Assets/Samples/SharedAR/IMG-2689.pngにあります。 これは、Shared Space Manager の Target Image プロパティで設定されたイメージと同じである必要があります。
2. 画像をプリントアウトして表面に置く。 画像のサイズは、Shared Space Managerが期待する Target Image Size に合わせる必要があります（このサンプルでは幅9cm）。
3. デバイスのカメラを画像に向ける。 新しい部屋の作成を選択する。

注意

Unityエディターでは、再生時でもイメージトラッキングはサポートされていません。 デバイス上でしか実行できない。

備考

画像を常に画面に表示しておく必要はありません。 体験中にオブジェクトのドリフトに気づいたら、カメラを画像に向けて原点をリセットしてください。

コロカライゼーション・スクリプトの例

public SharedSpaceManager _sharedSpaceManager;

[SerializeField]
private Texture2D _targetImage;

[SerializeField]
private float _targetImageSize;

public void StartSharedSpace(string roomName)
{
    var imageTrackingOptions = ISharedSpaceTrackingOptions.CreateImageTrackingOptions(
                _targetImage, _targetImageSize);
    var roomOptions = ISharedSpaceRoomOptions.CreateLightshipRoomOptions(
        roomName,
        10,
        "image tracking colocalization demo"
    );

    _sharedSpaceManager.StartSharedSpace(imageTrackingOptions, roomOptions);

    // ホストとして開始
    NetworkManager.Singleton.StartHost();
    // またはクライアントとして開始
    // NetworkManager.Singleton.StartClient();
}.