Scene Viewer verwenden, um interaktive 3D-Modelle in AR über eine Android-App oder einen Android-Browser anzuzeigen

Scene Viewer ist ein immersiver Viewer, der 3D- und AR-Erlebnisse über Ihre Website oder Android-App ermöglicht. Nutzer von Android-Mobilgeräten können damit ganz einfach eine Vorschau aufrufen, im Web gehostete 3D-Modelle in ihrer Umgebung platzieren, ansehen und mit ihnen interagieren.

Die meisten Android-Browser unterstützen den Scene Viewer. Scene Viewer wurde von vielen Google-Partnern erfolgreich implementiert, um 3D- und AR-Erlebnisse zuverlässig zu unterstützen. Außerdem unterstützt es diese Funktionen für die Google Suche.

Die Implementierung ist unkompliziert:

  • Für webbasierte Funktionen sind nur korrekt formatierte Links auf einer Webseite erforderlich.

  • Für die App-basierte Nutzung müssen nur wenige Zeilen Java-Code integriert werden.

Laufzeitanforderungen für Scene Viewer

Um AR mit Scene Viewer verwenden zu können, benötigen Nutzer Folgendes:

  • Ein von ARCore unterstütztes Gerät mit Android 7.0 Nougat (API-Level 24) oder höher
  • Eine aktuelle (aktuelle) Version der Google Play-Dienste für AR. Dieser Dienst wird auf den meisten Geräten mit ARCore-Unterstützung automatisch installiert und auf dem neuesten Stand gehalten.
  • Eine aktuelle Version der Google App. Diese App ist vorinstalliert und wird auf den meisten Geräten, die von ARCore unterstützt werden, automatisch aktualisiert.

Für Fälle, in denen Google Play-Dienste für AR oder die Google-App nicht vorhanden sind oder die installierten Versionen zu alt sind, kannst du eine Fallback-URL angeben, über die eine alternative Version aufgerufen wird, z. B. eine Webseite, eine Fehlermeldung oder eine von dir erstellte Fallback-Version.

Unterstützte Anwendungsfälle

Vorgesehener Anwendungsfall Empfohlene Anwendung Vorteile
Starten Sie über eine Schaltfläche oder einen Link auf einer Website oder in einer Android-App eine native AR-Ansicht eines 3D-Modells.

Wenn Google Play-Dienste für AR auf dem Gerät nicht vorhanden sind, zeigen Sie das Modell ordnungsgemäß im 3D-Modus, der vom Scene Viewer unterstützt wird.
Starten Sie Scene Viewer mit einem expliziten Intent für das Google Search-Paket und wählen Sie eine geeignete mode-Einstellung zum Anzeigen des 3D-Modells aus.
  • ar_preferred: Startet immer in einem AR-Viewer und Nutzer können manuell zum 3D-Viewer wechseln. Wenn Google Play-Dienste für AR nicht vorhanden ist, startet er automatisch im 3D-Viewer.
  • 3d_preferred: Startet immer in einem 3D-Viewer und Nutzer können manuell zu einem AR-Viewer wechseln. Wenn Google Play-Dienste für AR nicht vorhanden ist, können Nutzer den 3D-Viewer nicht verlassen.
  • 3d_only: Wird immer nur in einem 3D-Viewer angezeigt, ohne dass Nutzer zu einem AR-Viewer wechseln können.
  • Möglichst viele Geräte unterstützen
  • Bei Nicht-AR-Anwendungsfällen wird automatisch auf den nativen 3D-Modus des Scene Viewer zurückgegriffen.
Starten Sie über eine Schaltfläche oder einen Link auf einer Website oder in einer Android-App eine native AR-Ansicht eines 3D-Modells.

