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

快速入门：从 3D 模型创建 Object Anchors 模型

项目
06/01/2023

Azure Object Anchors 是一项托管的云服务，它将 3D 模型转换为 AI 模型，以便为 HoloLens 启用对象感知混合现实体验。此快速入门介绍如何使用适用于 .NET 的 Azure Object Anchors 转换 SDK 从 3D 模型创建 Object Anchors 模型。

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

创建 Object Anchors 帐户。
使用适用于 .NET 的 Azure Object Anchors 转换 SDK (NuGet) 转换 3D 模型以创建 Object Anchors 模型。

先决条件

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

已安装 Visual Studio 2022 的 Windows 计算机。
适用于 Windows 的 Git。
.NET 6.0 SDK。

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

创建 Object Anchors 帐户

首先，需要创建一个 Object Anchors 服务帐户。

转到 Azure 门户，然后选择“创建资源”。
搜索“Object Anchors”资源。

搜索“Object Anchors”。

在搜索结果中的“Object Anchors”资源中，选择“创建”->“Object Anchors”。
在“Object Anchors 帐户”对话框中：
- 输入唯一的资源名称。
- 选择要将资源附加到的订阅。
- 创建资源组或使用现有资源组。
- 选择希望资源所在的区域。
选择“创建”开始创建资源。
创建资源后，选择“转到资源”。
在“概述”页面上：

记下帐户域。稍后需要用到此信息。

记下帐户 ID。稍后需要用到此信息。

转到“访问密钥”页，并记下主密钥。稍后需要用到此信息。

获取示例项目

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

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

cd ./azure-object-anchors

转换 3D 模型

现在，可以继续转换 3D 模型。

在 Visual Studio 中打开 quickstarts/conversion/Conversion.sln。此解决方案包含一个 C# 控制台项目。

打开位于项目根目录中的 Configuration.cs 文件，并替换以下字段的 set-me 值：

字段	说明
AccountDomain	上面创建的 Object Anchors 帐户的帐户域。
AccountId	上面创建的 Object Anchors 帐户的帐户 ID。
AccountKey	上面创建的 Object Anchors 帐户的帐户密钥

除此之外，还需要验证以下四个字段：

字段	说明
InputAssetPath	本地计算机上 3D 模型的绝对路径。支持的文件格式为 `fbx`、`ply`、`obj` 和 `glb`。
AssetDimensionUnit	3D 模型的度量单位。所有支持的度量单位都可以使用 `Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit` 枚举进行访问。
引力	3D 模型的重力向量方向。此 3D 向量给出了模型坐标系中的向下方向。例如，如果负数 `y` 表示模型的 3D 空间中的向下方向，则此值为 `Vector3(0.0f, -1.0f, 0.0f)`。
DisableDetectScaleUnits	从 Azure.MixedReality.ObjectAnchors.Conversion `0.3.0-beta.6` 开始，默认情况下会使用嵌入式缩放单元（如果适用于 `fbx` 文件）。可以通过将值设置为 `true` 来禁用此行为。对于 `fbx` 以外的文件格式，将忽略此选项。

生成并运行项目以上传 3D 模型，向服务注册新的转换作业，并等待其完成。完成该作业后，将在 InputAssetPath 中指定的文件旁边下载 Object Anchors 模型。你应会看到类似于下面的控制台输出：

 Asset   : ***********
 Gravity : ***********
 Unit    : ***********
 Attempting to upload asset...
 Attempting to create asset conversion job...
 Successfully created asset conversion job. Job ID: ***********
 Waiting for job completion...

 Asset conversion job completed successfully.
 Attempting to download result as '***********'...
 Success!

记下作业 ID 以供将来参考。调试或排查故障时，这可能很有用。

成功完成作业后，你应该会在指定的输出位置看到一个格式为 <Model-Filename-Without-Extension>_<JobID>.ou 的文件。例如，如果你的 3D 模型文件名为 chair.ply，而你的作业 ID 为 00000000-0000-0000-0000-000000000000，则服务输出的文件名将为 chair_00000000-0000-0000-0000-000000000000.ou。