你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn 。
运行示例应用：Android - Unity (C#)
本文内容
本快速入门介绍如何使用 Unity (C#) 为 Android 设备运行 Azure 空间定位点 示例应用。 Azure 空间定位点是一种跨平台开发人员服务。通过该服务，可以使用能够随时间推移跨设备保存自己位置的对象创建混合的现实体验。 完成后，将获得一个使用 Unity生成的 ARCore Android 应用，该应用可以保存和重新调用空间定位点。
将了解如何执行以下操作：
创建空间定位点帐户
准备 Unity 生成设置
配置空间定位点帐户标识符和帐户密钥
导出 Android Studio 项目
在 Android 设备上部署和运行
如果没有 Azure 订阅 ，请在开始之前创建一个 Azure 免费帐户 。
先决条件
若要完成本快速入门，请确保具备以下项：
支持开发人员 和 ARCore 功能 的 Android 设备。
你的计算机可能需要其他设备驱动程序才能与 Android 设备通信。 有关其他详细信息和说明，请参阅此处 。
Windows 或 macOS 计算机。
如果在 Windows 上运行，则还需要 Git for Windows 和 Git LFS 。
如果在 macOS 上运行，请通过 HomeBrew 安装 Git。 在终端的一行中输入以下命令：/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"。 然后，运行 brew install git 和 brew install git-lfs。
Unity 安装，包括 Android 版本支持Unity 项目设置页面 。
创建空间定位点资源
转到 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
下载示例项目并导入 SDK
克隆示例存储库
通过运行以下命令克隆示例存储库 ：
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
导入 ASA SDK
按照此处 的说明下载并导入 Android 平台所需的 ASA SDK 包。
在 Unity 中，打开 Unity 文件夹中的项目。 Unity 可能会提示项目使用的版本和计算机上安装的版本有所不同。 只要你的 Unity 编辑器版本比创建项目时所用的版本新，就可以忽略这个警告。 如果你的版本较新，请选择“继续”。 如果你的版本比项目所需的版本旧，请选择“退出”，并升级 Unity 编辑器。
通过选择“文件”>“生成设置”，打开“生成设置”。
在“平台”部分中，选择“Android”，然后选择“切换平台”将平台更改为 Android 。 Unity 可能会提示你安装 Android 支持组件（若缺少这些组件）。
关闭“生成设置”窗口 。
接下来是将应用配置为使用你的帐户信息。 你之前已在“创建空间定位点资源” 部分中，将“帐户密钥”、“帐户 ID”和“帐户域”值复制到文本编辑器中 。
在“项目”窗格中，转到 Assets\AzureSpatialAnchors.SDK\Resources。
选择“SpatialAnchorConfig”。 在“检查器”窗格中，输入 Account Key 作为“空间定位点帐户密钥”的值，输入 Account ID 作为“空间定位点帐户 ID”的值，然后输入 Account Domain 作为“空间定位点帐户域”的值 。
导出 Android Studio 项目
通过选择“文件”>“生成设置”，打开“生成设置” 。
在“生成中的场景”
在“运行设备”中选择你的设备，然后选择“生成并运行” 。 系统将要求你保存 .apk 文件，你可为它选取任何名称。
在应用中，使用箭头选择“BasicDemo”，然后按“开始!”按钮以运行演示。 按说明放置并重新调用定位点。
按照应用中的说明，放置并重新调用定位点。
疑难解答
呈现问题
运行应用时，如果没看到作为背景的照相机（例如，你看到的是空白、蓝色或其他纹理），则可能需要重新导入 Unity 中的资产。 停止应用。 在 Unity 中的顶部菜单中，选择“资产”->“重新导入全部”。 然后再次运行应用。
清理资源
在前面的步骤中，你在资源组中创建了 Azure 资源。 如果将来不再需要这些资源，可以通过删除资源组来删除它们。
从 Azure 门户菜单或“主页”页上，选择“资源组” 。 然后，在“资源组”页上，选择“myResourceGroup” 。
在“myResourceGroup”页中，确保列出的资源是要删除的资源。
选择“删除资源组” ，在文本框中键入“myResourceGroup” 以确认，然后选择“删除” 。
后续步骤
在本快速入门中，你已创建空间定位点帐户。 然后，你配置并部署了应用来保存和重新调用空间定位点。 要详细了解如何改进应用使其可以与其他设备共享空间定位点，请继续学习下一个教程。