Wenn Google Play-Dienste für AR nicht auf dem Gerät vorhanden ist, kannst du das Fallback-Verhalten steuern.
Starte Scene Viewer mit einem expliziten Intent für Google Play-Dienste für AR (ARCore) und wähle eine geeignete mode-Einstellung für die Anzeige des 3D-Modells aus.
  • ar_preferred: Startet immer im AR-Viewer und Nutzer können manuell zum 3D-Viewer wechseln. Wenn Google Play-Dienste für AR nicht vorhanden ist, greift Scene Viewer auf das von dir konfigurierte Verhalten zurück.
  • ar_only: Wird immer nur im AR-Viewer angezeigt und kann nicht zum 3D-Viewer gewechselt werden. Wenn Google Play-Dienste für AR nicht vorhanden ist, kehren Sie zum von Ihnen konfigurierten Verhalten zurück. Du kannst beispielsweise deine eigene 3D-Vollbildansicht starten oder eine Fehlermeldung anzeigen, die darauf hinweist, dass das Gerät des Nutzers noch keine AR-Funktionen unterstützt.
Verwenden Sie Ihren eigenen 3D-Modell-Viewer oder stellen Sie eine andere Fallback-Antwort Ihres eigenen Designs für Anwendungsfälle ohne AR bereit.
Hoste eine Inline-Ansicht eines 3D-Modells auf deiner Website und ermögliche dem Nutzer, manuell in einen nativen AR-Vollbildmodus zu wechseln. Verwenden Sie <model-viewer> oder einen anderen webbasierten 3D-Viewer, um den Scene Viewer nativ zu starten und das 3D-Modell nativ in AR anzuzeigen.
  • Starten Sie Scene Viewer nativ in AR direkt aus einem 3D-Modell, das in eine Webseite eingebettet ist.
  • Du kannst Nutzern ein 3D-Erlebnis auf einer Oberfläche bieten, die du besitzt und die du verwaltest. Du hast die Möglichkeit, sie schrittweise zu einem immersiveren AR-Erlebnis zu verleiten, sobald du ihre Absicht kennst.

Scene Viewer mit einem expliziten Intent starten (3D oder AR)

Wenn Sie möglichst viele Android-Geräte unterstützen möchten, verwenden Sie einen expliziten Android-Intent, um Scene Viewer zu starten. Der explizite Intent kann von einer HTML-Seite oder einer nativen Android-App ausgelöst werden. Der Intent wird von der Google-App verarbeitet, die auf Android-Geräten mit ARCore-Unterstützung vorinstalliert ist.

Abhängig von den konfigurierten Intent-Parametern und Gerätefunktionen können interaktive 3D-Modelle in der Nutzerumgebung platziert oder in einem 3D-Viewer angezeigt werden.

  • Wenn Google Play-Dienste für AR auf dem Gerät installiert sind, wird das Modell im Szenenbetrachter in einer nativen AR- oder 3D-Ansicht angezeigt.

  • Wenn Google Play-Dienste für AR nicht vorhanden oder nicht auf dem neuesten Stand ist, zeigt der Scene Viewer das Modell wieder in der 3D-Ansicht an.

  • Wenn ein 3D-Modell nicht angezeigt werden kann, weil z. B. die Google App nicht installiert ist oder eine alte Version ist, wird mit dem Parameter S.browser_fallback_url stattdessen eine Fallback-Webseite angezeigt.

Scene Viewer über HTML oder Java starten

HTML

Verwenden Sie die folgende Syntax, um den expliziten Intent über HTML auszulösen:

<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

Verwenden Sie den folgenden Code, um den expliziten Intent aus Java auszulösen:

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

Intent-Versionsverwaltung

Die Intent-Version wird durch die Versionsnummer nach arvr.google.com/scene-viewer angegeben. Im ersten Release wurde beispielsweise Version 1.0 verwendet. Wenn neuere Scene Viewer-Funktionen erforderlich sind, können Sie Scene Viewer mit einer Version mit höherer Intent starten, die den erforderlichen Funktionen entspricht.

