設定 Azure Spatial Anchors 供 Unity 專案使用

發行項
03/05/2024

本指南將會說明如何在 Unity 專案中開始使用 Azure Spatial Anchors SDK。

專案需求

啟動新的 Unity 專案時，您可以選擇 Unity XR 外掛程式架構和舊版內建 XR。

XR 外掛程式架構
舊版內建 XR

只有 ASA SDK 2.9.0 以上版本支援 XR 外掛程式架構。若要以 XR 外掛程式架構為目標，請根據您的平台，使用 Unity 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
Unity 2019

ASA SDK 2.9.0 已新增對 Unity 2020 的支援。建議您為 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>`

注意

混合實境功能工具目前僅支援 Windows。

繼續至下個步驟。您會在稍後的步驟中使用 Mixed Reality 功能工具。

下列步驟皆假設 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/

注意

若要列出 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 套件

此步驟需要下載混合實境功能工具並可供使用。

遵循混合實境功能工具文件來設定工具，並了解如何使用此工具。
安裝
1. Azure Spatial Anchors SDK Core
2. Azure Spatial Anchors SDK (選擇<您的平台>適用的版本)
3. Mixed Reality OpenXR 外掛程式 (如果您使用 OpenXR 的話，該外掛程式位於 [平台支援] 下方)

額外設定

如果您要針對 HoloLens 或 Android 進行開發，請遵循下列其他設定步驟。

HoloLens
Android

設定 Unity 專案 XR 設定

在 HoloLens 上開發 MixedReality 應用程式時，您必須在 Unity 中完成 XR 設定。如需詳細資訊，請參閱完成 XR 設定 - Mixed Reality | Microsoft Docs 及選擇 Unity 版本和 XR 外掛程式 - Mixed Reality | Microsoft Docs。

Azure Spatial Anchors SDK 2.9.0 以下版本僅支援 Windows XR 外掛程式 (com.unity.xr.windowsmr)，因此 Azure Spatial Anchors Windows 套件與 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 功能可能會導致查詢錨點失敗。

設定 mainTemplate.gradle 檔案

移至 [編輯]>[專案設定]>[播放器]。
在 [播放程式設定] 的 [偵測器面板] 中，選取 Android 圖示。
在 [組建] 區段底下，勾選 [自訂主要 Gradle 範本] 核取方塊，以在 Assets\Plugins\Android\mainTemplate.gradle 產生自訂的 Gradle 範本。
在文字編輯器中開啟您的 mainTemplate.gradle 檔案。

在 [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 中建立及尋找錨點