Sdílet prostřednictvím


Kódy chyb převodu modelů

U běžných režimů selhání Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionProperties převodu modelu objekt, který získáte z Value pole v Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionOperation tomto poli, obsahuje ErrorCode pole ConversionErrorCode typu.

Typ ConversionErrorCode vyčíslí následující běžné režimy selhání převodu modelu. Tyto výčty jsou užitečné pro lokalizaci chybových zpráv, obnovení selhání a tipy pro uživatele, jak chybu opravit.

Kód chyby Popis Omezení rizik
INVALID_ASSET_URI Prostředek na identifikátoru URI zadaný při spuštění úlohy převodu nebyl nalezen. Při aktivaci úlohy převodu prostředků zadejte identifikátor URI pro nahrání, který získáte ze služby, kde se prostředek, který se má převést, nahraje.
INVALID_JOB_ID Zadané ID pro úlohu převodu prostředků bylo nastaveno na výchozí celonulový identifikátor GUID. Pokud je při vytváření úlohy převodu prostředků zadaný identifikátor GUID, ujistěte se, že není výchozím celonulovým identifikátorem GUID.
INVALID_GRAVITY Vektor závažnosti poskytnutý při vytváření úlohy převodu prostředků byl plně nulový vektor. Při zahájení převodu aktiv zadejte vektor závažnosti, který odpovídá nahranému prostředku.
INVALID_SCALE Zadaný faktor měřítka nebyl kladnou nenulovou hodnotou. Při zahájení převodu aktiv zadejte skalární hodnotu, která odpovídá měřítku měrných jednotek s ohledem na měřiče nahraného prostředku.
ASSET_SIZE_TOO_LARGE Zprostředkující soubor PLY vygenerovaný z prostředku nebo jeho serializovaného ekvivalentu byl příliš velký. Před předložením aktiva k převodu se ujistěte, že jsou v souladu s pokyny pro velikost majetku.
ASSET_DIMENSIONS_OUT_OF_BOUNDS Dimenze prostředku překročily limit fyzické dimenze. Tato chyba může být znaménkem nesprávně nastaveného škálování prostředku při vytváření úlohy. Zkontrolujte AssetConversionProperties vlastnost v objektuScaledAssetDimensions. Tato vlastnost obsahuje skutečné rozměry aktiva vypočítané po použití měřítka v metrech. Před předložením aktiva k převodu se pak ujistěte, že jsou v souladu s pokyny pro velikost majetku. Ujistěte se, že poskytnuté měřítko odpovídá nahranému prostředku.
ZERO_FACES Zprostředkující soubor PLY vygenerovaný z prostředku byl určen tak, aby neměl žádné tváře, což zneplatňuje převod. Ujistěte se, že je prostředek platným okem.
INVALID_FACE_VERTICES Dočasný soubor PLY vygenerovaný z prostředku obsahoval tváře, na které odkazují neexistující vrcholy. Ujistěte se, že je soubor assetu platný.
ZERO_TRAJECTORIES_GENERATED Trajektorie fotoaparátu vygenerované z nahraného prostředku byly prázdné. Před předložením aktiva k převodu se ujistěte, že jsou v souladu s pokyny pro velikost majetku.
TOO_MANY_RIG_POSES Počet míst v přechodném souboru PLY překročil limity služby. Před předložením aktiva k převodu se ujistěte, že jsou v souladu s pokyny pro velikost majetku.
SERVICE_ERROR Došlo k neznámé chybě služby. Pokud problém přetrvává, zapište problém GitHubu týmu služby Ukotvení objektů.
ASSET_CANNOT_BE_CONVERTED Zadaný prostředek byl poškozený, poškozený nebo jinak nelze převést v zadaném formátu. Ujistěte se, že je prostředek platným souborem zadaného typu. Před předložením aktiva k převodu se ujistěte, že jsou v souladu s pokyny pro velikost majetku.

Chyby výjimek

Všechny chyby, ke kterým dochází mimo skutečné úlohy převodu prostředků, jsou vyvolány jako výjimky. Zejména může být vyvolán pro volání služby, Azure.RequestFailedException která obdrží neúspěšný (4xx nebo 5xx) nebo neočekávaný kód odpovědi HTTP. Další podrobnosti o těchto výjimkách najdete v Statusčásti , ErrorCodenebo Message pole výjimky.

Výjimka Příčina
Argumentexception
  • Použití neplatného vytvořeného nebo all-zero ID účtu k vytvoření požadavku s ObjectAnchorsConversionClient.
  • Pokoušíte se inicializovat ObjectAnchorsConversionClient neplatnou doménu účtu prázdného znaku.
  • Poskytnutí nepodporované verze služby pro ObjectAnchorsConversionClient ObjectAnchorsConversionClientOptions
Argumentnullexception
  • Pokoušíte se inicializovat ObjectAnchorsConversionClient pomocí neplatné domény účtu null.
  • Pokoušíte se inicializovat ObjectAnchorsConversionClient pomocí neplatných přihlašovacích údajů null.
RequestFailedException
  • Všechny ostatní problémy způsobené chybným stavovým kódem HTTP, nesouvisející se stavem úlohy. Mezi příklady patří nenašel se účet, front-end detekuje neplatný identifikátor URI pro nahrání nebo chybu front-endové služby.
Nepodporovaná výjimkaAssetFileTypeException
  • Odeslání prostředku s příponou nebo zadaným typem souboru, který služba Převodu Azure Object Anchors nepodporuje.

Další kroky