Scene Viewer를 사용해 Android 앱 또는 브라우저에서 대화형 3D 모델을 AR로 표시

Scene Viewer는 웹사이트 또는 Android 앱에서 3D 및 AR 환경을 지원하는 몰입형 뷰어입니다. Android 모바일 기기 사용자는 Scene Viewer를 통해 웹 호스팅 3D 모델을 환경에서 쉽게 미리 보고, 배치하고, 보고, 상호작용할 수 있습니다.

대부분의 Android 브라우저에서 Scene Viewer를 지원합니다. Scene Viewer는 많은 Google 파트너가 3D 및 AR 환경을 안정적으로 지원하기 위해 성공적으로 구현했습니다. 또한 Google 검색의 이러한 환경을 지원합니다.

구현은 간단합니다.

  • 웹 기반 환경에는 웹페이지에 올바르게 형식이 지정된 링크만 있으면 됩니다.

  • 앱 기반 환경은 몇 줄의 Java 코드만 통합하면 됩니다.

Scene Viewer 런타임 요구사항

사용자가 Scene Viewer로 AR을 경험하려면 다음이 필요합니다.

  • Android 7.0 Nougat (API 수준 24) 이상을 실행하는 ARCore 지원 기기
  • 최신 버전의 Google Play AR 서비스 이 서비스는 대부분의 ARCore 지원 기기에 자동으로 설치되고 최신 상태로 유지됩니다.
  • 최신 버전의 Google 앱. 이 앱은 사전 설치되어 있으며 대부분의 ARCore 지원 기기에서 자동으로 최신 상태로 유지됩니다.

Google Play AR 서비스나 Google 앱이 없거나 설치된 버전이 너무 오래된 경우를 대비하여 대체 환경(예: 웹페이지, 오류 메시지, 빌드한 대체 환경)을 실행하는 대체 URL을 지정할 수 있습니다.

지원되는 사용 사례

의도된 사용 사례 권장 애플리케이션 이점
웹사이트 또는 Android 앱의 버튼이나 링크에서 3D 모델의 네이티브 AR 뷰를 실행합니다.

기기에 Google Play AR 서비스가 없는 경우 Scene Viewer 기반 3D 모드로 모델을 표시하도록 정상적으로 대체합니다.
Google 검색 패키지에 대한 명시적 인텐트를 사용하여 Scene Viewer를 실행하고 3D 모델을 표시하는 데 적합한 mode 설정을 선택합니다.
  • ar_preferred: 항상 AR 뷰어로 시작하며 사용자가 3D 뷰어로 수동 전환할 수 있습니다. Google Play AR 서비스가 없으면 3D 뷰어에서 시작하도록 정상적으로 대체됩니다.
  • 3d_preferred: 항상 3D 뷰어로 시작하며 사용자가 AR 뷰어로 수동 전환할 수 있습니다. Google Play AR 서비스가 없으면 사용자가 3D 뷰어에서 전환할 수 없습니다.
  • 3d_only: 항상 3D 뷰어에만 표시되며 사용자가 AR 뷰어로 전환할 방법이 없습니다.
  • 가능한 한 광범위한 기기를 지원합니다.
  • AR이 아닌 사용 사례의 경우 Scene Viewer의 기본 3D 모드로 자동 대체
웹사이트 또는 Android 앱의 버튼이나 링크에서 3D 모델의 네이티브 AR 뷰를 실행합니다.

기기에 Google Play AR 서비스가 없는 경우 대체 동작을 제어합니다.
Google Play AR 서비스 (ARCore)에 명시적 인텐트를 사용하여 Scene Viewer를 실행하고 3D 모델을 표시하는 데 적합한 mode 설정을 선택합니다.
  • ar_preferred: 항상 AR 뷰어로 시작하며 사용자가 3D 뷰어로 수동 전환할 수 있습니다. Google Play AR 서비스가 없으면 Scene Viewer가 구성된 동작으로 대체됩니다.
  • ar_only: 항상 AR 뷰어에만 표시되며 3D 뷰어로 전환할 수 없습니다. Google Play AR 서비스가 없으면 구성한 동작으로 대체됩니다. 예를 들어 자체 전체 화면 3D 환경을 실행하거나 사용자의 기기가 아직 AR 기능을 지원하지 않는다는 친근한 오류 메시지를 표시할 수 있습니다.
