Używanie Scene Viewer do wyświetlania interaktywnych modeli 3D w AR w aplikacji lub przeglądarce na Androida

Scene Viewer to pojemne narzędzie, które umożliwia korzystanie z 3D i AR w Twojej witrynie lub aplikacji na Androida. Pozwala użytkownikom urządzeń mobilnych z Androidem łatwo wyświetlać podgląd modeli 3D hostowanych w internecie, rozmieszczać je i wchodzić z nimi w interakcje.

Większość przeglądarek na Androidzie obsługuje Scene Viewer. Wielu partnerów Google wdrożyło Scene Viewer, aby niezawodnie obsługiwać treści 3D i AR. Służą one również do działania wyszukiwarki Google.

Implementacja jest prosta:

• Rozwiązania internetowe wymagają tylko prawidłowo sformatowanych linków na stronie internetowej.

• Rozwiązania działające w aplikacjach wymagają integracji tylko kilku wierszy kodu Java.

Wymagania dotyczące środowiska wykonawczego Scene Viewer

Aby korzystać z rzeczywistości rozszerzonej za pomocą Scene Viewer, użytkownicy muszą mieć:

• Urządzenie obsługujące ARCore z Androidem 7.0 Nougat (poziom interfejsu API 24) lub nowszym.
• Aktualna (najnowsza) wersja Usług Google Play dla AR. Usługa ta jest instalowana i aktualizowana automatycznie na większości urządzeń obsługujących ARCore.
• Aktualna wersja aplikacji Google, która jest wstępnie zainstalowana i jest automatycznie aktualizowana na większości urządzeń obsługujących ARCore.

Aby uwzględnić przypadki, gdy Usługi Google Play dla AR lub aplikacja Google są niedostępne albo zainstalowane wersje są zbyt stare, możesz podać zastępczy URL uruchamiający alternatywne środowisko, np. stronę internetową, komunikat o błędzie lub utworzoną przez Ciebie funkcję zastępczą.

Obsługiwane zastosowania

Zamierzony przypadek użycia	Zalecana aplikacja	Zalety
Za pomocą przycisku lub linku w witrynie bądź aplikacji na Androida uruchom natywny widok AR modelu 3D. Jeśli na urządzeniu nie ma Usług Google Play dla AR, wróć do modelu i wyświetl go w trybie 3D z obsługą Scene Viewer.	Uruchom przeglądarkę scen, korzystając z jednoznacznej intencji dotyczącej pakietu wyszukiwarki Google, i wybierz odpowiednie ustawienie mode, aby wyświetlić model 3D. ar_preferred: zawsze zaczyna się w przeglądarce AR, a użytkownicy mogą ręcznie przełączyć się na przeglądarkę 3D. Jeśli Usługi Google Play dla AR nie są dostępne, następuje płynne uruchomienie przeglądarki 3D. 3d_preferred: zawsze zaczyna się w przeglądarce 3D, a użytkownicy mogą ręcznie przełączyć się na przeglądarkę AR. Jeśli Usługi Google Play dla AR nie są dostępne, użytkownicy nie mogą wyłączyć przeglądarki 3D. 3d_only: zawsze wyświetlany jest tylko w przeglądarce 3D, ale użytkownicy nie mogą przełączyć się na przeglądarkę AR.	Obsługują najszerszą możliwą liczbę urządzeń. Automatycznie wracaj do natywnego trybu 3D przeglądarki Scene Viewer w przypadkach innych niż AR.
Za pomocą przycisku lub linku w witrynie bądź aplikacji na Androida uruchom natywny widok AR modelu 3D. Jeśli na urządzeniu nie ma Usług Google Play dla AR, określ działanie awaryjne.	Uruchom przeglądarkę scen, korzystając z wyraźnej intencji użytkownika w Usługach Google Play dla AR (ARCore), i wybierz odpowiednie ustawienie mode do wyświetlania modelu 3D. ar_preferred: zawsze uruchamia się w przeglądarce AR, a użytkownicy mogą ręcznie przełączyć się na przeglądarkę 3D. Jeśli Usługi Google Play dla AR nie są dostępne, Podgląd sceny przełącza się w skonfigurowane przez Ciebie zachowanie. ar_only: zawsze wyświetla się tylko w przeglądarce AR, bez możliwości przełączania się na przeglądarkę 3D. Jeśli Usługi Google Play dla AR nie są widoczne, przywracane są skonfigurowane przez Ciebie zachowanie. Możesz na przykład uruchomić własny widok 3D na pełnym ekranie lub wyświetlić przyjazny komunikat o błędzie informujący, że urządzenie użytkownika nie obsługuje jeszcze funkcji AR.	Użyj własnej przeglądarki modeli 3D lub podaj inną odpowiedź zastępczą własnego projektu na potrzeby zastosowań innych niż AR.
Udostępnij w swojej witrynie widok modelu 3D i umożliw użytkownikowi ręczne włączanie pełnoekranowego natywnego trybu AR.	Użyj programu <model-viewer> lub innej przeglądarki 3D, aby uruchomić przeglądarkę Scene Viewer, który będzie natywnie wyświetlać model 3D w AR.	Uruchamiaj przeglądarkę scen natywnie w AR bezpośrednio z modelu 3D umieszczonego na stronie internetowej. Zapewnij użytkownikom wrażenia 3D w obszarze, którego jesteś właścicielem i którym masz kontrolę. Możesz też stopniowo przełączać ich w bardziej wciągające doświadczenie AR, gdy poznasz ich zamiar.