Intent-Version 1.1 unterstützt jetzt intent://-Links, die direkt in einer Android-App statt in einer URL gestartet werden können. Wenn Sie möchten, dass der Scene Viewer garantiert, dass diese Funktion beim Start verfügbar ist, aber sonst nicht gestartet wird, starten Sie den Scene Viewer mit dem Intent intent://arvr.google.com/scene-viewer/1.1.

Unterstützte Intent-Parameter

Die folgenden Parameter werden für einen expliziten Intent für das Google Search-Paket unterstützt.

Intent-Parameter Zulässige Werte Kommentare
file (Pflichtfeld) Gültige URL Diese URL gibt die glTF- oder glb-Datei an, die in den Scene Viewer geladen werden soll. Er sollte URL-Escaping verwendet werden.
S.browser_fallback_url (erforderlich für HTML-basierte Intents) Gültige URL Diese Google Chrome-Funktion wird nur für webbasierte Implementierungen unterstützt. Wenn die Google App nicht auf dem Gerät vorhanden ist, ist dies die URL, zu der Google Chrome navigiert.
mode (optional) 3d_preferred (Standard) Der Scene Viewer zeigt das Modell im 3D-Modus mit der Schaltfläche In meiner Umgebung ansehen an.



Wenn Google Play-Dienste für AR auf dem Gerät nicht vorhanden sind, ist die Schaltfläche In meinem Bereich ansehen ausgeblendet.

3d_only Scene Viewer wird mit dem 3D-Modell gestartet, auch wenn Google Play-Dienste für AR auf dem Gerät vorhanden sind. Die Schaltfläche In meinem Bereich ansehen wird nie angezeigt.

ar_preferred Scene Viewer wird im nativen AR-Modus als Einstiegsmodus gestartet. Der Nutzer kann über die Schaltflächen In meiner Umgebung ansehen und In 3D ansehen zwischen AR- und 3D-Modus wechseln.



Wenn Google Play-Dienste für AR nicht vorhanden ist, wechselt Scene Viewer automatisch in den 3D-Modus zurück.

ar_only Wenn Sie diesen Wert verwenden, sollten Sie ihn über einen expliziten Android-Intent zu com.google.ar.core starten.

Hinweis:Verwenden Sie nicht den ar_only-Modus, wenn Sie die Google App mit einem expliziten Android-Intent starten.

link (optional) Gültige URL Eine URL für eine externe Webseite. Sofern vorhanden, wird in der Benutzeroberfläche eine Schaltfläche angezeigt, die beim Anklicken eine Intention dieser URL darstellt.

title (optional) Gültiger String Ein Name für das Modell. Falls vorhanden, wird er auf der Benutzeroberfläche angezeigt. Der Name wird mit Auslassungspunkten nach 60 Zeichen abgeschnitten.

Ton (optional) Gültige URL Eine URL zu einer Audioschleife, die mit der ersten Animation synchronisiert ist, die in eine glTF-Datei eingebettet ist. Sie sollte zusammen mit einer glTF mit einer Animation von passender Länge bereitgestellt werden. Falls vorhanden, wird der Ton nach dem Laden des Modells in einer Schleife wiedergegeben. Er sollte URL-Escaping verwendet werden.
resizable (optional) true (Standard)

false

Wenn false festgelegt ist, können Nutzer das Modell nicht in der AR-Umgebung skalieren. Die Skalierung funktioniert in 3D normal.
enable_vertical_placement (optional) false (Standard)

true

Wenn true festgelegt ist, können Nutzer das Modell auf einer vertikalen Oberfläche platzieren.

UX-Anleitung

Um Nutzern die bestmögliche UX zu bieten, sollten die sichtbaren Calls-to-Action deutlich machen, dass der Nutzer im Begriff ist, eine immersive Umgebung zu betreten.

Für 3D-Viewer empfehlen wir einen Call-to-Action mit der Bezeichnung In 3D ansehen, der wie eines der folgenden Bilder aussieht:

Scene Viewer mit einem expliziten Intent für Google Play-Dienste für AR starten (nur AR-Modus)

