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

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

  • 项目

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

项目要求

启动新的 Unity 项目时，可选择使用 Unity 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 版本。

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。

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

导入 ASA 包

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

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

额外配置

如果要针对 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 功能，则当设备使用配置为专用的网络时，可能会导致查询定位点失败。