Uruchamianie przeglądarki scen z użyciem wyraźnej intencji (3D lub AR)

Jeśli chcesz obsługiwać najszerszą gamę urządzeń z Androidem, uruchom Scene Viewer, korzystając z zamiaru Androida. Intencję można wywołać na stronie HTML lub w natywnej aplikacji na Androida. Intencja będzie obsługiwana przez aplikację Google, która jest wstępnie zainstalowana na urządzeniach z Androidem obsługujących ARCore.

W zależności od skonfigurowanych parametrów intencji i możliwości urządzenia interaktywne modele 3D można umieszczać w środowisku użytkownika lub wyświetlać je w przeglądarce 3D.

• Jeśli na urządzeniu są zainstalowane Usługi Google Play dla AR (w aktualnej wersji), Scene Viewer wyświetli model w natywnym widoku AR lub 3D.

• Jeśli Usługi Google Play dla AR są niedostępne lub nieaktualne, Scene Viewer płynnie wraca do widoku 3D.

• Jeśli nie można wyświetlić modelu 3D, np. dlatego, że aplikacja Google nie jest zainstalowana lub jest w starszej wersji, do wyświetlenia zastępczej strony internetowej zostanie użyty parametr S.browser_fallback_url.

Uruchamianie przeglądarki Scene Viewer z HTML lub Javy

HTML

Aby wywołać intencję jawną z poziomu kodu HTML, użyj tej składni:

<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

Aby aktywować intencję w Javie, użyj tego kodu:

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);

Obsługa wersji intencji

Wersja intencji jest określona numerem wersji po arvr.google.com/scene-viewer. Na przykład pierwsze wydanie korzystało z wersji 1.0. Jeśli wymagane są nowsze funkcje Scene Viewer, możesz uruchomić go z wyższą wersją intencji, która odpowiada wymaganym funkcjom.

Intencja w wersji 1.1 dodała obsługę linków intent://, które mogą otwierać się bezpośrednio do aplikacji na Androida, a nie pod adresem URL. Jeśli chcesz, aby funkcja Scene Viewer zagwarantowała, że ta funkcja będzie dostępna po uruchomieniu, a w innym przypadku nie uruchomi się, uruchom przeglądarkę sceny z zamiarem intent://arvr.google.com/scene-viewer/1.1.

Obsługiwane parametry intencji

Poniższe parametry są obsługiwane w przypadku wyraźnej intencji skierowanej do pakietu wyszukiwarki Google.

