Utiliser Scene Viewer pour afficher des modèles 3D interactifs en RA à partir d'une application Android ou d'un navigateur

Scene Viewer est une visionneuse immersive qui vous permet de profiter d'expériences 3D et RA à partir de votre un site Web ou une application Android. Il permet aux utilisateurs d'appareils mobiles Android de prévisualiser de placer, d'afficher et d'interagir avec des modèles 3D hébergés sur le Web dans leur environnement.

La plupart des navigateurs Android sont compatibles avec Scene Viewer. La visionneuse de scène a bien été activée implémentés par de nombreux partenaires Google pour offrir une expérience 3D et RA fiable. Il optimise également ces expériences pour la recherche Google.

L'implémentation est simple:

• Les expériences Web ne nécessitent que des liens correctement mis en forme sur une page Web.

• Les expériences basées sur les applications ne nécessitent que l'intégration de quelques lignes de code Java.

Exigences d'exécution de Scene Viewer

Pour découvrir la RA avec Scene Viewer, les utilisateurs doivent:

• Un appareil compatible ARCore exécutant Android 7.0 Nougat (niveau d'API 24) ou version ultérieure
• Une version à jour (récente) de Services Google Play pour la RA Ce service est automatiquement installé et mis à jour sur le site la majorité des appareils compatibles avec ARCore.
• Une version à jour des Google l'application. Cette application est préinstallée et se met à jour automatiquement sur la grande majorité des appareils compatibles avec ARCore.

Pour permettre les cas où les services Google Play pour la RA ou l'appli Google sont absents ou si les versions installées sont trop anciennes, vous pouvez spécifier une création de remplacement URL qui lance une autre expérience (par exemple, une page Web ou une erreur) ou une expérience de remplacement que vous avez créée.

Cas d'utilisation compatibles

Lancer Scene Viewer à l'aide d'un intent explicite (3D ou RA)

Pour prendre en charge la plus large gamme d'appareils Android, utilisez un code Android explicite l'intention pour lancer Scene Viewer. L'intent explicite peut être déclenché à partir d'une page HTML. ou une application Android native. L'intent sera géré par Google préinstallée sur les appareils Android compatibles ARCore.

Selon les paramètres d'intent configurés et les capacités de l'appareil, Les modèles 3D peuvent être placés dans l'environnement de l'utilisateur ou s'afficher dans une visionneuse 3D.

• Si les services Google Play pour la RA sont présents et à jour sur l'appareil, Scene Viewer affiche le modèle dans une vue native en RA ou dans une vue 3D.

• Si les services Google Play pour la RA ne sont pas disponibles ou s'ils ne sont pas à jour, Scène La visionneuse revient progressivement à l'affichage du modèle en vue 3D.

• Si un modèle 3D ne peut pas être affiché, par exemple, Google application n'est pas installée ou est une ancienne version, l'S.browser_fallback_url sera utilisé pour afficher une page Web de remplacement à la place.

Lancer Scene Viewer à partir d'un code HTML ou Java

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

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

Gestion des versions des intents

La version de l'intent est indiquée par le numéro de version situé après arvr.google.com/scene-viewer Par exemple, la version initiale utilisée version 1.0. Lorsque les nouvelles fonctionnalités de Scene Viewer sont requises, peut lancer Scene Viewer avec une version d'intent plus élevée correspondant à les fonctionnalités dont vous avez besoin.

La version 1.1 d'Intent est compatible avec les liens intent://, qui peuvent être lancés directement dans une application Android plutôt que vers une URL. Si vous préférez la scène Lecteur pour garantir que cette fonctionnalité sera disponible au lancement et échouer Sinon, lancez la visionneuse de scène avec l'intention intent://arvr.google.com/scene-viewer/1.1

Paramètres d'intent compatibles

Les paramètres suivants sont pris en charge pour un intent explicite destiné à la Rechercher un package.

Paramètre d'intent	Valeurs autorisées	Commentaires
file (obligatoire)	Une URL valide	Cette URL spécifie le fichier glTF ou glb à charger dans Scene Viewer. Il doit s'agir d'une URL avec échappement.
S.browser_fallback_url (obligatoire pour les intents basés sur HTML)	Une URL valide	Cette fonctionnalité de Google Chrome n'est compatible qu'avec les implémentations Web. Lorsque l'appli Google est absente de l'appareil, il s'agit de l'URL vers laquelle Google Chrome accède.
mode (facultatif)	3d_preferred (par défaut)	Scene Viewer affiche le modèle en mode 3D à l'aide du bouton View in your space (Visualiser dans votre espace). Si les services Google Play pour la RA ne sont pas disponibles sur l'appareil, le Le bouton Afficher dans votre espace est masqué.
	3d_only	Scene Viewer démarre avec le modèle affiché en mode 3D, même si Services Google Play pour la RA sont présents sur l'appareil. Le bouton Voir chez vous ne s'affiche jamais.
	ar_preferred	Scene Viewer démarre en mode natif RA en tant que mode d'entrée. L'utilisateur reçoit la possibilité de basculer entre les modes RA et 3D via le Boutons Voir chez vous et Voir en 3D. En l'absence de services Google Play pour la RA, Scene Viewer tombe progressivement. revenir au mode 3D comme mode d'entrée.
	ar_only	Lorsque vous utilisez cette valeur, vous devez effectuer le lancement via un intent Android explicite à com.google.ar.core. Remarque:N'utilisez pas le mode ar_only lors du lancement via intent Android explicite dans l'appli Google.
link (facultatif)	Une URL valide	URL d'une page Web externe. S'il est présent, un bouton s'affichera dans l'interface utilisateur qui redirige vers cette URL lorsque l'utilisateur clique dessus.
title (facultatif)	Chaîne valide	Nom du modèle. S'il est présent, il sera affiché dans l'interface utilisateur. Au-delà de 60 caractères, le nom sera tronqué et comporte des points de suspension.
son (facultatif)	Une URL valide	URL d'une piste audio en boucle synchronisée avec la première une animation intégrée dans un fichier glTF. Il doit être fourni avec glTF avec une animation de durée correspondante. S'il est présent, le son est lu en boucle après le chargement du modèle. Il doit s'agir d'une URL avec échappement.
resizable (facultatif)	true (par défaut) false	Si la valeur est false, les utilisateurs ne peuvent pas mettre le modèle à l'échelle dans l'expérience de RA. La mise à l'échelle fonctionne normalement en 3D.
enable_vertical_placement (facultatif)	false (par défaut) true	Si la valeur est true, les utilisateurs peuvent placer le modèle sur un à la surface verticale.

Conseils sur l'expérience utilisateur

Afin d'offrir la meilleure expérience utilisateur possible, nous recommandons que les appels visibles à l'action signifient que l'utilisateur est sur le point d’entrer dans un environnement immersif.

Pour une expérience de visionnage 3D, nous vous recommandons d'utiliser une incitation à l'action intitulée Voir en 3D. qui ressemble à l'une des images suivantes:

Lancer Scene Viewer avec un intent explicite pour les services Google Play pour la RA (mode RA uniquement)

Le mode RA de Scene Viewer est fourni par les services Google Play pour la RA.

Pour vous assurer que la RA est disponible dans Scene Viewer, vous pouvez utiliser une image explicite d'Android l'intention à partir d'un site Web ou d'une application Android native pour lancer Scene Viewer com.google.ar.core package et spécifiez un browser_fallback_url. De cette façon, vous peut garantir que tous les utilisateurs bénéficient d'une expérience de RA native via Scene Viewer une expérience de remplacement que vous avez créée vous-même. Par exemple, vous pouvez créer des expériences de remplacement, telles que votre propre visionneuse 3D ou un message d'erreur correct.

Pour déclencher l'intent explicite à partir du code HTML, utilisez la syntaxe suivante:

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

Pour déclencher l'intent explicite à partir de Java, utilisez le code suivant:

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

Paramètres d'intent compatibles

Les paramètres suivants sont compatibles avec un intent explicite pour Google Play Services pour le package RA

Paramètre d'intent	Valeurs autorisées	Commentaires
browser_fallback_url (obligatoire pour les intents basés sur HTML)	Une URL valide	Cette option n'est disponible que pour les implémentations Web. Lorsque les services Google Play pour la RA ne sont pas disponibles sur l'appareil ou qu'ils ne sont pas situés il s'agit de l'URL à laquelle il accède.
mode (facultatif)	ar_only	Scene Viewer lance toujours le modèle 3D dans une vue RA native et masque les UI permettant de passer à la visionneuse 3D de Scene Viewer Si les services Google Play pour la RA ne sont pas présents, Scene Viewer lance l'URL. que vous avez défini dans browser_fallback_url pour les expériences Web. Pour les expériences basées sur les applications, Scene Viewer utilise une autre expérience. comme un message d'erreur ou une autre expérience que vous avez créée vous-même.
	ar_preferred	Scene Viewer est lancé en mode d'entrée natif en RA et fournit aux utilisateurs la possibilité de basculer entre le mode RA et le mode 3D via l'onglet Visualiser chez vous ; et Afficher en 3D. Si les services Google Play pour la RA ne sont pas présents, Scene Viewer lance l'URL. que vous avez défini dans browser_fallback_url pour les expériences Web. Pour les expériences basées sur les applications, Scene Viewer utilise une autre expérience. comme un message d'erreur ou une autre expérience que vous avez créée vous-même.
link (facultatif)	Une URL valide	URL d'une page Web externe. S'il est présent, un bouton s'affichera dans la UI qui renvoie vers cette URL lorsqu'un utilisateur clique dessus. La version 1.1 prend en charge les liens intent:// dans Scene Viewer dans pour permettre au bouton de visite de Scene Viewer d'autres applications. Il doit être utilisé avec précaution et ne doit être utilisé spécifié lorsqu'un gestionnaire d'intent est garanti pour être présent un intent donné.
title (facultatif)	Chaîne valide	Nom du modèle. S'il est présent, il sera affiché dans l'interface utilisateur. Au-delà de 60 caractères, le nom sera tronqué et comporte des points de suspension. La version 1.1 accepte désormais les styles HTML pour le contenu du titre, avec une quantité arbitraire de texte autorisée. Notez que le titre doit être échappé au format URL.
sound (facultatif)	Une URL valide	URL d'une piste audio en boucle synchronisée avec la première animation. intégrés dans un fichier glTF... Il doit être fourni avec un fichier glTF avec une Animation de durée correspondante. Le cas échéant, le son est activé en boucle après l'événement est chargé.
resizable (facultatif)	true (par défaut) false	Si la valeur est false, les utilisateurs ne peuvent pas mettre le modèle à l'échelle dans l'expérience de RA. La mise à l'échelle fonctionne normalement en mode 3D.
disable_occlusion (facultatif)	false (par défaut) true	Si la valeur est true, les objets placés dans la scène apparaissent toujours devant des objets du monde réel dans la scène. Voir Pour en savoir plus, [activez l'occlusion](/ar/develop/depth#enable_occlusion).

Conseils sur l'expérience utilisateur

Pour offrir la meilleure expérience utilisateur possible aux utilisateurs, nous vous recommandons de suivre ces consignes.

• Pour les expériences de RA, l'incitation à l'action visible doit indiquer que l'utilisateur est sur le point d'entrer dans un environnement immersif. Nous vous recommandons d'utiliser la Afficher dans votre espace incitation à l'action:
  

• Il est possible que les utilisateurs n'aient pas Services Google Play pour la RA installée sur son appareil. Voici comment <model-viewer> gère la création de remplacement et vous pouvez utiliser cet extrait de code comme point de départ.

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

Utiliser <model-viewer> pour lancer Scene Viewer

Vous pouvez activer Scene Viewer sur votre site Web en incluant le paramètre Composant Web <model-viewer> avec le composant ar.

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

Lorsqu'il est consulté sur un appareil Android compatible ARCore, un site Web qui inclut le Le composant <model-viewer> avec l'attribut ar affiche un bouton, comme illustré dans l'exemple suivant.

Lorsque le mode scene-viewer est utilisé dans ar-modes, il passe à une vue RA native et invite l'utilisateur à placer le modèle dans son environnement à l'aide de Scene Viewer.

En l'absence des services Google Play en RA, appuyez sur ce bouton pour afficher le modèle dans la visionneuse 3D de <model-viewer>.

Consultez la documentation sur <model-viewer> pour savoir comment faire vos premiers pas avec <model-viewer>.

Exigences relatives aux fichiers des modèles

La compatibilité et les limites de Scene Viewer pour les modèles sont les suivantes.

Utiliser l'outil de prévisualisation pour valider vos modèles 3D

Pour vous assurer que votre fichier de modèle 3D s'affichera correctement dans Scene Viewer, utilisez notre outil de prévisualisation en ligne pour valider les fichiers sur votre PC.

Valider votre modèle 3D

Pour valider un modèle, l'outil de prévisualisation a besoin d'un fichier glb ou glTF, les fichiers image et bin associés, et un fichier audio facultatif. Le fichier audio sera en boucle avec l'animation 0.

Vous pouvez sélectionner plusieurs fichiers individuels, ou insérer, si vous le souhaitez, les fichiers glb ou glTF et ses fichiers associés dans un fichier zip. (La méthode de fichier zip n'est pas compatible avec l'audio files.)

Pour valider votre modèle 3D:

1. Ouvrez l'outil de prévisualisation en ligne. dans un navigateur.

2. Utilisez l'une des méthodes suivantes pour ajouter les fichiers à l'outil de prévisualisation:

   • Glisser-déposer. Sélectionnez un fichier glb ou glTF, ainsi que tous les fichiers (ou un fichier ZIP contenant ces fichiers), puis faites glisser les fichiers ou zip à l'outil de prévisualisation.

   • Depuis l'outil de prévisualisation : Dans l'outil de prévisualisation, sélectionnez Scene Viewer > Charger le fichier. Sélectionnez un fichier glb ou glTF et tous ses fichiers associés (ou un fichier ZIP contenant ces fichiers), puis cliquez sur Ouvrir.

Après avoir chargé les fichiers de votre modèle 3D dans l'outil de prévisualisation, une console en bas du navigateur affiche les résultats, y compris les messages d'erreur.

Ajouter des modèles 3D pour la validation

Pour valider un modèle 3D, ajoutez les fichiers qui le composent à notre Éditeur de modèles.

Pour valider un modèle, l'outil de prévisualisation a besoin du fichier glb ou glTF du modèle, les fichiers image et bin associés, et un fichier audio facultatif. Vous pouvez sélectionner plusieurs éléments des fichiers individuels ou ajouter un seul fichier zip.

Lors de l'ajout d'un fichier zip, l'outil de prévisualisation charge le premier fichier glb ou glTF trouvé, ainsi que les fichiers image et bin associés dans ce fichier zip.

1. Ouvrez l'éditeur de modèle. dans un navigateur.

2. Utilisez l'une des méthodes suivantes pour ajouter les fichiers à l'outil de prévisualisation:

   • Pour glisser-déposer des fichiers pour validation, sélectionnez plusieurs fois le fichier glb ou glTF et tous les fichiers associés (ou sélectionnez un fichier ZIP contenant ces fichiers), et je la fais glisser dans l'outil de prévisualisation.

   • Sélectionner des fichiers dans l'outil de prévisualisation Dans l'outil de prévisualisation, sélectionnez Scene Viewer > Charger le fichier. Sélectionnez le fichier glb ou glTF, ainsi que tous les fichiers (ou un fichier ZIP contenant ces fichiers), puis cliquez sur Ouvrir.

Erreurs de validation