자체 3D 모델 뷰어를 사용하거나 AR이 아닌 사용 사례를 위해 자체 디자인의 다른 대체 응답을 제공합니다.
웹사이트에 3D 모델의 인라인 뷰를 호스팅하고 사용자가 전체 화면 네이티브 AR 모드를 수동으로 입력하도록 허용합니다. <model-viewer> 또는 기타 웹 기반 3D 뷰어를 사용하여 AR에서 3D 모델을 기본적으로 표시하는 Scene Viewer를 실행합니다.
  • 웹페이지에 삽입된 3D 모델에서 직접 AR로 Scene Viewer를 기본적으로 실행합니다.
  • 사용자가 소유하고 관리하는 화면에서 3D 환경을 제공하고, 사용자의 의도를 파악한 후에는 몰입도 높은 AR 환경으로 점진적으로 전환하는 옵션을 제공합니다.

명시적 인텐트 (3D 또는 AR)를 사용하여 Scene Viewer 실행

다양한 Android 기기를 지원하려면 명시적 Android 인텐트를 사용하여 Scene Viewer를 실행하세요. 명시적 인텐트는 HTML 페이지나 네이티브 Android 앱에서 트리거할 수 있습니다. 인텐트는 ARCore 지원 Android 기기에 사전 설치된 Google 앱에서 처리합니다.

구성된 인텐트 매개변수와 기기 기능에 따라 대화형 3D 모델을 사용자의 환경에 배치하거나 3D 뷰어에 표시되도록 대체할 수 있습니다.

  • Google Play AR 서비스가 기기에 있고 최신 상태인 경우 Scene Viewer는 AR 네이티브 뷰 또는 3D 뷰에 모델을 표시합니다.

  • Google Play AR 서비스가 없거나 최신 상태가 아닌 경우 장면 뷰어는 3D 뷰에 모델을 표시하도록 정상적으로 대체됩니다.

  • Google 앱이 설치되어 있지 않거나 이전 버전인 경우와 같이 3D 모델을 표시할 수 없는 경우 S.browser_fallback_url 매개변수가 대신 대체 웹페이지를 표시하는 데 사용됩니다.

HTML 또는 Java에서 Scene Viewer 실행

HTML

HTML에서 명시적 인텐트를 트리거하려면 다음 구문을 사용합니다.

<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>

자바

Java에서 명시적 인텐트를 트리거하려면 다음 코드를 사용하세요.

Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
sceneViewerIntent.setData(Uri.parse("https://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf"));
sceneViewerIntent.setPackage("com.google.android.googlequicksearchbox");
startActivity(sceneViewerIntent);

인텐트 버전 관리

인텐트 버전은 arvr.google.com/scene-viewer 뒤의 버전 번호로 표시됩니다. 예를 들어 초기 출시에서는 버전 1.0을 사용했습니다. 최신 Scene Viewer 기능이 필요한 경우 필요한 기능에 해당하는 더 높은 인텐트 버전으로 Scene Viewer를 실행할 수 있습니다.

인텐트 버전 1.1에서는 URL이 아닌 Android 앱으로 직접 실행할 수 있는 intent:// 링크 지원이 추가되었습니다. 시작 시 이 기능을 사용할 수 있도록 보장하고 그렇지 않으면 시작하지 않도록 하려면 intent://arvr.google.com/scene-viewer/1.1 인텐트로 장면 뷰어를 시작하세요.

지원되는 인텐트 매개변수

Google 검색 패키지에 대한 명시적 인텐트에는 다음 매개변수가 지원됩니다.