Parametr intencji	Dozwolone wartości	Komentarze
file (wymagane)	Prawidłowy adres URL	Ten adres URL określa plik glTF lub glb, który należy wczytać do przeglądarki Scene Viewer. Powinna to być wartość ze zmianą znaczenia.
S.browser_fallback_url (wymagane w przypadku intencji opartych na HTML)	Prawidłowy adres URL	Ta funkcja Google Chrome jest obsługiwana tylko w implementacjach internetowych. Jeśli na urządzeniu nie ma aplikacji Google, jest to adres URL, na który przechodzi Google Chrome.
mode (opcjonalnie)	3d_preferred (domyślnie)	Przeglądarka scen wyświetla model w trybie 3D po kliknięciu przycisku Wyświetl w swoim otoczeniu. Jeśli na urządzeniu nie ma Usług Google Play dla AR, przycisk Zobacz w swoim otoczeniu jest ukryty.
	3d_only	Przeglądarka scen jest uruchamiana z modelem wyświetlanym w trybie 3D, nawet jeśli na urządzeniu są dostępne Usługi Google Play dla AR. Przycisk Wyświetl w swojej przestrzeni nigdy nie jest wyświetlany.
	ar_preferred	Podgląd sceny uruchamia się w trybie natywnym AR jako tryb wejścia. Użytkownik może przełączać się między trybami AR i 3D za pomocą przycisków Zobacz w swoim otoczeniu i Wyświetl w 3D. Jeśli Usługi Google Play dla AR nie są dostępne, Podgląd scen w trybie 3D płynnie przełącza się w tryb wejścia.
	ar_only	Używając tej wartości, uruchom za pomocą wyraźnej intencji Androida do com.google.ar.core. Uwaga: nie używaj trybu ar_only podczas uruchamiania za pomocą intencji dla Androida w aplikacji Google.
link (opcjonalnie)	Prawidłowy adres URL	URL zewnętrznej strony internetowej. Jeśli ten adres występuje, w interfejsie pojawi się przycisk przekierowujący użytkownika do tego adresu URL po kliknięciu.
title (opcjonalnie)	Prawidłowy ciąg znaków	Nazwa modelu. Jeśli ten adres występuje, wyświetli się w interfejsie. Nazwa zostanie obcięta do wielokropków po 60 znakach.
dźwięk (opcjonalnie)	Prawidłowy adres URL	Adres URL zapętlonej ścieżki audio zsynchronizowanej z pierwszą animacją umieszczoną w pliku glTF. Powinien być podany razem z plikiem glTF z animacją o pasującej długości. Jeśli ta opcja jest dostępna, po wczytaniu modelu dźwięk jest zapętlony. Powinna to być wartość ze zmianą znaczenia.
resizable (opcjonalnie)	true (domyślnie) false	Gdy ustawisz wartość false, użytkownicy nie będą mogli skalować modelu w rzeczywistości AR. Skalowanie działa normalnie w trybie 3D.
enable_vertical_placement (opcjonalnie)	false (domyślnie) true	Gdy ustawisz wartość true, użytkownicy będą mogli umieszczać model na płaskiej powierzchni.

Wskazówki UX

Aby zapewnić użytkownikom jak najlepsze wrażenia, zalecamy, by widoczne wezwania do działania informują o tym, że użytkownik za chwilę wejdzie w atrakcyjne środowisko.

W przypadku przeglądarki 3D zalecamy użycie wezwania do działania Wyświetl w 3D, które wygląda tak jak jeden z tych obrazów:

Uruchamianie przeglądarki scen z użyciem wyraźnej intencji dla Usług Google Play dla AR (tylko w trybie AR)

Tryb AR w aplikacji Scene Viewer korzysta z Usług Google Play dla AR.

Aby mieć pewność, że funkcja AR jest dostępna w przeglądarce scen, możesz użyć zamiaru Androida ze strony internetowej lub natywnej aplikacji na Androida, aby uruchomić przeglądarkę Scene Viewer w com.google.ar.core package i podać browser_fallback_url. Dzięki temu będziesz mieć pewność, że wszyscy użytkownicy korzystają z natywnej rzeczywistości AR za pomocą przeglądarki Scene Viewer lub mają środowisko zastępcze utworzone przez Ciebie. Możesz na przykład utworzyć elementy zastępcze, takie jak Twoja przeglądarka 3D lub atrakcyjny komunikat o błędzie.

Aby wywołać intencję jawną z poziomu kodu HTML, użyj tej składni:

<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>;

Aby aktywować intencję w Javie, użyj tego kodu:

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);

Obsługiwane parametry intencji

Poniższe parametry są obsługiwane w przypadku wyraźnej intencji dotyczącej pakietu Usług Google Play dla pakietu AR.

