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

运行示例应用:HoloLens - Unity (C#)

本快速入门将使用 Unity (C#) 为 HoloLens 运行 Azure 空间定位点示例应用。 空间定位点是一种跨平台开发者开发人员服务。通过该服务,可以使用能够随时间推移跨设备保存自己位置的对象创建混合的现实体验。 完成后,将获得一个使用 Unity 生成的 HoloLens 应用,该应用可以保存和重新调用空间定位点。

将了解如何执行以下操作:

  • 创建空间定位点帐户。
  • 准备 Unity 生成设置。
  • 配置空间定位点帐户标识符和帐户密钥。
  • 导出 HoloLens Visual Studio 项目。
  • 部署应用并在 HoloLens 上运行应用。

如果没有 Azure 订阅,请在开始之前创建一个 Azure 免费帐户

先决条件

完成本快速入门教程需要:

  • 你需要有启用了开发人员模式的 HoloLens 设备。 对于 HoloLens 2,设备上必须安装 Windows 10 2020 年 5 月更新或更高版本。 若要在 HoloLens 上更新为最新版本,请打开“设置”应用,转到“更新和安全”,然后选择“检查更新”
  • 你需要有安装了 Visual Studio 2019 或更高版本的 Windows 计算机。 Visual Studio 安装必须包括“通用 Windows 平台开发” 工作负载和 Windows 10 SDK(10.0.18362.0 或更高版本) 组件。 还必须安装 Git for WindowsGit LFS
  • 你需要安装 Unity。 有关受支持的版本和所需的功能,请访问 Unity 项目设置页面

创建空间定位点资源

转到 Azure 门户

在左窗格中,选择“创建资源”。

使用搜索框以搜索“空间定位点”。

显示空间定位点搜索结果的屏幕截图。

选择“空间定位点”,然后选择“创建” 。

在“空间定位点帐户”窗格中,执行以下操作:

  • 使用常规字母数字字符输入唯一的资源名称。

  • 选择想要将资源附加到的订阅。

  • 选择“新建”可创建资源组。 将其命名为 myResourceGroup,然后选择“确定” 。

    资源组是在其中部署和管理 Azure 资源(例如 Web 应用、数据库和存储帐户)的逻辑容器。 例如,可以选择在使用完之后通过一个简单的步骤删除整个资源组。

  • 选择可在其中放置资源的位置(区域)。

  • 选择“创建”开始创建资源。

用于创建资源的“空间定位点”窗格的屏幕截图。

创建资源后,Azure 门户显示部署已完成。

显示资源部署已完成的屏幕截图。

选择“转到资源”。 你现在可以查看资源属性。

将资源的“帐户 ID”值复制到文本编辑器中,供稍后使用。

“资源属性”窗格的屏幕截图。

另外,将资源的“帐户域”值复制到文本编辑器中,供稍后使用。

显示资源的帐户域值的屏幕截图。

在“设置”下,选择“访问密钥” 。 将“帐户密钥”的“主密钥”值复制到文本编辑器中,供稍后使用 。

帐户的“密钥”窗格的屏幕截图。

下载示例项目并导入 SDK

克隆示例存储库

通过运行以下命令克隆示例存储库

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

导入 ASA SDK

按照此处的说明下载并导入 HoloLens 平台所需的 ASA SDK 包。

配置 Unity

在 Unity 中,打开 Unity 文件夹中的项目。 Unity 可能会提示项目使用的版本和计算机上安装的版本有所不同。 只要你的 Unity 编辑器版本比创建项目时所用的版本新,就可以忽略这个警告。 如果你的版本较新,请选择“继续”。 如果你的版本比项目所需的版本旧,请选择“退出”,并升级 Unity 编辑器。

Unity 窗格的屏幕截图。

通过选择“文件”>“生成设置”,打开“生成设置” 。

在“平台”部分中,选择“通用 Windows 平台” 。 将“目标设备”更改为“HoloLens” 。

选择“切换平台”,将平台更改为“通用 Windows 平台” 。 Unity 可能会提示你安装 UWP 支持组件(若缺少这些组件)。

“Unity 生成设置”窗格的屏幕截图 - HoloLens

关闭“生成设置”窗口 。

配置帐户信息

接下来是将应用配置为使用你的帐户信息。 你之前已在“创建空间定位点资源”部分中,将“帐户密钥”、“帐户 ID”和“帐户域”值复制到文本编辑器中 。

在“项目”窗格中,转到 Assets\AzureSpatialAnchors.SDK\Resources

选择“SpatialAnchorConfig”。 在“检查器”窗格中,输入 Account Key 作为“空间定位点帐户密钥”的值,输入 Account ID 作为“空间定位点帐户 ID”的值,然后输入 Account Domain 作为“空间定位点帐户域”的值 。

导出 HoloLens Visual Studio 项目

通过选择“文件”>“生成设置”,打开“生成设置” 。

在“生成中的场景”下,确保所有场景旁边都有复选标记。

选择“生成” 。 在对话框中,选择一个文件夹,在其中导出 HoloLens Visual Studio 项目。

导出完成后,将显示包含导出的 HoloLens 项目的文件夹。

部署 HoloLens 应用程序

在文件夹中,双击 HelloAR U3D.sln 以在 Visual Studio 中打开项目 。

将“解决方案配置”更改为“发布”,将“解决方案平台”更改为 x86,并从部署目标选项中选择“设备” 。

如果使用 HoloLens 2,请使用“ARM64”作为“解决方案平台”,而不是“x86” 。

Visual Studio 配置

打开 HoloLens 设备,登录并使用 USB 电缆将设备连接到电脑。

选择“调试”>“开始调试”以部署应用并开始调试 。

在应用中,使用箭头选择“BasicDemo”,然后按“开始!”按钮以运行演示。 按说明放置并重新调用定位点。

屏幕截图 1屏幕截图 2屏幕截图 3屏幕截图 4

在 Visual Studio 中,选择“停止调试”或 Shift+F5 停止应用 。

清理资源

在前面的步骤中,你在资源组中创建了 Azure 资源。 如果将来不再需要这些资源,可以通过删除资源组来删除它们。

从 Azure 门户菜单或“主页”页上,选择“资源组” 。 然后,在“资源组”页上,选择“myResourceGroup” 。

在“myResourceGroup”页中,确保列出的资源是要删除的资源。

选择“删除资源组” ,在文本框中键入“myResourceGroup” 以确认,然后选择“删除” 。

后续步骤

在本快速入门中,你已创建空间定位点帐户。 然后,你配置并部署了应用来保存和重新调用空间定位点。 要详细了解如何改进应用使其可以与其他设备共享空间定位点,请继续学习下一个教程。