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

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

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

구현 방법은 간단합니다.

  • 웹 기반 환경에서는 웹페이지에 적절한 형식의 링크만 있으면 됩니다.

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

Scene Viewer 런타임 요구사항

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

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

AR용 Google Play 서비스 또는 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 서비스가 없거나 최신 버전이 아닌 경우 Scene Viewer는 모델을 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

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:// 링크 지원이 추가되었습니다. Scene Viewer에서 시작할 때 이 기능을 사용할 수 있음을 보장하고 그 외에는 실행하지 않으려면 intent://arvr.google.com/scene-viewer/1.1 인텐트로 장면 뷰어를 실행합니다.

지원되는 인텐트 매개변수

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

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



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

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

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



Google Play AR 서비스가 없으면 Scene Viewer가 입력 모드로 3D 모드로 되돌아갑니다.

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

참고: 명시적 Android 인텐트를 통해 Google 앱으로 시작할 때는 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);

지원되는 인텐트 매개변수

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

인텐트 매개변수 허용되는 값 설명
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에 intent:// 링크 지원을 추가하여 Scene Viewer 방문 버튼을 다른 앱으로 직접 트리거할 수 있도록 했습니다. 이는 주의해서 사용해야 하며 지정된 인텐트에 인텐트 핸들러가 있음이 보장되는 경우에만 지정해야 합니다.
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를 사용하여 사용자가 환경에 모델을 배치하도록 초대합니다.

Google Play AR 서비스가 없는 경우 이 버튼을 탭하면 <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 실적 기반 수익
파일 로드 HTTPS
장면
  • 축: 오른손, 다음 속성 포함:
    • +X가 맞음
    • +Y가 상승함
    • -Z는 원점에서 앞에 있습니다 (즉, 애셋의 '앞'이 +Z를 향해야 함).
  • 배율: 1단위 = 1미터 (모델이 실제 배율로 AR에 배치되도록 glTF 사양에 의해 정의됨)

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

3D 모델 파일이 Scene Viewer에 제대로 표시되도록 하려면 온라인 미리보기 도구를 사용하여 PC에 있는 파일을 검증합니다.

3D 모델 유효성 검사

모델을 검증하려면 미리보기 도구에 glb 또는 glTF 파일 1개, 관련 이미지 및 bin 파일, 오디오 파일(선택사항)이 필요합니다. 오디오 파일은 애니메이션 0과 함께 연속 재생됩니다.

개별 파일을 여러 개 선택하거나 원하는 경우 glb 또는 glTF 및 관련 파일을 ZIP 파일에 넣을 수 있습니다. ZIP 파일 방법은 오디오 파일을 지원하지 않습니다.

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

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

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

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

    • 미리보기 도구에서. 미리보기 도구에서 Scene Viewer > Load File을 선택합니다. glb 또는 glTF 파일 및 모든 관련 파일 (또는 이러한 파일이 포함된 ZIP 파일)을 선택하고 Open을 클릭합니다.

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

유효성 검사를 위한 3D 모델 추가

3D 모델의 유효성을 검사하려면 3D 모델을 구성하는 파일을 모델 편집기 도구에 추가합니다.

모델을 검증하려면 미리보기 도구에 모델의 glb 또는 glTF 파일, 관련 이미지 및 bin 파일, 오디오 파일(선택사항)이 필요합니다. 개별 파일을 여러 개 선택하거나 ZIP 파일 하나를 추가할 수 있습니다.

ZIP 파일을 추가할 때 미리보기 도구는 찾은 첫 번째 glb 또는 glTF와 함께 관련 이미지와 ZIP 파일 내의 bin 파일을 로드합니다.

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

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

    • 유효성 검사를 위해 파일을 드래그 앤 드롭하려면 glb 또는 glTF 파일 및 관련 파일을 여러 개 선택하고 (또는 이러한 파일이 포함된 ZIP 파일을 선택) 미리보기 도구로 드래그합니다.

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

유효성 검사 오류

오류 코드 심각도 메시지 현재 지원 값
INVALID_INPUT_FILE_EXTENSION 오류 입력 파일[파일 이름] 의 파일 확장자가 검사기에서 지원되지 않습니다. ['.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 오류 프리미티브 모드 [모드] 는 Scene Viewer 사양에서 지원되지 않습니다. {4 : 삼각형 목록, 5 : 삼각형 스트립, 6 : 삼각형 팬}
MISSING_PBR_METALLIC_ROUGHNESS 정보 색인 [idx] 의 소재에 pbrMetallicRoughness 속성이 누락되었습니다. 금속성 및 거칠기 요소를 대신 사용하는 경우 Scene Viewer 사양에서 이 속성이 필요하지 않습니다. 둘 다 사용하지 않으면 소재에서 기본값이 사용되므로 의도하지 않은 동작이 발생할 수 있습니다.