Share via


Unity プロジェクトでの Azure Spatial Anchors の構成

このガイドでは、Unity プロジェクトで Azure Spatial Anchors SDK の使用を開始する方法について説明します。

プロジェクトの要件

新しい Unity プロジェクトを開始するときは、Unity XR プラグイン フレームワークと従来の組み込み XR のいずれかを選択できます。

XR プラグイン フレームワークは、ASA SDK バージョン 2.9.0 以降でのみサポートされています。 XR プラグインフレームワークを対象とするには、プラットフォームに応じて、次のパッケージで、2020.3 (LTS)、および AR Foundation 4.1.7 を使用します。

  • Mixed Reality OpenXR プラグイン: 1.1.2
  • Windows XR プラグイン: 4.5.0
  • ARCore XR プラグイン: 4.1.7
  • ARKit XR プラグイン: 4.1.7

プロジェクトの構成

Unity プロジェクトに Azure Spatial Anchors SDK を含める前に、必ず Unity パッケージ マネージャーを使用して必要なパッケージをインストールしてください。

ASA バージョンを選ぶ

Unity プロジェクトで使う ASA SDK のバージョンを決定するには、以下から Unity のバージョンを選んでください。

Unity 2020 のサポートは、ASA SDK 2.9.0 で追加されました。 Unity 2020 の開発には、最新の ASA SDK を使うことをお勧めします。

重要

Mixed Reality OpenXR プラグインを使用している場合は、ASA SDK 2.10.0 がサポートされている最小バージョンです。 Windows XR 4.5.1 以降を使っている場合、最小サポート バージョンは ASA SDK 2.11.0 です。

ASA パッケージのダウンロード

次の手順は、Unity 用 Azure Spatial Anchors パッケージのダウンロードです。

Unity で Azure Spatial Anchors を使うには、コア パッケージ (com.microsoft.azure.spatial-anchors-sdk.core) と、サポート予定のプラットフォームごとにプラットフォーム固有のパッケージ両方をダウンロードする必要があります。

プラットフォーム 必要なパッケージの名前
HoloLens com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS com.microsoft.azure.spatial-anchors-sdk.core@<version_number>
com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

Note

現在、Mixed Reality Feature Tool は Windows のみをサポートしています。

次の手順に進みます。 後の手順で、Mixed Reality Feature Tool を使用します。

ASA パッケージのインポート

この手順では、Mixed Reality Feature Tool をダウンロードして使用できるようにする必要があります。

  1. Mixed Reality Feature Tool のドキュメントに従ってツールを設定し、使用方法を確認してください。
  2. をインストールする
    1. Azure Spatial Anchors SDK Core
    2. <プラットフォーム> 用 Azure Spatial Anchors SDK
    3. OpenXR を使っている場合は Mixed Reality OpenXR プラグイン - "プラットフォーム サポート" の下にあります

追加の構成

HoloLens または Android 用に開発している場合は、次の追加のセットアップ手順に従ってください

Unity プロジェクトの XR 設定を構成する

HoloLens で複合現実アプリを開発する場合、Unity で XR 構成を設定する必要があります。 詳細については、「XR 構成の設定 - 混合現実 | Microsoft Docs」と「Unity バージョンと XR プラグインの選択 - 混合現実 | Microsoft Docs」を参照してください。

Azure Spatial Anchors SDK バージョン 2.9.0 以前では、Windows XR プラグイン (com.unity.xr.windowsmr) のみがサポートされています。そのため、Azure Spatial Anchors ウィンドウ パッケージは Windows XR プラグインに明示的に依存します。

Azure Spatial Anchors SDK バージョン 2.10.0 以降では、Mixed Reality OpenXR プラグイン (com.microsoft.mixedreality.openxr) と Windows XR プラグイン com.unity.xr.windowsmr の両方がサポートされます。 選択に応じて、com.microsoft.mixedreality.openxr パッケージか com.unity.xr.windowsmr パッケージのいずれかをプロジェクトに含める必要があります。

Unity プロジェクトの機能を構成する

Unity プロジェクトでは、次の機能を必ず有効にしてください。

  • SpatialPerception
  • InternetClient
  • PrivateNetworkClientServer

警告

PrivateNetworkClientServer 機能を有効にしないと、プライベートに構成されているネットワークがデバイスで使用されている場合に、アンカーのクエリが失敗する可能性があります。