Der AR-Modus im Scene Viewer wird von den Google Play-Diensten für AR unterstützt.

Damit AR im Scene Viewer verfügbar ist, können Sie einen expliziten Android-Intent von einer Website oder nativen Android-App verwenden, um Scene Viewer über die com.google.ar.core package zu starten und einen browser_fallback_url anzugeben. Auf diese Weise können Sie dafür sorgen, dass alle Nutzer entweder ein natives AR-Erlebnis im Scene Viewer oder ein selbst erstelltes Fallback-Erlebnis haben. Sie können beispielsweise Fallback-Funktionen wie Ihren eigenen 3D-Viewer oder eine anmutige Fehlermeldung erstellen.

Verwenden Sie die folgende Syntax, um den expliziten Intent über HTML auszulösen:

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

Verwenden Sie den folgenden Code, um den expliziten Intent aus Java auszulösen:

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

Unterstützte Intent-Parameter

Die folgenden Parameter werden für einen expliziten Intent für das Google Play Services for AR-Paket unterstützt.

Intent-Parameter Zulässige Werte Kommentare
browser_fallback_url (erforderlich für HTML-basierte Intents) Gültige URL Dies wird nur für webbasierte Implementierungen unterstützt. Wenn Google Play-Dienste für AR nicht auf dem Gerät vorhanden oder nicht auf dem neuesten Stand sind, ist dies die URL, die aufgerufen wird.
mode (optional) ar_only Scene Viewer startet das 3D-Modell immer in einer nativen AR-Ansicht und blendet UI-Elemente für den Wechsel zum 3D-Viewer aus.

Wenn Google Play-Dienste für AR nicht vorhanden ist, startet Scene Viewer die URL, die du in der browser_fallback_url für webbasierte Inhalte festgelegt hast. Bei app-basierten Funktionen greift Scene Viewer auf eine alternative Oberfläche zurück, z. B. auf eine Fehlermeldung oder eine andere selbst erstellte Version.

ar_preferred Scene Viewer wird im nativen AR-Modus als Einstiegsmodus gestartet und bietet Nutzern die Möglichkeit, über die Schaltflächen In meiner Umgebung ansehen und In 3D ansehen zwischen AR- und 3D-Modus zu wechseln.

Wenn Google Play-Dienste für AR nicht vorhanden ist, startet Scene Viewer die URL, die du in der browser_fallback_url für webbasierte Inhalte festgelegt hast. Bei app-basierten Funktionen greift Scene Viewer auf eine alternative Oberfläche zurück, z. B. auf eine Fehlermeldung oder eine andere selbst erstellte Version.

   

link (optional) Gültige URL Eine URL für eine externe Webseite. Sofern vorhanden, wird in der UI eine Schaltfläche angezeigt, die beim Anklicken eine Intention dieser URL darstellt.



In Version 1.1 wurde Unterstützung für intent://-Links im Scene Viewer hinzugefügt, damit die Schaltfläche „Scene Viewer“ direkt in anderen Apps ausgelöst werden kann. Dies sollte mit Vorsicht verwendet und nur angegeben werden, wenn für den angegebenen Intent garantiert ein Intent-Handler vorhanden ist.
title (optional) Gültiger String Ein Name für das Modell. Falls vorhanden, wird er auf der Benutzeroberfläche angezeigt. Der Name wird mit Auslassungspunkten nach 60 Zeichen abgeschnitten.



In Version 1.1 wurde Unterstützung für den HTML-Stil von Titelinhalten hinzugefügt. Text ist beliebig vieler Text zulässig. Beachten Sie, dass der Titel mit URL-Escape-Zeichen angegeben werden muss.
sound (optional) Gültige URL Eine URL zu einer Audioschleife, die mit der ersten Animation synchronisiert ist, die in eine glTF-Datei eingebettet ist. Sie sollte zusammen mit einer glTF mit einer Animation von passender Länge bereitgestellt werden. Falls vorhanden, wird der Ton nach dem Laden des Modells in einer Schleife wiedergegeben.
resizable (optional) true (Standard)