인텐트 매개변수 허용되는 값 댓글
file(필수) 올바른 URL 이 URL은 Scene Viewer에 로드해야 하는 glTF 또는 glb 파일을 지정합니다. URL로 이스케이프되어야 합니다.
S.browser_fallback_url (HTML 기반 인텐트에 필요) 올바른 URL 이 기능은 웹 기반 구현에서만 지원되는 Google Chrome 기능입니다. Google 앱이 기기에 없는 경우 Google Chrome이 이동하는 URL입니다.
mode(선택사항) 3d_preferred(기본) Scene Viewer는 내 공간에서 보기 버튼과 함께 3D 모드로 모델을 표시합니다.



기기에 Google Play AR 서비스가 없으면 내 공간에서 보기 버튼이 숨겨집니다.

3d_only 기기에 Google Play AR 서비스가 있어도 모델이 3D 모드로 표시된 상태로 Scene Viewer가 실행됩니다. 내가 있는 공간에서 보기 버튼이 표시되지 않습니다.

ar_preferred Scene Viewer가 진입 모드로 AR 기본 모드에서 실행됩니다. 사용자에게 내 공간에서 보기3D로 보기 버튼을 통해 AR 모드와 3D 모드 간에 전환할 수 있는 옵션이 제공됩니다.



Google Play AR 서비스가 없으면 Scene Viewer가 진입 모드로 3D 모드로 정상적으로 대체됩니다.

ar_only 이 값을 사용하는 경우 com.google.ar.core에 대한 명시적 Android 인텐트를 통해 실행해야 합니다.

참고: Google 앱명시적 Android 인텐트를 통해 실행할 때는 ar_only 모드를 사용하지 마세요.

link(선택사항) 올바른 URL 외부 웹페이지의 URL입니다. 제공된 경우 클릭 시 이 URL로 인텐트하는 버튼이 UI에 표시됩니다.

title(선택사항) 유효한 문자열 모델의 이름입니다. 값이 있으면 UI에 표시됩니다. 이름은 60자 이후에 줄임표로 잘립니다.

소리 (선택사항) 올바른 URL glTF 파일에 삽입된 첫 번째 애니메이션과 동기화된 반복 오디오 트랙의 URL입니다. 길이가 일치하는 애니메이션이 있는 glTF와 함께 제공되어야 합니다. 있는 경우 모델이 로드된 후 사운드가 반복됩니다. URL로 이스케이프되어야 합니다.
resizable(선택사항) true(기본)

false

false로 설정하면 사용자가 AR 환경에서 모델을 확장할 수 없습니다. 3D 환경에서는 크기 조절이 정상적으로 작동합니다.
enable_vertical_placement(선택사항) false(기본)

true

true로 설정하면 사용자가 모델을 수직 표면에 배치할 수 있습니다.

UX 안내

사용자에게 최상의 UX를 제공하려면 표시되는 클릭 유도 문구가 사용자가 몰입형 환경에 진입하려고 함을 전달하는 것이 좋습니다.

3D 뷰어 환경의 경우 다음 이미지 중 하나와 같은 3D로 보기라는 클릭 유도 문구를 사용하는 것이 좋습니다.

Google Play AR 서비스에 대한 명시적 인텐트를 사용하여 Scene Viewer 실행 (AR 모드만 해당)

Scene Viewer의 AR 모드는 Google Play AR 서비스로 구동됩니다.

Scene Viewer에서 AR을 사용할 수 있도록 하려면 웹사이트 또는 네이티브 Android 앱에서 명시적 Android 인텐트를 사용하여 com.google.ar.core package를 통해 Scene Viewer를 실행하고 browser_fallback_url를 제공하면 됩니다. 이렇게 하면 모든 사용자가 Scene Viewer를 통해 네이티브 AR 환경을 경험하거나 개발자가 직접 빌드한 대체 환경을 경험할 수 있습니다. 예를 들어 자체 3D 뷰어 또는 적절한 오류 메시지와 같은 대체 환경을 빌드할 수 있습니다.

