你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn 。
运行示例应用:HoloLens - Visual Studio (C++/WinRT)
本文内容
本快速入门介绍如何使用 Visual Studio(C++/WinRT 和 DirectX)运行 HoloLens 的 Azure 空间定位点 示例应用。 Azure 空间定位点是一种跨平台开发人员服务。通过该服务,可以使用能够随时间推移跨设备保存自己位置的对象创建混合的现实体验。 完成后,将获得一个 HoloLens 应用,该应用可以保存和重新调用空间定位点。
将了解如何执行以下操作:
创建空间定位点帐户
配置空间定位点帐户标识符和帐户密钥
在 HoloLens 设备上部署和运行
如果没有 Azure 订阅 ,请在开始之前创建一个 Azure 免费帐户 。
先决条件
若要完成本快速入门,请确保具备以下项:
创建空间定位点资源
转到 Azure 门户 。
在左窗格中,选择“创建资源”。
使用搜索框以搜索“空间定位点”。
选择“空间定位点”,然后选择“创建” 。
在“空间定位点帐户”窗格中,执行以下操作:
创建资源后,Azure 门户显示部署已完成。
选择“转到资源”。 你现在可以查看资源属性。
将资源的“帐户 ID”值复制到文本编辑器中,供稍后使用。
另外,将资源的“帐户域”值复制到文本编辑器中,供稍后使用。
在“设置”下,选择“访问密钥” 。 将“帐户密钥”的“主密钥”值复制到文本编辑器中,供稍后使用 。
首先为 Azure CLI 准备环境:
登录后,请使用 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:
如果选择使用 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 aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
运行 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
打开示例项目
通过运行以下命令克隆示例存储库 :
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
在 Visual Studio 中打开 HoloLens\DirectX\SampleHoloLens.sln
。
下一步是将应用程序配置为使用帐户标识符和帐户密钥。 在设置空间定位点资源 时,将它们复制到文本编辑器中。
打开 HoloLens\DirectX\SampleHoloLens\ViewController.cpp
。
找到 SpatialAnchorsAccountKey
字段并将 Set me
替换为帐户密钥。
找到 SpatialAnchorsAccountId
字段并将 Set me
替换为帐户标识符。
找到 SpatialAnchorsAccountDomain
字段并将 Set me
替换为帐户域。
将应用部署到 HoloLens
将“解决方案配置”更改为“发布”,将“解决方案平台”更改为 x86,并从部署目标选项中选择“设备” 。
如果使用 HoloLens 2,请使用“ARM64”作为“解决方案平台”,而不是“x86” 。
打开 HoloLens 设备,登录并使用 USB 电缆将其连接到电脑。
选择“调试”>“开始调试”以部署应用并开始调试 。
按照应用中的说明,放置并重新调用定位点。
在 Visual Studio 中,通过选择“停止调试”或按“Shift+F5”停止应用 。
清理资源
在前面的步骤中,你在资源组中创建了 Azure 资源。 如果将来不再需要这些资源,可以通过删除资源组来删除它们。
从 Azure 门户菜单或“主页”页上,选择“资源组” 。 然后,在“资源组”页上,选择“myResourceGroup” 。
在“myResourceGroup”页中,确保列出的资源是要删除的资源。
选择“删除资源组” ,在文本框中键入“myResourceGroup” 以确认,然后选择“删除” 。
后续步骤
在本快速入门中,你已创建空间定位点帐户。 然后,你配置并部署了应用来保存和重新调用空间定位点。 要详细了解如何改进应用使其可以与其他设备共享空间定位点,请继续学习下一个教程。