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

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

プロジェクトの要件

新しい Unity プロジェクトを開始するときは、Unity XR プラグイン フレームワークと従来の組み込み 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

従来の組み込み XR

従来の組み込み XR は、ASA SDK バージョン 2.8.1 以前でのみサポートされています。 従来の組み込み XR を対象とするには、プラットフォームに応じて、次のパッケージで、Unity 2019.4 (LTS) および AR Foundation 3.1.3 を使用します。

• Windows Mixed Reality: 4.2.1
• ARCore XR プラグイン: 3.1.3
• ARKit XR プラグイン: 3.1.3

プロジェクトの構成

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

ASA バージョンを選ぶ

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

Unity 2020

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 です。

Unity 2019

Unity 2019 の最小サポート バージョンは ASA SDK 2.7.0 です。 Unity 2019 のサポートを提供する最新バージョンは ASA SDK 2.8.1 です。

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>

Mixed Reality Feature Tool

Note

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

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

Web ダウンロード

Unity 用 Azure Spatial Anchors コア パッケージ (com.microsoft.azure.spatial-anchors-sdk.core) は、ここにあります。 目的のバージョンを選択し、 [Download]\(ダウンロード\) ボタンを使用してパッケージをダウンロードします。 この手順を繰り返して、サポート予定のプラットフォームごとにパッケージをダウンロードします。

NPM ダウンロード

次の手順は、NPM がインストール済みであり、使用できることを前提としています。

次のコマンドを実行します。<version_number> は、現在のフォルダーにダウンロードする Azure Spatial Anchors のバージョンに置き換えてください。

npm pack com.microsoft.azure.spatial-anchors-sdk.core@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

Note

入手できる Azure Spatial Anchors パッケージのバージョンを一覧表示するには、次のコマンドを実行します。

npm view com.microsoft.azure.spatial-anchors-sdk.core --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

コマンドを実行したフォルダーに、Azure Spatial Anchors のコア パッケージがダウンロードされます。 この手順を繰り返して、サポート予定のプラットフォームごとにパッケージをダウンロードします。

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

Mixed Reality Feature Tool

この手順では、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 プラグイン - "プラットフォーム サポート" の下にあります

Web ダウンロード

こちらの手順に従い、Unity Package Manager を使用して、ダウンロードした Azure Spatial Anchors パッケージを Unity プロジェクトにインポートします。

NPM ダウンロード

こちらの手順に従い、Unity Package Manager を使用して、ダウンロードした Azure Spatial Anchors パッケージを Unity プロジェクトにインポートします。

追加の構成

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

HoloLens

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

Android

mainTemplate.gradle ファイルを構成する

1. [Edit]\(編集\)>[Project Settings]\(プロジェクト設定\)>[Player]\(プレーヤー\) の順に移動します。

2. [プレーヤー設定] の [インスペクター] パネルで、Android アイコンを選択します。

3. [ビルド] セクションで、[カスタム メイン Gradle テンプレート] チェックボックスをオンにして、Assets\Plugins\Android\mainTemplate.gradle でカスタム Gradle テンプレートを生成します。

4. mainTemplate.gradle ファイルをテキスト エディターで開きます。

5. dependencies セクションに、次の依存関係を貼り付けます。

   implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
   implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
   

すべて完了すると、dependencies セクションは次のようになります。

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
    implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
**DEPS**}

次のステップ

方法: Unity でアンカーを作成して配置する