false

Wenn false festgelegt ist, können Nutzer das Modell nicht in der AR-Umgebung skalieren. Die Skalierung funktioniert in 3D normal.
disable_occlusion (optional) false (Standard)

true

Wenn true festgelegt ist, erscheinen Objekte in der Szene immer vor realen Objekten. Weitere Informationen finden Sie unter [Verdeckung aktivieren](/ar/develop/depth#enable_occlusion).

UX-Anleitung

Um Nutzern die bestmögliche Nutzererfahrung zu bieten, empfehlen wir, diese Richtlinien zu befolgen.

  • Bei AR-Erlebnissen sollte der sichtbare Call-to-Action deutlich machen, dass der Nutzer im Begriff ist, in eine immersive Umgebung zu gelangen. Wir empfehlen die Verwendung des Call-to-Action In meinem Bereich ansehen:

  • Es kann sein, dass Nutzer Google Play-Dienste für AR nicht auf ihrem Gerät installiert haben. So verarbeitet <model-viewer> das Fallback. Sie können dieses Code-Snippet als Ausgangspunkt verwenden.

    // 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> verwenden, um Scene Viewer zu starten

Sie können Scene Viewer über Ihre Website aktivieren, indem Sie die Webkomponente <model-viewer> in das Attribut ar aufnehmen.

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

Auf einem ARCore-unterstützten Android-Gerät wird auf einer Website, die die Komponente <model-viewer> mit dem Attribut ar enthält, eine Schaltfläche wie im folgenden Beispiel angezeigt.

Wenn der scene-viewer-Modus in ar-modes verwendet wird, wechselt er zu einer nativen AR-Ansicht und lädt den Nutzer ein, das Modell mithilfe von Scene Viewer in seiner Umgebung zu platzieren.

Wenn Google Play-Dienste mit AR nicht vorhanden sind, wird das Modell durch Tippen auf diese Schaltfläche im 3D-Viewer von <model-viewer> angezeigt.

Weitere Informationen zu den ersten Schritten mit <model-viewer> finden Sie in der Dokumentation zu <model-viewer>.

Dateianforderungen an Modelle

Für Scene Viewer gelten die folgenden Unterstützungs- und Einschränkungen für Modelle.

Unterstützte Dateiformate glTF 2.0/glb mit diesen Erweiterungen:
  • KHR_materials_unlit
  • KHR_texture_transform
Animation
  • Skelettanimation als Schleife wiedergeben
  • Starre Animation als Schleife wiedergeben
  • Transformationsanimation als Schleife wiedergeben
Die Animation wird in einer Schleife abgespielt. Wenn die Datei glTF mehrere Animationen enthält, spielt Scene Viewer nur die erste Animation ab.
Empfohlene Limits Die Gesamtleistung von Assets hängt von den festgelegten Einschränkungen und den Kompromissen zwischen Eckpunkten, Materialien, Texturauflösung, Mesh pro Material und anderen Faktoren ab. Beachten Sie beim Optimieren Ihrer Assets die folgenden Richtlinien.
  • Anzahl der Dreiecke: Die empfohlene Grenze liegt bei 100.000 Dreiecken. Wenn Sie jedoch die niedrigste Anzahl auswählen, bleibt die Leistung im Scene Viewer konstant. 30.000 bis 50.000 ist ein idealer Bereich.
  • Anzahl der Materialien: Es werden zehn Materialien empfohlen, von denen zwei Alpha sein können. Wählen Sie die geringstmögliche Anzahl aus, um eine gute Leistung des Assets zu gewährleisten.
  • Mesh-Netzwerk pro Material: 1
  • Maximale Texturauflösung: 2.048 × 2.048
  • Knochen (einschließlich nicht gewichteter Gelenke): 254 (hartes Limit)
  • Limit für Knochengewichte pro Scheitelpunkt: 4 (festes Limit)
  • UV: 1 UV pro Mesh (festes Limit)
  • Modellgröße: 10 MB. Größere Modelle können zu einer schlechten Nutzererfahrung führen.
Schattenunterstützung Harte Schatten werden vom Scene Viewer automatisch gerendert, wenn Sie ein Objekt platzieren. Daher raten wir davon ab, Schatten in Ihr Modell einzubetten.
Texturunterstützung
  • PNG-Format: PNG-24, PNG-8 mit indiziertem Format.
    JPGs werden bevorzugt, wenn keine Transparenz vorhanden ist, da sie die Größe verringern.
  • Farbraum: sRGB
Material PBR
Datei wird geladen HTTPS
Szene
  • Achse: rechtshändig, mit folgenden Eigenschaften:
    • +X ist richtig
    • +Y ist gestiegen
    • -Z vom Ursprung aus vorwärts zeigt (mit anderen Worten, die Vorderseite eines Assets sollte auf +Z ausgerichtet sein)
  • Skalierung: 1 Einheit = 1 Meter (wie in der glTF-Spezifikation definiert, um sicherzustellen, dass das Modell in AR im richtigen Maßstab platziert wird)

Vorschautool zum Validieren von 3D-Modellen verwenden

Damit Ihre 3D-Modelldatei richtig im Scene Viewer angezeigt wird, können Sie die Dateien auf Ihrem PC mit unserem Onlinevorschautool validieren.

3D-Modell validieren

Zum Validieren eines Modells benötigt das Previewer-Tool eine glb- oder glTF-Datei, alle verknüpften Bild- und BIN-Dateien sowie eine optionale Audiodatei. Die Audiodatei wird in einer Schleife mit Animation 0 wiedergegeben.

Sie können mehrere einzelne Dateien auswählen oder optional die glb- oder glTF-Datei und die zugehörigen Dateien in eine ZIP-Datei einfügen. Audiodateien werden bei der Methode "zip file" nicht unterstützt.

So validieren Sie Ihr 3D-Modell:

  1. Öffnen Sie das Online Previewer-Tool in einem Browser.

  2. Verwenden Sie eine der folgenden Methoden, um die Dateien zum Previewer-Tool hinzuzufügen:

    • Drag-and-drop: Wählen Sie eine glb- oder glTF-Datei und alle zugehörigen Dateien (oder eine ZIP-Datei mit diesen Dateien) aus und ziehen Sie die ausgewählten Dateien oder die ausgewählte ZIP-Datei in das Previewer-Tool.

    • Über das Previewer-Tool: Wählen Sie im Previewer-Tool Szenenbetrachter > Datei laden aus. Wählen Sie eine glb- oder glTF-Datei und alle zugehörigen Dateien (oder eine ZIP-Datei mit diesen Dateien) aus und klicken Sie auf Öffnen.

Nachdem Sie die Dateien Ihres 3D-Modells in das Previewer-Tool geladen haben, werden die Ergebnisse, einschließlich etwaiger Fehlermeldungen, in einer Konsole unten im Browser angezeigt.

3D-Modelle zur Validierung hinzufügen

Wenn Sie ein 3D-Modell validieren möchten, fügen Sie die Dateien, aus denen das 3D-Modell besteht, unserem Modelleditor-Tool hinzu.

Zum Validieren eines Modells benötigt der Previewer die glb- oder glTF-Datei des Modells, alle zugehörigen Bild- und BIN-Dateien sowie eine optionale Audiodatei. Sie können mehrere einzelne Dateien auswählen oder eine einzelne ZIP-Datei hinzufügen.

Beim Hinzufügen einer ZIP-Datei lädt die Vorschau die erste gefundene glb- oder glTF-Datei sowie die zugehörigen Image- und bin-Dateien in dieser ZIP-Datei.

  1. Öffnen Sie den Modelleditor in einem Browser.

  2. Verwenden Sie eine der folgenden Methoden, um die Dateien zum Previewer-Tool hinzuzufügen:

    • Wenn Sie Dateien zur Validierung per Drag-and-drop hinzufügen möchten, wählen Sie die glb- oder glTF-Datei und alle zugehörigen Dateien mehrfach aus (oder wählen Sie eine ZIP-Datei mit diesen Dateien aus) und ziehen Sie sie in das Previewer-Tool.

    • Dateien aus dem Previewer-Tool auswählen Wählen Sie im Previewer-Tool Szenenbetrachter > Datei laden aus. Wählen Sie die glb- oder glTF-Datei und alle zugehörigen Dateien (oder eine ZIP-Datei, die diese Dateien enthält) mehrfach aus und klicken Sie auf Öffnen.

Validierungsfehler

Fehlercode Schweregrad die Botschaft und Aktuell unterstützte Werte
INVALID_INPUT_FILE_EXTENSION Fehler Die Dateiendung der Eingabedatei [filename] wird vom Validator nicht unterstützt. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED Warnung Die binäre Größe der bereitgestellten Nutzereingabe liegt über dem von der Scene Viewer-Spezifikation empfohlenen Wert von [size] MB. 10
MAX_INPUT_BINARY_SIZE_EXCEEDED Fehler Die binäre Größe der bereitgestellten Nutzereingabe liegt über der von der Scene Viewer-Spezifikation unterstützten Höchstgrenze von [size] MB. 15
UNSUPPORTED_GLTF_EXTENSION_USED Fehler Die Erweiterung [ext] in der glTF wird von der Scene Viewer-Spezifikation nicht unterstützt. ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED Fehler Die Anzahl der Animationen in der glTF überschreitet die von der Scene Viewer-Spezifikation unterstützte Anzahl (maximal [num] Animationen). 1
MORPH_TARGET_USED Fehler Die glTF enthält ein Morph-Ziel, das von der Scene Viewer-Spezifikation nicht unterstützt wird.
MATERIAL_LIMIT_EXCEEDED Warnung Die Anzahl der Materialien in der glTF überschreitet den von der Scene Viewer-Spezifikation empfohlenen Grenzwert (maximal [num] Materialien). 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED Warnung Die Auflösung des Bildes bei Index [idx] in der glTF überschreitet den von der Scene Viewer-Spezifikation empfohlenen Grenzwert, der eine maximale Auflösung von [res] x [res] ist. 2048 x 2048
UV_LIMIT_EXCEEDED Fehler Die Anzahl der UV pro Mesh in der glTF überschreitet den von der Scene Viewer-Spezifikation unterstützten Grenzwert, der maximal [num] UV pro Mesh beträgt. 1
VERTEX_COLOR_USED Fehler Die glTF enthält eine Vertexfarbe, die von der Scene Viewer-Spezifikation nicht unterstützt wird.
JOINT_LIMIT_EXCEEDED Fehler Die Anzahl der Verbindungen in der glTF überschreitet die von der Scene Viewer-Spezifikation unterstützte Anzahl (maximal [num] Verbindungen). 254
TRIANGLE_LIMIT_EXCEEDED Warnung Die Anzahl der Dreiecke in der glTF überschreitet die von der Scene Viewer-Spezifikation empfohlene Anzahl (maximal [num] Dreiecke). 100.000
PRIMITIVE_MODE_UNSUPPORTED Fehler Der primitive Modus [mode] wird von der Scene Viewer-Spezifikation nicht unterstützt. {4 : Dreieckliste, 5 : Dreieckstreifen, 6 : Dreiecksventil}
MISSING_PBR_METALLIC_ROUGHNESS Informationen Im Material am Index [idx] fehlt das Attribut pbrMetallicRoughness. Dies ist in der Scene Viewer-Spezifikation nicht erforderlich, wenn stattdessen die Faktoren Metall und Rauheit verwendet werden. Wird keine dieser Optionen verwendet, werden für das Material Standardwerte verwendet, was zu unerwünschtem Verhalten führen kann.