unity创建android,快速入门：创建 Unity Android 应用 - Azure Spatial Anchors | Microsoft Docs...

您现在访问的是微软AZURE全球版技术文档网站，若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站，请访问 https://docs.azure.cn.

快速入门：使用 Azure 空间定位点创建 Unity Android 应用

03/18/2021

本文内容

本快速入门介绍如何使用 Azure 空间定位点创建 Unity Android 应用。 Azure 空间定位点是一种跨平台开发人员服务。通过该服务，可以使用能够随时间推移跨设备保存自己位置的对象创建混合的现实体验。 完成后，将获得一个使用 Unity生成的 ARCore Android 应用，该应用可以保存和重新调用空间定位点。

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

创建空间定位点帐户

准备 Unity 生成设置

配置空间定位点帐户标识符和帐户密钥

导出 Android Studio 项目

在 Android 设备上部署和运行

如果还没有 Azure 订阅，可以在开始前创建一个免费帐户。

先决条件

若要完成本快速入门，请确保具备以下项：

已安装 Unity (LTS)(包括 Android 版本支持、Android SDK 和 NDK 工具 以及 OpenJDK 模块)的 Windows 或 macOS 计算机。 使用 ASA SDK 版本 2.9 或更高版本的 Unity 2020 LTS(采用 Unity XR 插件框架)或使用 ASA SDK 版本 2.8 或更早版本的 Unity 2019 LTS。

如果在 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。

支持开发人员和 ARCore 功能的 Android 设备。

你的计算机可能需要其他设备驱动程序才能与 Android 设备通信。 有关其他详细信息和说明，请参阅此处。

创建空间定位点资源

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

首先为 Azure CLI 准备环境：

如果需要，请安装 Azure CLI 来运行 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 --resource-group myResourceGroup

还可查看订阅的空间定位点帐户：

az spatial-anchors-account list

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

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

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

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

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

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 --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 00000000-0000-0000-0000-000000000000

运行 New-AzResourceGroup cmdlet 来创建一个资源组，或使用现有资源组：

New-AzResourceGroup -Name myResourceGroup -Location eastus2

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

Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup

还可查看订阅的空间定位点帐户：

Get-AzSpatialAnchorsAccount

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

Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

将属性的 accountId 值和属性的 accountDomain 值复制到文本编辑器中，供稍后使用 。

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

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

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

下载并打开 Unity 示例项目

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

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

cd ./azure-spatial-anchors-samples

按照此处的说明下载并导入 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” 以确认，然后选择“删除” 。

后续步骤

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