Parametr intencji	Dozwolone wartości	Komentarze
browser_fallback_url (wymagane w przypadku intencji opartych na HTML)	Prawidłowy adres URL	Ta opcja jest obsługiwana tylko w przypadku implementacji internetowych. Jeśli na urządzeniu nie ma Usług Google Play dla AR lub są one nieaktualne, jest to adres URL, do którego prowadzi.
mode (opcjonalnie)	ar_only	Przeglądarka scen zawsze uruchamia model 3D w natywnym widoku AR i ukrywa interfejs użytkownika umożliwiający przełączenie do przeglądarki 3D Scene Viewer. Jeśli Usługi Google Play dla AR nie są dostępne, Scene Viewer uruchamia URL, który podasz w browser_fallback_url. W przypadku aplikacji Scene Viewer wraca do innego środowiska, takiego jak komunikat o błędzie lub inny element utworzony przez Ciebie.
	ar_preferred	Przeglądarka scen uruchamia się w trybie natywnym AR jako tryb wejścia i umożliwia użytkownikom przełączanie się między trybami AR i 3D za pomocą przycisków Wyświetl w Twojej przestrzeni i Wyświetl w 3D. Jeśli Usługi Google Play dla AR nie są dostępne, Scene Viewer uruchamia URL, który podasz w browser_fallback_url. W przypadku aplikacji Scene Viewer wraca do innego środowiska, takiego jak komunikat o błędzie lub inny element utworzony przez Ciebie.
