你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
模型转换错误代码
为了反映模型转换失败的常见模式，从 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionOperation 中的 Value 字段获取的 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionProperties 对象包含了一个类型为 ConversionErrorCode 的 ErrorCode 字段。
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。 有关这些异常的更多详细信息，请检查异常的 Status、ErrorCode 或 Message 字段。
| Exception | 原因 |
|---|---|
| ArgumentException |
|
| ArgumentNullException |
|
| RequestFailedException |
|
| UnsupportedAssetFileTypeException |
|