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

模型转换错误代码

为了反映模型转换失败的常见模式,从 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionOperation 中的 Value 字段获取的 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionProperties 对象包含了一个类型为 ConversionErrorCodeErrorCode 字段。

ConversionErrorCode 类型枚举以下常见模型转换失败模式。 这些枚举适用于错误消息本地化、故障恢复以及针对用户的有关如何更正错误的提示。

错误代码 说明 缓解措施
INVALID_ASSET_URI 找不到启动转换作业时提供的 URI 处的资产。 触发资产转换作业时,提供从服务处获取的上传 URI(已将要转换的资产上传到该服务)。
INVALID_JOB_ID 为资产转换作业提供的 ID 已设置为默认的全零 GUID。 如果在创建资产转换作业时指定了 GUID,请确保它不是默认的全零 GUID。
INVALID_GRAVITY 创建资产转换作业时提供的重力矢量是一个完全归零的矢量。 开始资产转换时,提供与上传资产对应的重力矢量。
INVALID_SCALE 提供的比例因子不是非零正值。 开始资产转换时,请提供与已上传资产的度量单位比例相对应的标量值(相对于米)。
ASSET_SIZE_TOO_LARGE 通过资产或其序列化等效项生成的中间 PLY 文件太大。 在提交资产进行转换之前,请确保符合资产大小准则
ASSET_DIMENSIONS_OUT_OF_BOUNDS 资产维度超出了物理维度限制。 此错误可能是创建作业时资产规模设置不当的迹象。 检查 AssetConversionProperties 对象中的 ScaledAssetDimensions 属性。 此属性包含应用比例后计算的资产的实际维度(以米为单位)。 然后,请在提交资产进行转换之前确保符合资产大小准则。 确保提供的比例对应于上传的资产。
ZERO_FACES 通过资产生成的中间 PLY 文件被判定为不包含面,因此它对于转换无效。 确保资产是有效的网格。
INVALID_FACE_VERTICES 通过资产生成的中间 PLY 文件包含引用了不存在的顶点的面。 确保资产文件的构造有效。
ZERO_TRAJECTORIES_GENERATED 通过上传的资产生成的相机轨迹为空。 在提交资产进行转换之前,请确保符合资产大小准则
TOO_MANY_RIG_POSES 中间 PLY 文件中的远程测试机组姿势数量超出了服务限制。 在提交资产进行转换之前,请确保符合资产大小准则
SERVICE_ERROR 发生未知服务错误。 如果问题仍然存在,请将 GitHub 问题提交到 Object Anchors 服务团队
ASSET_CANNOT_BE_CONVERTED 提供的资产已损坏、格式错误或无法以其提供的格式进行转换。 确保资产是指定类型的有效构造文件。 在提交资产进行转换之前确保符合资产大小准则

异常错误

在实际资产转换作业之外发生的任何错误都作为异常来引发。 尤其是,如果服务调用收到不成功的(4xx 或 5xx)或意外 HTTP 响应代码,可能会引发 Azure.RequestFailedException。 有关这些异常的更多详细信息,请检查异常的 StatusErrorCodeMessage 字段。

异常 原因
ArgumentException
  • 使用构造无效的或全零的帐户 ID 通过 ObjectAnchorsConversionClient 构造请求。
  • 尝试使用无效的空白帐户域初始化 ObjectAnchorsConversionClient
  • 通过 ObjectAnchorsConversionClientOptionsObjectAnchorsConversionClient 提供不受支持的服务版本。
ArgumentNullException
  • 尝试使用无效的 null 帐户域初始化 ObjectAnchorsConversionClient
  • 尝试使用无效的 null 凭据初始化 ObjectAnchorsConversionClient
RequestFailedException
  • 由于 HTTP 状态代码错误而导致的所有其他问题,与作业状态无关。 示例包括:找不到帐户、前端检测到无效的上传 URI,或出现前端服务错误。
UnsupportedAssetFileTypeException
  • 使用 Azure Object Anchors 转换服务不支持的扩展或指定 filetype 来提交资产。

后续步骤