link (opcjonalnie)	Prawidłowy adres URL	URL zewnętrznej strony internetowej. Jeśli ten adres występuje, w interfejsie pojawi się przycisk przekierowujący do tego adresu URL po kliknięciu. Wersja 1.1 dodała obsługę linków intencji:// w przeglądarce scen, aby umożliwić uruchamianie przycisku wizyty wyświetlającego Scene Viewer bezpośrednio w innych aplikacjach. Tego atrybutu należy używać z rozwagą. Należy go określać tylko wtedy, gdy moduł obsługi intencji jest gwarantowany dla danej intencji.
title (opcjonalnie)	Prawidłowy ciąg znaków	Nazwa modelu. Jeśli ten adres występuje, wyświetli się w interfejsie. Nazwa zostanie obcięta do wielokropków po 60 znakach. Wersja 1.1 dodała obsługę stylu HTML treści tytułu z dowolną dozwoloną ilością tekstu. Tytuł powinien zawierać fragment adresu URL ze zmianą znaczenia.
sound (opcjonalnie)	Prawidłowy adres URL	Adres URL zapętlonej ścieżki audio zsynchronizowanej z pierwszą animacją umieszczoną w pliku glTF. Powinien być podany razem z plikiem glTF z animacją o pasującej długości. Jeśli ta opcja jest dostępna, po wczytaniu modelu dźwięk jest zapętlony.
resizable (opcjonalnie)	true (domyślnie) false	Gdy ustawisz wartość false, użytkownicy nie będą mogli skalować modelu w rzeczywistości AR. Skalowanie działa normalnie w trybie 3D.
disable_occlusion (opcjonalnie)	false (domyślnie) true	Gdy ustawisz wartość true, obiekty umieszczone w scenie zawsze pojawiają się przed rzeczywistymi obiektami na scenie. Więcej informacji znajdziesz w artykule o [włączaniu przesłaniania](/ar/develop/depth#enable_occlusion).

Wskazówki UX

Aby zapewnić użytkownikom jak najlepsze wrażenia, zalecamy stosowanie się do tych wytycznych.

• W przypadku AR widoczne wezwanie do działania powinno informować użytkownika o zanurzeniu się w atrakcyjne środowisko. Zalecamy użycie wezwania do działania Zobacz w swojej przestrzeni:
  

• Możliwe, że użytkownicy nie mają na swoich urządzeniach zainstalowanych Usług Google Play dla AR. Zobacz, jak <model-viewer> obsługuje kreację zastępczą. Możesz też użyć tego fragmentu kodu jako punktu wyjścia.

  // 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);
  

Uruchamianie przeglądarki Scene Viewer z wykorzystaniem <model-viewer>

Aby włączyć podgląd sceny w swojej witrynie, dodaj komponent internetowy <model-viewer> z atrybutem ar.

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

W przypadku wyświetlenia na urządzeniu z Androidem, które obsługuje ARCore, witryna zawierająca komponent <model-viewer> z atrybutem ar wyświetla przycisk, tak jak w poniższym przykładzie.

Gdy tryb scene-viewer jest używany w ar-modes, przełącza się na natywny widok AR i zaprasza użytkownika do umieszczenia modelu w swoim środowisku za pomocą przeglądarki Scene Viewer.

Jeśli Usługi Google Play z AR są niedostępne, kliknięcie tego przycisku spowoduje wyświetlenie modelu w przeglądarce 3D użytkownika <model-viewer>.

Przeczytaj dokumentację dotyczącą <model-viewer>, aby dowiedzieć się, jak zacząć korzystać z <model-viewer>.

Wymagania dotyczące plików dla modeli

Wyświetlający Scene View ma następujące funkcje obsługi i ograniczenia dotyczące modeli.

Obsługa formatów plików	glTF 2.0/glb z tymi rozszerzeniami: KHR_materials_unlit KHR_texture_transform
Animacja	Animacja szkieletu zapętlonego Animacja sztywnej pętli Zapętlanie animacji przekształcenia Animacja będzie odtwarzana w pętli. Jeśli plik glTF zawiera wiele animacji, Podgląd scen odtworzy tylko pierwszą.
Zalecane limity	Ogólna wydajność zasobów zależy od ustawień i kompromisów między wierzchołkami, materiałami, rozdzielczością tekstur, siatką na materiał i innymi czynnikami. Skorzystaj z tych wskazówek, aby zoptymalizować komponenty. Liczba trójkątów: zalecany limit to 100 tys. trójkątów, ale kierowanie reklam na najniższą liczbę zapewni wysoką wydajność w Przeglądarce Scene. Idealny zakres to 30 000–50 000. Liczba materiałów: zalecany limit to 10 materiałów, z których 2 mogą być alfa. Aby zasób był skuteczny, ustaw kierowanie na najmniejszą możliwą liczbę. Siatka na materiał: 1 Maksymalna rozdzielczość tekstury: 2048 × 2048 Kość (w tym stawy nieważone): 254 (sztywny limit) Limit wagowy kości na wierzchołek: 4 (sztywny limit) UV: 1 UV na siatkę (sztywny limit) Rozmiar modelu: 10 MB (duże modele mogą negatywnie wpływać na wygodę użytkowników).
Obsługa Shadow	Twarde cienie są automatycznie renderowane przez Scene Viewer podczas umieszczania obiektu, dlatego odradzamy wypalanie cieni w modelu.
Obsługa tekstury	Format PNG: PNG-24, indeksowany PNG-8. W przypadku braku przezroczystości preferowane są pliki JPG, ponieważ zmniejszają rozmiar. Przestrzeń barw: sRGB
Materiał	Przygotowanie do egzaminów
Wczytywanie pliku	HTTPS
Scena	Oś: praworęczna, z tymi właściwościami: +X zgadza się +Y rośnie – punktów Z dalej od punktu początkowego (czyli „przód” zasobu powinien być w kierunku + Z) Skala: 1 jednostka = 1 metr (zgodnie ze specyfikacją glTF, która zapewnia umieszczenie modelu w AR w skali rzeczywistej)

Sprawdzanie poprawności modeli 3D za pomocą narzędzia podglądu

Aby mieć pewność, że plik modelu 3D będzie się prawidłowo wyświetlać w przeglądarce scen, sprawdź pliki na komputerze za pomocą naszego podglądu online.

Weryfikowanie modelu 3D

Aby zweryfikować model, narzędzie podglądu potrzebuje jednego pliku glb lub glTF, wszelkich powiązanych plików graficznych i bin oraz opcjonalnego pliku audio. Plik audio będzie odtwarzać się w pętli razem z animacją 0.

Możesz zaznaczyć wiele plików jednocześnie albo opcjonalnie umieścić plik glb lub glTF oraz powiązane z nim pliki w pliku ZIP. (Metoda polegająca na pliku ZIP nie obsługuje plików audio).

Aby sprawdzić model 3D:

1. Otwórz narzędzie podglądu online w przeglądarce.

2. Aby dodać pliki do narzędzia podglądu, użyj jednej z tych metod:

   • Przeciągnij i upuść. Wybierz plik glb lub glTF i wszystkie powiązane z nim pliki (lub plik ZIP zawierający te pliki), a następnie przeciągnij zaznaczone pliki lub pliki ZIP do narzędzia podglądu.

   • W narzędziu podglądu. W narzędziu podglądu wybierz Podgląd scen > Wczytaj plik. Wybierz plik glb lub glTF i wszystkie powiązane z nim pliki (lub plik ZIP zawierający te pliki) i kliknij Otwórz.

Po wczytaniu do narzędzia podglądu plików składających się z modelu 3D w konsoli u dołu przeglądarki wyświetlą się wyniki wraz z ewentualnymi komunikatami o błędach.

Dodawanie modeli 3D do walidacji

Aby zweryfikować model 3D, dodaj pliki składające się na model 3D do naszego narzędzia Edytor modeli.

Aby zweryfikować model, podgląd potrzebuje pliku glb lub glTF modelu, wszelkich powiązanych plików graficznych i binarnych oraz opcjonalnego pliku audio. Możesz zaznaczyć wiele plików lub dodać jeden plik ZIP.

Podczas dodawania pliku ZIP podgląd wczytuje pierwszy znaleziony plik glb lub glTF, a także powiązane pliki graficzne i binarne w tym pliku ZIP.

1. Otwórz narzędzie Edytor modeli w przeglądarce.

2. Aby dodać pliki do narzędzia podglądu, użyj jednej z tych metod:

   • Aby przeciągnąć i upuścić pliki w celu weryfikacji, zaznacz kilka plików glb lub glTF oraz wszystkie powiązane z nimi pliki (albo wybierz plik ZIP zawierający te pliki), a potem przeciągnij go do narzędzia podglądu.

   • Wybierz pliki z narzędzia podglądu. W narzędziu podglądu wybierz Podgląd scen > Wczytaj plik. Zaznacz plik glb lub glTF i wszystkie powiązane z nim pliki (lub plik ZIP zawierający te pliki) i kliknij Otwórz.

Błędy weryfikacji

Kod błędu	Poziom ważności	przekaz,	Bieżące obsługiwane wartości
INVALID_INPUT_FILE_EXTENSION	Błąd	Plik wejściowy [filename] ma rozszerzenie, którego walidator nie obsługuje.	['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED	Ostrzeżenie	Rozmiar pliku binarnego zawierającego dane wejściowe użytkownika przekracza limit zalecany w specyfikacji Scene Viewer, który wynosi [size] MB.	10
MAX_INPUT_BINARY_SIZE_EXCEEDED	Błąd	Rozmiar pliku binarnego zawierającego dane wejściowe użytkownika przekracza maksymalny limit określony w specyfikacji Scene Viewer, który wynosi [size] MB.	15
UNSUPPORTED_GLTF_EXTENSION_USED	Błąd	Rozszerzenie [ext] w pliku glTF nie jest obsługiwane w specyfikacji Scene Viewer.	['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED	Błąd	Liczba animacji w pliku glTF przekracza limit obsługiwany w specyfikacji Scene Viewer, który wynosi [num].	1
MORPH_TARGET_USED	Błąd	Plik glTF zawiera cel przekształcenia, który nie jest obsługiwany w specyfikacji Scene Viewer.
MATERIAL_LIMIT_EXCEEDED	Ostrzeżenie	Liczba materiałów w pliku glTF przekracza limit zalecany w specyfikacji Scene Viewer, który wynosi [num] materiałów.	10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED	Ostrzeżenie	Rozdzielczość obrazu w indeksie [idx] w pliku glTF przekracza limit zalecany w specyfikacji Scene Viewer, który wynosi [res] x [res].	2048 × 2048
UV_LIMIT_EXCEEDED	Błąd	Liczba UV na siatkę w pliku glTF przekracza limit obsługiwany w specyfikacji Scene Viewer, który wynosi maksymalnie [num] UV na siatkę.	1
VERTEX_COLOR_USED	Błąd	Plik glTF zawiera kolor wierzchołka, który nie jest obsługiwany w specyfikacji Scene Viewer.
JOINT_LIMIT_EXCEEDED	Błąd	Liczba złączeń w pliku glTF przekracza limit obsługiwany w specyfikacji Scene Viewer, który wynosi [num] złączy.	254
TRIANGLE_LIMIT_EXCEEDED	Ostrzeżenie	Liczba trójkątów w pliku glTF przekracza limit zalecany w specyfikacji Scene Viewer, który wynosi [num].	100 000
PRIMITIVE_MODE_UNSUPPORTED	Błąd	Tryb obiektów podstawowych [tryb] nie jest obsługiwany w specyfikacji Scene Viewer.	{4 : lista trójkątów, 5 : pasek trójkątny, 6 : wentylator trójkąta}
MISSING_PBR_METALLIC_ROUGHNESS	Informacje	W materiale w indeksie [idx] brakuje właściwości pbrMetallicRoughness. Jeśli zamiast tego stosowane są współczynniki chropowatości i metalu, nie jest to wymagane w specyfikacji Scene Viewer. Jeśli nie użyjesz żadnej z tych opcji, w przypadku materiału zostaną użyte wartości domyślne, co może spowodować niezamierzone zachowanie.