你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Unity 项目中配置 Azure 空间定位点

项目
06/01/2023

本指南介绍如何在 Unity 项目中开始使用 Azure 空间定位点 SDK。

项目要求

启动新的 Unity 项目时，可选择使用 Unity XR 插件框架或旧版内置 XR。

XR 插件框架
旧版内置 XR

XR 插件框架仅在 ASA SDK 2.9.0 或更高版本上受支持。若要面向 XR 插件框架，请根据平台将 Unity 2020.3 (LTS) 和 AR Foundation 4.1.7 与以下包一起使用：

混合现实 OpenXR 插件：1.1.2
Windows XR 插件：4.5.0
ARCore XR 插件：4.1.7
ARKit XR 插件：4.1.7

配置项目

在将 Azure 空间定位点 SDK 添加到 Unity 项目之前，请确保通过 Unity 包管理器安装所需的包。

选择 ASA 版本

若要确定在 Unity 项目中使用哪个 ASA SDK 版本，请在下面选择你的 Unity 版本。

Unity 2020
Unity 2019

ASA SDK 2.9.0 添加了对 Unity 2020 的支持。建议使用最新的 ASA SDK 进行 Unity 2020 开发。

重要

如果使用混合现实 OpenXR 插件，则 ASA SDK 2.10.0 是支持的最低版本。如果使用的是 Windows XR 4.5.1 或更高版本，则 ASA SDK 2.11.0 是支持的最低版本。

下载 ASA 包

下一步是下载适用于 Unity 的 Azure 空间定位点包。

若要在 Unity 中使用 Azure 空间定位点，你将需要下载核心包 (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。

继续执行下一步。在稍后的步骤中将使用混合现实功能工具。

以下步骤假定 NPM 已安装并且可用。

运行以下命令，将 <version_number> 替换为要下载到当前文件夹的 Azure 空间定位点的版本：

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 空间定位点包的可用版本，请运行以下命令：

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 空间定位点核心包将下载到运行命令的文件夹。重复此步骤，为你计划支持的每个平台下载包。

导入 ASA 包

此步骤要求混合现实功能工具已下载并且可用。

按照混合现实功能工具文档来设置工具，并了解如何使用该工具。
安装
1. Azure 空间定位点 SDK 核心版
2. 适用于 <你的平台> 的 Azure 空间定位点 SDK
3. 混合现实 OpenXR 插件（如果使用 OpenXR）- 位于“平台支持”下

额外配置

如果要针对 HoloLens 或 Android 进行开发，请遵循以下额外的设置步骤

HoloLens
Android

配置 Unity 项目 XR 设置

在 HoloLens 上开发 MixedReality 应用时，需要在 Unity 中设置 XR 配置。有关详细信息，请参阅设置 XR 配置 - 混合现实 | Microsoft Docs 和选择 Unity 版本和 XR 插件 - 混合现实 | Microsoft Docs。

Azure 空间定位点 SDK 2.9.0 或更低版本仅提供对 Windows XR 插件 (com.unity.xr.windowsmr) 的支持，因此 Azure 空间定位点 Windows 包显式依赖于 Windows XR 插件。

Azure 空间定位点 SDK 2.10.0 或更高版本提供对混合现实 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 中创建并找到定位点

通过