다음을 통해 공유

모델 변환 오류 코드

  • 아티클

일반적인 모델 변환 실패 모드의 경우 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionOperation의 Value 필드에서 가져온 Azure.MixedReality.ObjectAnchors.Conversion.AssetConversionProperties 개체에는 ConversionErrorCode 형식의 ErrorCode 필드가 포함되어 있습니다.

ConversionErrorCode 형식은 다음과 같은 모델 변환 실패의 일반적인 모드를 열거합니다. 이러한 열거형은 오류 메시지 지역화, 오류 복구 및 오류 수정 방법에 대한 사용자 팁에 유용합니다.

오류 코드 설명 완화 방법
INVALID_ASSET_URI 변환 작업을 시작할 때 제공된 URI에서 자산을 찾을 수 없습니다. 자산 변환 작업을 트리거할 때 변환할 자산이 업로드된 서비스에서 가져온 업로드 URI를 제공합니다.
INVALID_JOB_ID 자산 변환 작업에 제공된 ID는 모두 0인 기본 GUID로 설정되었습니다. 자산 변환 작업을 만들 때 GUID가 지정된 경우 모두 0인 기본 GUID가 아닌지 확인합니다.
INVALID_GRAVITY 자산 변환 작업을 만들 때 제공된 중력 벡터는 완전히 0인 벡터였습니다. 자산 변환을 시작할 때 업로드된 자산에 해당하는 중력 벡터를 제공합니다.
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 파일의 Rig 포즈 수가 서비스 제한을 초과했습니다. 전환을 위해 자산을 제출하기 전에 자산 크기 가이드라인을 준수하는지 확인합니다.
SERVICE_ERROR 알 수 없는 서비스 오류가 발생했습니다. 문제가 지속되면 Object Anchors 서비스 팀에 GitHub 문제를 제출합니다.
ASSET_CANNOT_BE_CONVERTED 제공된 자산이 손상되었거나 형식이 잘못되었거나 제공된 형식으로 변환할 수 없습니다. 자산이 지정된 형식의 유효하게 구성된 파일인지 확인합니다. 전환을 위해 자산을 제출하기 전에 자산 크기 가이드라인을 준수하는지 확인합니다.

예외 오류

실제 자산 변환 작업 외부에서 발생하는 모든 오류는 예외로 처리됩니다. 특히, Azure.RequestFailedException은 실패한(4xx 또는 5xx) 또는 예기치 않은 HTTP 응답 코드를 수신하는 서비스 호출에 대해 throw될 수 있습니다. 이러한 예외에 대한 자세한 내용은 예외에 대한 StatusErrorCode필드 또는 Message 필드를 검사합니다.

예외 원인
ArgumentException
  • 잘못 구성된 계정 ID 또는 모두 0인 계정 ID를 사용하여 ObjectAnchorsConversionClient로 요청을 구성합니다.
  • 잘못된 공백 계정 도메인을 사용하여 ObjectAnchorsConversionClient를 초기화하려고 합니다.
  • ObjectAnchorsConversionClientOptions를 통해 ObjectAnchorsConversionClient에 지원되지 않는 서비스 버전을 제공합니다.
ArgumentNullException
  • 잘못된 null 계정 도메인을 사용하여 ObjectAnchorsConversionClient를 초기화하려고 합니다.
  • 잘못된 null 자격 증명을 사용하여 ObjectAnchorsConversionClient 초기화를 시도합니다.
RequestFailedException
  • 작업 상태와 관련 없는 잘못된 HTTP 상태 코드로 인해 발생하는 기타 모든 문제입니다. 예를 들면 찾을 수 없는 계정, 잘못된 업로드 URI를 검색하는 프런트 엔드 또는 프런트 엔드 서비스 오류가 있습니다.
UnsupportedAssetFileTypeException
  • Azure 개체 앵커 변환 서비스가 지원하지 않는 확장명 또는 지정된 파일 형식을 사용하여 자산을 제출합니다.

다음 단계