模型轉換錯誤碼
針對模型轉換失敗的常見模式, 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 |
|