HTML에서 명시적 인텐트를 트리거하려면 다음 구문을 사용합니다.

<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf&mode=ar_only#Intent;scheme=https;package=com.google.ar.core;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>;

Java에서 명시적 인텐트를 트리거하려면 다음 코드를 사용하세요.

Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
Uri intentUri =
    Uri.parse("https://arvr.google.com/scene-viewer/1.0").buildUpon()
    .appendQueryParameter("file", "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf")
    .appendQueryParameter("mode", "ar_only")
    .build();
sceneViewerIntent.setData(intentUri);
sceneViewerIntent.setPackage("com.google.ar.core");
startActivity(sceneViewerIntent);

지원되는 인텐트 매개변수

다음 매개변수는 Google Play 서비스의 AR 패키지에 대한 명시적 인텐트에서 지원됩니다.

인텐트 매개변수 허용되는 값 댓글
browser_fallback_url (HTML 기반 인텐트에 필요) 올바른 URL 웹 기반 구현에만 지원됩니다. Google Play AR 서비스가 기기에 없거나 최신 버전이 아닌 경우 이 URL로 이동합니다.
mode(선택사항) ar_only Scene Viewer는 항상 네이티브 AR 뷰에서 3D 모델을 실행하고 Scene Viewer 3D 뷰어로 전환하는 UI를 숨깁니다.

Google Play AR 서비스가 없으면 Scene Viewer가 웹 기반 환경을 위해 browser_fallback_url에 설정한 URL을 실행합니다. 앱 기반 환경의 경우 Scene Viewer는 오류 메시지나 직접 빌드한 다른 환경과 같은 대체 환경으로 대체됩니다.

ar_preferred Scene Viewer는 진입 모드로 AR 네이티브 모드에서 실행되며 사용자에게 내 공간에서 보기3D로 보기 버튼을 통해 AR 모드와 3D 모드 간에 전환할 수 있는 옵션을 제공합니다.

Google Play AR 서비스가 없으면 Scene Viewer가 웹 기반 환경을 위해 browser_fallback_url에 설정한 URL을 실행합니다. 앱 기반 환경의 경우 Scene Viewer는 오류 메시지나 직접 빌드한 다른 환경과 같은 대체 환경으로 대체됩니다.

   

link(선택사항) 올바른 URL 외부 웹페이지의 URL입니다. 제공된 경우 클릭 시 이 URL로 인텐트하는 버튼이 UI에 표시됩니다.



버전 1.1에서는 Scene Viewer 방문 버튼이 다른 앱으로 직접 트리거될 수 있도록 Scene Viewer에 intent:// 링크 지원이 추가되었습니다. 이는 신중하게 사용해야 하며, 지정된 인텐트에 인텐트 핸들러가 확실히 있는 경우에만 지정해야 합니다.
title(선택사항) 유효한 문자열 모델의 이름입니다. 값이 있으면 UI에 표시됩니다. 이름은 60자 이후에 줄임표로 잘립니다.



버전 1.1에서는 텍스트 양에 제한 없이 제목 콘텐츠의 HTML 스타일 지정 지원이 추가되었습니다. 참고: 제목은 URL로 이스케이프해야 합니다.
sound(선택사항) 올바른 URL glTF 파일에 삽입된 첫 번째 애니메이션과 동기화된 반복 오디오 트랙의 URL입니다. 길이가 일치하는 애니메이션이 있는 glTF와 함께 제공되어야 합니다. 있는 경우 모델이 로드된 후 소리가 반복됩니다.
resizable(선택사항) true(기본)

false

false로 설정하면 사용자가 AR 환경에서 모델을 확장할 수 없습니다. 3D 환경에서는 크기 조절이 정상적으로 작동합니다.
disable_occlusion(선택사항) false(기본)

true

