本文へスキップ
バージョン： 3.6

ネットコードで画像追跡コロカライゼーションを使用する方法

SharedAR Image Tracking パネル

コロカライゼーションとは、共有ARセッションで複数のプレイヤーが同じ仮想オブジェクトを見ることを可能にするプロセスである。 画像トラッキング・コローカライゼーションを使えば、VPS-Activated Locationを使わなくても、画像を起点として共有AR体験をトリガーすることができます。 イメージトラッキングを使えば、印刷したイメージを持ち運び、アプリケーションをテストしたい場所に配置することができます。

備考

Image Tracking Colocalizationは、スクリーン上の画像を使ったローカライズはサポートしていません。 プリントアウトするか、そうでなければ現実の世界で見つける必要がある。

前提条件​

  1. ARDKをインストールしたUnityプロジェクトと、基本的なARシーンが必要です。 詳しくは、Lightship ARDKのセットアップと ARシーンのセットアップを参照してください。
  2. ARシーンにはShared ARとNetcodeも必要です。 Image Tracking Colocalizationを使用するには、SharedSpaceManagerの Colocalization Typeが Image Colocalizationに設定されていることを確認してください。 SharedAR Image Tracking パネル

画像トラッキングの設定​

共有ARプロジェクトに参照画像を追加することで、画像追跡コロカライゼーションのためのスクリプトでその画像をターゲットにすることができます。

プロジェクトにイメージトラッキングを追加するには

  1. 階層で、NetworkDemoManager の名前をImageColocalizationDemoManager に変更する。

  2. 共有ARルームに関連付ける画像を選択します。

  3. 階層で、ImageColocalizationDemoManager を選択し、インスペクタで、Target ImageとTarget Image Sizeプロパティを、選択した画像に合わせて設定します。

  4. ImageColocalizationDemoManagerのスクリプトファイルを開き、次のコード・スニペットを追加して、ローカライズ画像への参照を作成します：

    [SerializeField]
    private Texture2D _targetImage;

    [SerializeField]
    private float _targetImageSize;

  5. ローカライズに使用したい画像をプリントアウトする。 画像のサイズは、ImageColocalizationDemoManagerで設定したターゲット画像サイズと一致させる必要があります。 SharedAR Image Tracking パネル

  6. ImageColocalizationDemoManagerスクリプトのStart()関数の内容を以下のコード・スニペットで置き換える：

    var imageTrackingOptions = ISharedSpaceTrackingOptions.CreateImageTrackingOptions(
                _targetImage, _targetImageSize);
    var roomOptions = ISharedSpaceRoomOptions.CreateLightshipRoomOptions(
        "ImageTrackingDemoRoom",
        32, // 最大収容人数
        "image tracking colocalization demo"
    );

    _sharedSpaceManager.StartSharedSpace(imageTrackingOptions, roomOptions);

これが終われば、プロジェクトはイメージトラッキングを使ったコロカライズの準備が整うはずだ。 デバイスにビルドし、アプリケーションを実行してテストする。

画像トラッキングのためのテストのヒント​

  • イメージトラッキングをテストするには、ローカライズイメージの印刷物が必要です。 印刷したターゲット画像を平らな面に置き、デバイスのカメラを画像に向けてコロカライズする。 イメージのトラッキングが完了すると、Join As HostとJoin As Clientボタンが表示されます。
  • 一度ローカライズしたら、画像を画面に表示し続ける必要はありません。 体験中に物体が漂い始めたら、もう一度カメラを画像に向けて原点をリセットする。
  • プロジェクトのために部屋を作るとき、各部屋がセッションごとにユニークな名前を持っていることを確認してください。 これにより、プレイヤーは別々の共有ARルームで複数の体験を同時に行うことができます。 このため、Shared AR Image TrackingのサンプルではPINを使用している。

次のステップ​

マルチプレイヤーエクスペリエンスに共有バーチャルオブジェクトを追加する方法については、共有オブジェクトを表示する方法を参照してください。

共有ARの一般的な問題とデバッグの提案については、共有ARのデバッグとトラブルシューティングの方法を参照してください。