模型轉換錯誤碼
針對模型轉換失敗的常見模式， Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionProperties 您從 Value 中的 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionOperation 欄位取得的物件會包含 ErrorCode 類型的欄位 ConversionErrorCode 。
此 ConversionErrorCode 類型會列舉下列常見的模型轉換失敗模式。 這些列舉適用于錯誤訊息當地語系化、失敗復原，以及如何修正錯誤的提示。
| 錯誤碼 | 描述 | 降低 |
|---|---|---|
| INVALID_ASSET_URI | 找不到啟動轉換作業時所提供的 URI 資產。 | 觸發資產轉換作業時，請提供您從上傳要轉換之資產的服務取得的上傳 URI。 |
| INVALID_JOB_ID | 資產轉換作業所提供的識別碼已設定為預設的全零 GUID。 | 如果在建立資產轉換作業時指定 GUID，請確定它不是預設的全零 GUID。 |
| INVALID_GRAVITY | 建立資產轉換作業時所提供的重力向量是完全零的向量。 | 開始資產轉換時，請提供對應至上傳資產的重力向量。 |
| INVALID_SCALE | 提供的縮放比例不是正非零值。 | 開始資產轉換時，提供與所上傳資產公尺的度量單位尺規相對應的純量值。 |
| ASSET_SIZE_TOO_LARGE | 從資產或其序列化對等專案產生的中繼 PLY 檔案太大。 | 在提交資產以進行轉換之前， 請確定符合資產大小指導方針 。 |
| ASSET_DIMENSIONS_OUT_OF_BOUNDS | 資產的維度超過實體維度限制。 此錯誤可能是建立作業時資產設定不當調整的標誌。 | ScaledAssetDimensions檢查 物件 AssetConversionProperties 中的 屬性。 這個屬性包含在套用公尺後計算的資產實際維度。 然後，在提交資產以進行轉換之前，請確定符合 資產大小指導方針 。 請確定提供的縮放比例對應至上傳的資產。 |
| ZERO_FACES | 從資產產生的中繼 PLY 檔案已判斷為沒有臉部，使其無法進行轉換。 | 請確定資產是有效的網格。 |
| INVALID_FACE_VERTICES | 從資產產生的中繼 PLY 檔案包含參考不存在頂點的臉部。 | 請確定資產檔案已正確建構。 |
| ZERO_TRAJECTORIES_GENERATED | 從上傳的資產產生的相機軌跡是空的。 | 在提交資產以進行轉換之前， 請確定符合資產大小指導方針 。 |
| TOO_MANY_RIG_POSES | 中繼 PLY 檔案中的鑽機數目超過服務限制。 | 在提交資產以進行轉換之前， 請確定符合資產大小指導方針 。 |
| SERVICE_ERROR | 發生未知的服務錯誤。 | 如果問題持續發生，請將 GitHub 問題提交至 Object Anchors 服務小組 。 |
| ASSET_CANNOT_BE_CONVERTED | 所提供的資產已損毀、格式不正確，或無法以所提供的格式轉換。 | 請確定資產是指定型別的有效建構檔案。 在提交資產以進行轉換之前， 請確定符合資產大小指導方針 。 |
例外狀況錯誤
在實際資產轉換作業外部發生的任何錯誤都會擲回為例外狀況。 最值得注意的是， Azure.RequestFailedException 對於接收失敗 （4xx 或 5xx） 或非預期的 HTTP 回應碼的服務呼叫，可以擲回 。 如需這些例外狀況的進一步詳細資料，請檢查 Status 例外狀況的 、 ErrorCode 或 Message 欄位。
| 例外狀況 | 原因 |
|---|---|
| ArgumentException |
|
| ArgumentNullException |
|
| RequestFailedException |
|
| UnsupportedAssetFileTypeException |
|