true로 설정하면 장면에 배치된 객체가 항상 장면의 실제 객체 앞에 표시됩니다. 자세한 내용은 [폐색 사용 설정](/ar/develop/depth#enable_occlusion)을 참고하세요.

UX 안내

사용자에게 최상의 UX를 제공하려면 다음 가이드라인을 따르는 것이 좋습니다.

  • AR 환경의 경우 표시되는 클릭 유도 문구는 사용자가 몰입형 환경에 진입하려고 함을 전달해야 합니다. 내 공간에서 보기 클릭 유도 문구를 사용하는 것이 좋습니다.

  • 사용자의 기기에 Google Play AR 서비스가 설치되어 있지 않을 수 있습니다. <model-viewer>에서 대체를 처리하는 방법은 다음과 같습니다. 이 코드 조각을 시작점으로 자유롭게 사용하세요.

    // Check whether this is an Android device.
    const isAndroid = /android/i.test(navigator.userAgent);
    // This fallback URL is used if the Google app is not installed and up to date.
    const fallbackUrl = 'https://arvr.google.com/scene-viewer?file=https%3A%2F%2Fstorage.googleapis.com%2Far-answers-in-search-models%2Fstatic%2FTiger%2Fmodel.glb&link=https%3A%2F%2Fgoogle.com&title=Tiger';
    
    // This intent URL triggers Scene Viewer on Android and falls back to
    // fallbackUrl if the Google app is not installed and up to date.
    const sceneViewerUrl = 'intent://arvr.google.com/scene-viewer/1.0?file=https://storage.googleapis.com/ar-answers-in-search-models/static/Tiger/model.glb&title=Tiger#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=' +
        fallbackUrl + ';end;';
    
    // Create a link.
    var a = document.createElement('a');
    a.appendChild(document.createTextNode('Tiger'));
    // Set the href to the intent URL on Android and the fallback URL
    // everywhere else.
    a.href = isAndroid ? sceneViewerUrl : fallbackUrl;
    // Add the link to the page.
    document.body.appendChild(a);
    

<model-viewer>를 사용하여 Scene Viewer 실행

ar 속성이 있는 <model-viewer> 웹 구성요소를 포함하여 웹사이트에서 Scene Viewer를 사용 설정할 수 있습니다.

<model-viewer ar
              ar-modes="scene-viewer webxr quick-look"
              alt="A 3D model of an astronaut."
              src="Astronaut.gltf"></model-viewer>

ARCore 지원 Android 기기에서 ar 속성이 있는 <model-viewer> 구성요소가 포함된 웹사이트를 보면 다음 예와 같이 버튼이 표시됩니다.

ar-modes에서 scene-viewer 모드를 사용하면 네이티브 AR 뷰로 전환되고 Scene Viewer를 사용하여 환경에 모델을 배치하라는 메시지가 사용자에게 표시됩니다.

AR이 포함된 Google Play 서비스가 없는 경우 이 버튼을 탭하면 <model-viewer>의 3D 뷰어에 모델이 표시됩니다.

<model-viewer> 시작 방법에 관한 자세한 내용은 <model-viewer> 문서를 참고하세요.

모델 파일 요구사항

Scene Viewer에는 모델에 대한 다음과 같은 지원 및 제한사항이 있습니다.

파일 형식 지원 glTF 2.0/glb을 사용하고 다음 확장 프로그램을 사용합니다.
  • KHR_materials_unlit
  • KHR_texture_transform
애니메이션
  • 스켈레톤 애니메이션 반복
  • 리깅된 애니메이션 반복
  • 변환 애니메이션 반복
애니메이션이 반복 재생됩니다. glTF 파일에 애니메이션이 여러 개 포함된 경우 Scene Viewer는 첫 번째 애니메이션만 재생합니다.
권장되는 한도 애셋의 전반적인 성능은 제약 조건을 설정하고 정점, 재질, 텍스처 해상도, 재질당 메시, 기타 요인 간의 균형을 맞추는 데 따라 달라집니다. 다음 가이드라인에 따라 애셋을 최적화하세요.
  • 삼각형 수: 권장되는 한도는 100,000개의 삼각형이지만, 가장 적은 수를 타겟팅하면 Scene Viewer에서 높은 성능을 유지할 수 있습니다. 30,000~50,000이 이상적인 범위입니다.
  • 소재 수: 권장되는 제한은 10개 소재이며 그중 2개는 알파일 수 있습니다. 애셋의 실적을 양호하게 유지하려면 가능한 가장 낮은 숫자를 타겟팅하세요.
  • 재질당 메시: 1
  • 최대 텍스처 해상도: 2048×2048
  • 뼈 (가중치가 적용되지 않은 조인트 포함): 254 (하드 한도)
  • 정점당 본 가중치 제한: 4 (엄격한 제한)
  • UV: 메시당 UV 1개 (엄격한 한도)
  • 모델 크기: 10MB (모델이 클수록 사용자 환경이 저하될 수 있음)
그림자 지원 하드 그림자는 객체를 배치할 때 Scene Viewer에 의해 자동으로 렌더링되므로 모델에 그림자를 베이킹하지 않는 것이 좋습니다.
텍스처 지원
  • PNG 형식: PNG-24, 인덱싱된 PNG-8
    투명도가 없는 경우 크기를 줄이므로 JPG가 선호됩니다.
  • 색상 공간: sRGB
Material PBR
파일 로드 HTTPS
장면
  • 축: 오른손잡이, 다음 속성 포함
    • +X가 맞음
    • +Y가 위쪽
    • -Z는 원점에서 앞으로 향합니다 (즉, 애셋의 '앞'이 +Z를 향해야 함).
  • 크기: 1단위 = 1미터 (모델이 AR에 실제 크기로 배치되도록 glTF 사양에 정의됨)

미리보기 도구를 사용하여 3D 모델 검증

3D 모델 파일이 Scene Viewer에 올바르게 표시되도록 하려면 온라인 미리보기 도구를 사용하여 PC의 파일 유효성을 검사하세요.

3D 모델 검증

모델의 유효성을 검사하려면 미리보기 도구에 glb 또는 glTF 파일, 연결된 이미지 및 bin 파일, 선택적 오디오 파일이 필요합니다. 오디오 파일은 애니메이션 0과 함께 반복됩니다.

개별 파일을 다중 선택하거나 선택적으로 glb 또는 glTF와 연결된 파일을 zip 파일에 넣을 수 있습니다. (zip 파일 방식은 오디오 파일을 지원하지 않습니다.)

3D 모델을 검증하려면 다음 단계를 따르세요.

  1. 브라우저에서 온라인 미리보기 도구를 엽니다.

  2. 다음 방법 중 하나를 사용하여 미리보기 도구에 파일을 추가합니다.

    • 드래그 앤 드롭 glb 또는 glTF 파일과 연결된 모든 파일 (또는 이러한 파일이 포함된 zip 파일)을 선택하고 선택한 파일 또는 zip 파일을 미리보기 도구로 드래그합니다.

    • 미리보기 도구에서 미리보기 도구에서 Scene Viewer > Load File을 선택합니다. glb 또는 glTF 파일과 연결된 모든 파일 (또는 이러한 파일이 포함된 zip 파일)을 선택하고 열기를 클릭합니다.

3D 모델로 구성된 파일을 미리보기 도구에 로드하면 브라우저 하단의 콘솔에 오류 메시지를 비롯한 결과가 표시됩니다.

검증을 위한 3D 모델 추가

3D 모델을 검증하려면 3D 모델을 구성하는 파일을 Google의 모델 편집기 도구에 추가하세요.

모델의 유효성을 검사하려면 미리보기에 모델의 glb 또는 glTF 파일, 연결된 이미지 및 bin 파일, 선택적 오디오 파일이 필요합니다. 개별 파일을 다중 선택하거나 단일 ZIP 파일을 추가할 수 있습니다.

zip 파일을 추가하면 미리보기 도구는 zip 파일 내에서 처음 발견된 glb 또는 glTF와 해당 zip 파일 내의 연결된 이미지 및 bin 파일을 로드합니다.

  1. 브라우저에서 모델 편집기 도구를 엽니다.

  2. 다음 방법 중 하나를 사용하여 미리보기 도구에 파일을 추가합니다.

    • 유효성 검사를 위해 파일을 드래그 앤 드롭하려면 glb 또는 glTF 파일과 연결된 파일을 여러 개 선택하거나 이러한 파일이 포함된 zip 파일을 선택한 후 미리보기 도구로 드래그합니다.

    • 미리보기 도구에서 파일 선택 미리보기 도구에서 Scene Viewer > Load File을 선택합니다. glb 또는 glTF 파일과 연결된 모든 파일 (또는 이러한 파일이 포함된 zip 파일)을 다중 선택하고 열기를 클릭합니다.

확인 오류

오류 코드 심각도 메시지 현재 지원되는 값
INVALID_INPUT_FILE_EXTENSION 오류 입력 파일 [filename] 의 파일 확장자는 검사기에서 지원되지 않습니다. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED 경고 제공된 사용자 입력의 바이너리 크기가 Scene Viewer 사양에서 권장되는 크기 제한인 [size] MB를 초과합니다. 10
MAX_INPUT_BINARY_SIZE_EXCEEDED 오류 제공된 사용자 입력의 바이너리 크기가 Scene Viewer 사양에서 지원되는 최대 크기 제한인 [size] MB를 초과합니다. 15
UNSUPPORTED_GLTF_EXTENSION_USED 오류 Scene Viewer 사양에서 glTF의 확장자 [ext] 을(를) 지원하지 않습니다. ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED 오류 glTF의 애니메이션 수가 Scene Viewer 사양에서 지원되는 최대 애니메이션 수인 [num] 개를 초과합니다. 1
MORPH_TARGET_USED 오류 glTF에 포함된 변형 타겟이 Scene Viewer 사양에서 지원되지 않습니다.
MATERIAL_LIMIT_EXCEEDED 경고 glTF의 소재 수가 Scene Viewer 사양에서 권장되는 최대 소재 수인 [num] 개를 초과합니다. 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED 경고 glTF에 있는 색인 [idx] 의 이미지 해상도가 Scene Viewer 사양에서 권장되는 최대 해상도 [res] x [res]을(를) 초과합니다. 2048 x 2048
UV_LIMIT_EXCEEDED 오류 glTF의 메시당 UV 수가 Scene Viewer 사양에서 지원되는 메시당 최대 UV 수 [num] 개를 초과합니다. 1
VERTEX_COLOR_USED 오류 glTF에 포함된 꼭짓점 색상이 Scene Viewer 사양에서 지원되지 않습니다.
JOINT_LIMIT_EXCEEDED 오류 glTF의 조인트 수가 Scene Viewer 사양에서 지원되는 최대 조인트 수 [num] 개를 초과합니다. 254
TRIANGLE_LIMIT_EXCEEDED 경고 glTF의 삼각형 수가 Scene Viewer 사양에서 권장되는 최대 삼각형 수인 [num] 개를 초과합니다. 100,000
PRIMITIVE_MODE_UNSUPPORTED 오류 프리미티브 모드 [mode] 은(는) Scene Viewer 사양에서 지원되지 않습니다. {4 : 삼각형 목록, 5 : 삼각형 스트립, 6 : 삼각형 팬}
MISSING_PBR_METALLIC_ROUGHNESS 정보 색인 [idx] 의 소재에 pbrMetallicRoughness 속성이 누락되었습니다. 금속성 및 거침 요소를 대신 사용하는 경우 Scene Viewer 사양에서 이 속성이 없어도 됩니다. 둘 다 사용하지 않으면 소재에서 기본값이 사용되므로 의도치 않은 동작이 발생할 수 있습니다.