Model dönüştürme hata kodları

Model dönüştürme hatasının yaygın modları için içindeki Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionProperties alanından Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionOperation alınan Value nesne türündeki ConversionErrorCode bir ErrorCode alanı içerir.

türü, ConversionErrorCode aşağıdaki yaygın model dönüştürme hatası modlarını numaralandırır. Bu numaralandırmalar hata iletisi yerelleştirme, hata kurtarma ve kullanıcıya hatayı düzeltme ipuçları için yararlıdır.

Hata kodu Tanım Risk azaltma
INVALID_ASSET_URI Dönüştürme işi başlatılırken sağlanan URI'deki varlık bulunamadı. Bir varlık dönüştürme işini tetiklerken, dönüştürülecek varlığın karşıya yüklendiği hizmetten edindiğiniz bir karşıya yükleme URI'sini sağlayın.
INVALID_JOB_ID Varlık dönüştürme işi için sağlanan kimlik varsayılan sıfır guid değerine ayarlandı. Varlık dönüştürme işi oluşturulurken GUID belirtilirse, bunun varsayılan sıfır guid değeri olmadığından emin olun.
INVALID_GRAVITY Varlık dönüştürme işi oluşturulurken sağlanan yerçekimi vektöru tamamen sıfırlanmış bir vektördü. Varlık dönüştürmeyi başlatırken, karşıya yüklenen varlığa karşılık gelen yerçekimi vektörlerini sağlayın.
INVALID_SCALE Sağlanan ölçek faktörü sıfır olmayan pozitif bir değer değildi. Varlık dönüştürmeye başlarken, karşıya yüklenen varlığın ölçüm birimi ölçeğine karşılık gelen skaler değeri ölçümlere göre belirtin.
ASSET_SIZE_TOO_LARGE Varlıktan veya serileştirilmiş eşdeğerinden oluşturulan ara PLY dosyası çok büyük. Dönüştürme için bir varlık göndermeden önce varlık boyutu yönergelerine uyduğundan emin olun.
ASSET_DIMENSIONS_OUT_OF_BOUNDS Varlığın boyutları fiziksel boyut sınırını aştı. Bu hata, iş oluştururken varlık için yanlış ayarlanmış bir ölçeğin işareti olabilir. ScaledAssetDimensions Nesnenizdeki AssetConversionProperties özelliğini inceleyin. Bu özellik, ölçek metre olarak uygulandıktan sonra hesaplanan varlığın gerçek boyutlarını içerir. Ardından, varlığı dönüştürme için göndermeden önce varlık boyutu yönergelerine uyduğundan emin olun. Sağlanan ölçeğin karşıya yüklenen varlığa karşılık olduğundan emin olun.
ZERO_FACES Varlıktan oluşturulan ara PLY dosyasının hiçbir yüzü olmadığı belirlenerek dönüştürme için geçersiz hale getirildi. Varlığın geçerli bir ağ olduğundan emin olun.
INVALID_FACE_VERTICES Varlıktan oluşturulan ara PLY dosyası, var olmayan köşelere başvuran yüzler içeriyordu. Varlık dosyasının geçerli bir şekilde oluşturulduğundan emin olun.
ZERO_TRAJECTORIES_GENERATED Karşıya yüklenen varlıktan oluşturulan kamera yörüngeleri boştur. Dönüştürme için bir varlık göndermeden önce varlık boyutu yönergelerine uyduğundan emin olun.
TOO_MANY_RIG_POSES Ara PLY dosyasındaki rig pozlarının sayısı hizmet sınırlarını aştı. Dönüştürme için bir varlık göndermeden önce varlık boyutu yönergelerine uyduğundan emin olun.
SERVICE_ERROR Bilinmeyen bir hizmet hatası oluştu. Sorun devam ederse Object Anchors hizmet ekibine bir GitHub sorunu bildirin.
ASSET_CANNOT_BE_CONVERTED Sağlanan varlık bozuk, hatalı biçimlendirilmiş veya başka bir şekilde sağlanan biçimde dönüştürülemedi. Varlığın belirtilen türde geçerli bir şekilde oluşturulduğundan emin olun. Varlığı dönüştürme için göndermeden önce varlık boyutu yönergelerine uyduğundan emin olun.

Özel durum hataları

Gerçek varlık dönüştürme işlerinin dışında oluşan hatalar özel durum olarak oluşturulur. En önemlisi, Azure.RequestFailedException başarısız (4xx veya 5xx) veya beklenmeyen HTTP yanıt kodu alan hizmet çağrıları için oluşturulabilir. Bu özel durumlar hakkında daha fazla bilgi için, özel durumdaki Status, ErrorCodeveya Message alanlarını inceleyin.

Özel durum Neden
Argumentexception
  • ile ObjectAnchorsConversionClientbir istek oluşturmak için geçersiz şekilde oluşturulmuş veya sıfırdan sıfır hesap kimliği kullanma.
  • Geçersiz bir boşluk hesabı etki alanı kullanarak başlatmaya ObjectAnchorsConversionClient çalışılıyor.
  • aracılığıyla ObjectAnchorsConversionClientOptionsiçin desteklenmeyen ObjectAnchorsConversionClient bir hizmet sürümü sağlama.
Argumentnullexception
  • Geçersiz bir null hesap etki alanı kullanarak başlatmaya ObjectAnchorsConversionClient çalışılıyor.
  • Geçersiz bir null kimlik bilgisi kullanarak başlatmaya ObjectAnchorsConversionClient çalışılıyor.
Requestfailedexception
  • İş durumuyla ilgisiz, hatalı bir HTTP durum kodundan kaynaklanan diğer tüm sorunlar. Örnek olarak hesap bulunamaz, ön uç geçersiz bir karşıya yükleme URI'sini algılar veya ön uç hizmet hatası verilebilir.
UnsupportedAssetFileTypeException
  • Azure Object Anchors Dönüştürme hizmetinin desteklemediği bir uzantıya veya belirtilen dosya türüne sahip bir varlık gönderme.

Sonraki adımlar