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

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

项目
03/10/2023

本快速入门将使用 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 Windows 和 Git LFS。
你需要安装 Unity。有关受支持的版本和所需的功能，请访问 Unity 项目设置页面。

创建空间定位点资源

转到 Azure 门户。

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

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

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

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

使用常规字母数字字符输入唯一的资源名称。
选择想要将资源附加到的订阅。
选择“新建”可创建资源组。将其命名为 myResourceGroup，然后选择“确定” 。

资源组是在其中部署和管理 Azure 资源（例如 Web 应用、数据库和存储帐户）的逻辑容器。例如，可以选择在使用完之后通过一个简单的步骤删除整个资源组。
选择可在其中放置资源的位置（区域）。
选择“创建”开始创建资源。

Screenshot of the Spatial Anchors pane for creating a resource.

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

Screenshot showing that the resource deployment is complete.

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

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

Screenshot of the resource properties pane.

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

Screenshot showing the resource's account domain value.

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

Screenshot of the Keys pane for the account.

首先为 Azure CLI 准备环境：

在 Azure Cloud Shell 中使用 Bash 环境。有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
- 运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

登录后，请使用 az account set 命令来选择要在其中设置空间定位点帐户的订阅：
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
运行 az group create 命令创建资源组或使用现有资源组：
```
az group create --name myResourceGroup --location eastus2
```
资源组是在其中部署和管理 Azure 资源（例如 Web 应用、数据库和存储帐户）的逻辑容器。例如，可以选择在使用完之后通过一个简单的步骤删除整个资源组。

可使用 az spatial-anchors-account list 命令查看资源组的当前空间定位点帐户：
```
az spatial-anchors-account list --resource-group myResourceGroup
```
还可查看订阅的空间定位点帐户：
```
az spatial-anchors-account list
```

运行 az spatial-anchors-account create 命令来创建空间定位点帐户：

az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2

使用 az spatial-anchors-account show 命令查看资源属性：
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
将资源的“帐户 ID”值和资源的“帐户域”值复制到文本编辑器中，供稍后使用。

运行 az spatial-anchors-account key show 命令来获取主密钥和辅助密钥：

az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

将密钥值复制到文本编辑器供稍后使用。

如需重新生成密钥，请使用 az spatial-anchors-account key renew 命令：

az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary

可使用 az spatial-anchors-account delete 命令来删除帐户：

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

首先为 Azure PowerShell 准备环境：

如果选择在本地使用 Azure PowerShell：
- 安装最新版本的 Az PowerShell 模块。
- 使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。
如果选择使用 Azure Cloud Shell：
- 有关详细信息，请参阅 Azure Cloud Shell 概述。

重要

尽管 Az.MixedReality PowerShell 模块为预览版，但你必须使用 Install-Module cmdlet 单独安装它。此 PowerShell 模块正式发布后，它会包含在将来的 Az PowerShell 模块发行版中，并在 Azure Cloud Shell 中默认提供。

Install-Module -Name Az.MixedReality

登录后，请使用 Set-AzContext cmdlet 来选择要在其中设置空间定位点帐户的订阅：
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
运行 New-AzResourceGroup cmdlet 来创建一个资源组，或使用现有资源组：
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
资源组是在其中部署和管理 Azure 资源（例如 Web 应用、数据库和存储帐户）的逻辑容器。例如，可以选择在使用完之后通过一个简单的步骤删除整个资源组。

可使用 Get-AzSpatialAnchorsAccount cmdlet 查看资源组的当前空间定位点帐户：
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
还可查看订阅的空间定位点帐户：
```
Get-AzSpatialAnchorsAccount
```

运行 New-AzSpatialAnchorsAccount cmdlet 创建空间定位点帐户：

New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2

使用 Get-AzSpatialAnchorsAccount cmdlet 查看资源属性：
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
将属性的 accountId 值和属性的 accountDomain 值复制到文本编辑器中，供稍后使用。

运行 Get-AzSpatialAnchorsAccountKey cmdlet 来获取主密钥和辅助密钥：

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

将密钥值复制到文本编辑器供稍后使用。

如果需要重新生成密钥，请使用 New-AzSpatialAnchorsAccountKey cmdlet：

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

可使用 Remove-AzSpatialAnchorsAccount cmdlet 删除帐户：

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

下载示例项目并导入 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 编辑器。

Screenshot of the Unity pane.