モデル変換のエラー コード
モデル変換エラーの一般的なモードについては、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 | 指定された倍率が 0 以外の正の値ではありませんでした。 | アセットの変換を開始する際に、アップロードしたアセットの測定単位スケール (メートル単位) に対応するスカラー値を指定します。 |
| 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 | 不明なサービス エラーが発生しました。 | 問題が解消しない場合は、Object Anchors サービス チームに GitHub の issue を提出してください。 |
| ASSET_CANNOT_BE_CONVERTED | 指定されたアセットが破損しているか、その形式に誤りがあるか、その指定の形式では変換できませんでした。 | アセットが、指定された種類の有効に作成されたファイルであることを確認してください。 変換対象のアセットを送信する前に、アセット サイズのガイドラインを遵守していることを確認してください。 |
例外エラー
実際のアセット変換ジョブの外で発生したエラーはすべて、例外としてスローされます。 中でも、サービス呼び出しで不成功の HTTP 応答コード (4xx または 5xx) や予期しない HTTP 応答コードが返された場合にスローされることのある Azure.RequestFailedException が代表的です。 これらの例外の詳細については、その例外の Status、ErrorCode、Message フィールドを調査してください。
| 例外 | 原因 |
|---|---|
| ArgumentException |
|
| ArgumentNullException |
|
| RequestFailedException |
|
| UnsupportedAssetFileTypeException |
|