VPS
Introduction
Grâce au système de positionnement visuel (VPS) de Niantic, les développeurs peuvent créer de riches expériences de RA de localisation qui superposent du contenu virtuel au monde physique. Le contenu WebAR peut être ancré dans le monde réel, ce qui permet aux objets virtuels d'interagir avec leur environnement physique. L'expérience de la réalité augmentée devient ainsi plus personnelle, plus significative et plus immersive, et donne aux utilisateurs de nouvelles raisons d'explorer le monde qui les entoure.
Dans Studio, plusieurs outils et fonctionnalités vous aident à créer des expériences de Location AR (ou VPS).
- Navigateur géospatial : Recherchez, prévisualisez et sélectionnez différents lieux compatibles avec le SPV à l'aide du navigateur géospatial. Pour plus de détails, voir la section Utilisation du navigateur géospatial ci-dessous.
- Localisations dans Studio : Dans la hiérarchie des scènes, les "emplacements" sont un type d'entité qui permet de positionner et de configurer le contenu en fonction du monde réel, lorsque des objets sont ajoutés en tant qu'objets enfants. Ces éléments de localisation servent de guide visuel pour positionner avec précision le contenu, les effets et les interactions dans votre scène, ou peuvent être utilisés comme texture/modèle 3D, inclus en tant qu'élément de la scène. Pour plus de détails, voir la section "Développer des expériences de RA sur place" ci-dessous.
- Simulateur AR de lieu : Dans le menu d'options du simulateur, vous pouvez sélectionner le lieu ajouté à votre projet, et vous pouvez voir et vous déplacer dans votre expérience de réalité augmentée au fur et à mesure qu'elle se déroule. Plus de détails dans la section "Simulation d'expériences de RA sur le terrain" ci-dessous.
Pour créer de nouveaux lieux où vous souhaitez activer la RA de localisation, nous recommandons aux développeurs d'utiliser l'application Scaniverse App. Pour plus de détails sur l'utilisation de Scaniverse et la demande de nouveaux sites pour l'activation du SPV, voir la section Création de nouveaux sites activés pour le SPV ci-dessous.
Utilisation du navigateur géospatial
Ce qui distingue Niantic VPS, c'est sa carte mondiale croissante de plus de 600 000 emplacements activés par VPS, élaborée à partir de millions de scans soumis par la communauté des développeurs et des joueurs de Niantic. Ces lieux centrés sur l'humain sont optimisés pour des interactions haute-fidélité et des expériences de RA immersives. Le maillage de chaque site est créé en combinant des dizaines de scans individuels pour former un modèle 3D détaillé et de haute qualité. Et comme de nouveaux lieux sont ajoutés chaque semaine, la carte ne cesse de s'étendre. Utilisez le navigateur géospatial disponible dans Studio pour rechercher ces emplacements.
Le navigateur géospatial (GSB) est accessible à partir de votre projet en sélectionnant l'icône de carte en haut à droite de la fenêtre de visualisation. En utilisant le GSB élargi, vous pouvez effectuer des recherches pour trouver des lieux activés par le SPV. La sélection d'un lieu activé par VPS affichera le maillage 3D du lieu afin que vous puissiez vérifier que vous avez sélectionné le bon lieu et l'ajouter à votre projet.
**Par défaut, TOUS les lieux, qu'ils soient activés ou en attente d'activation, s'affichent lors de la recherche initiale dans le navigateur géospatial. Utilisez l'option Filtre > Statut si vous souhaitez masquer les lieux qui ne sont pas encore activés.
Si l'emplacement que vous souhaitez utiliser dans votre projet n'est pas disponible en tant qu'emplacement VPS, vous pouvez le créer en suivant les instructions de la section Créer un nouvel emplacement.
Sélectionnez Ajouter un lieu dans la vue détaillée pour ajouter le lieu à votre projet.
Filtrage des lieux
Dans le navigateur géospatial, vous verrez différents filtres de recherche que vous pouvez appliquer, comme la taille (zone jouable, catégorie et statut VPS).
Statut : Fait référence à la capacité du lieu à se localiser à tout moment. Une fois qu'un lieu a été activé par le VPS, Niantic fournit une évaluation de la qualité dans le navigateur géospatial : Qualité moyenne ou Bonne qualité. Les sites disposant de plusieurs numérisations dans tous les types d'éclairage ont tendance à être de meilleure qualité. Par défaut, TOUS les lieux, qu'ils soient activés ou en attente d'activation, s'affichent lors de la recherche initiale dans le navigateur géospatial. Utilisez les options de filtrage de l'état si vous souhaitez masquer les lieux qui ne sont pas encore activés.
Note : L'évaluation de la qualité est un processus automatisé et peut ne pas refléter la performance réelle du site. La meilleure façon de déterminer la qualité est de l'essayer soi-même.
Détails de l'emplacement
Lorsque vous sélectionnez un lieu dans le navigateur géospatial, vous pouvez en savoir plus sur son indice de qualité VPS, ainsi que sur le fait qu'il s'agisse d'un lieu accessible au public ou d'un lieu en attente.
Type : Dans le navigateur géospatial, vous verrez trois types de lieux différents.
Type | Icône | Description |
---|---|---|
Public | Les lieux "publics" ont été approuvés par l'équipe Trust & Safety de Niantic et répondent aux critères de sécurité et d'accessibilité au public. Ces lieux peuvent être utilisés dans des projets publiés. | |
En attente | Les emplacements "en attente" sont examinés par l'équipe Trust & Safety de Niantic afin de déterminer s'ils répondent aux critères de sécurité et d'accessibilité au public. **Les localisations en attente peuvent être scannées et activées en attendant la fin de l'examen. | |
Rejeté | Les lieux "rejetés" peuvent avoir échoué à l'examen de confiance et de sécurité de Niantic, être un doublon d'un lieu existant ou précédemment rejeté, ou ne pas être autorisés par Niantic pour une autre raison. Ces lieux ne peuvent pas être ajoutés à des projets. | |
Test | Les emplacements "test" ne sont accessibles à votre espace de travail qu'en scannant l'emplacement à l'aide de l'application Wayfarer de Niantic. Les lieux de test sont destinés à être utilisés pendant le développement et peuvent ne pas être inclus dans un projet publié. |
Pour toute question ou problème lié à la création de sites VPS, ou pour vérifier le statut d'un site existant, veuillez contacter support@lightship.dev.
Statut de l'emplacement : Dans le navigateur géospatial, vous verrez cinq statuts différents pour les emplacements des SPV :
Dans le navigateur géospatial, vous verrez cinq statuts différents pour les emplacements VPS :
Statut | Icône | Description |
---|---|---|
Non activé | Les sites dont le statut est "Non activé" n'ont pas fait l'objet d'une analyse. Un minimum de 10 numérisations viables doit être soumis pour le lieu avant de pouvoir demander l'activation. Après l'envoi d'un scan, l'état de l'emplacement devient "Scanning". | |
Numérisation | Les sites dont le statut est "en cours d'analyse" ont fait l'objet d'au moins une analyse. Un minimum de 10 numérisations viables doit être soumis pour le lieu avant de pouvoir demander l'activation. | |
Traitement | ![]() | Les sites dont le statut est "en cours de traitement" ont fait l'objet d'une demande d'activation et afficheront le statut "en cours de traitement" jusqu'à ce que le processus d'activation soit terminé. En règle générale, une demande d'activation est traitée dans les 4 heures. Vous recevrez un courriel lorsque la procédure sera terminée. |
Actif | Les sites dont le statut est "actif" peuvent être utilisés dans des projets de création de contenu WebAR à l'aide de VPS for Web. | |
Échec | Les sites dont le statut est "Échec" ont rencontré un problème au cours du processus d'activation. Cela peut résulter d'un certain nombre de facteurs, tels qu'une mauvaise adéquation de l'emplacement pour le SPV, des analyses insuffisantes ou des données corrompues. Malheureusement, cela signifie que cet emplacement ne peut pas être utilisé pour créer du contenu WebAR à l'aide d'un VPS. Nous vous encourageons à trouver un nouveau lieu à utiliser dans votre projet de 8e mur. |
Pour toute question ou problème lié à la numérisation, à l'activation ou au statut de la localisation, veuillez contacter support@lightship.dev
Avertissement d'alignement : L'avertissement de non-alignement peut survenir pour diverses raisons et signifie que la localisation par rapport au maillage ne peut être garantie. Bien que le maillage puisse fonctionner correctement pour la localisation, l'avertissement indique que le maillage est expérimental et qu'il doit être utilisé à vos risques et périls. Remarque : tous les balayages de test ne sont pas alignés. Si l'emplacement que vous souhaitez utiliser dans votre projet n'est pas disponible en tant qu'emplacement VPS, vous pouvez le créer en suivant les instructions de la section Créer un nouvel emplacement.
Développer les expériences VPS
Lorsque vous ajoutez un lieu activé par VPS à votre projet, celui-ci apparaît dans la hiérarchie de la scène. Une fois que vous avez un lieu dans votre projet, vous pouvez inspecter les détails de ce lieu en utilisant le panneau de droite. Un maillage de l'emplacement apparaît pour vous permettre d'aligner et de positionner d'autres contenus 3D par rapport à l'emplacement.
Entités de localisation
**Pour que les objets de la scène soient correctement alignés sur l'emplacement après la localisation, ils doivent être ajoutés en tant qu'enfants à l'entité Emplacement.
Les sites constituent un type d'entité unique au sein de Studio. Ces emplacements sont accompagnés d'un maillage 3D visuel dans la fenêtre d'affichage à des fins de placement de contenu et de test, mais n'ajoutent pas réellement de maillage à votre projet.
Dans la vue Inspecteur, vous pouvez voir les détails de l'emplacement comme le statut, le type, la qualité, les identifiants et le maillage GLB correspondant disponible pour le téléchargement. Pour en savoir plus sur l'utilisation du fichier Location GLB, voir ci-dessous.
D'autres entités peuvent être ajoutées en tant qu'objets enfants à un objet Lieu. Pour tout contenu qui ne doit apparaître qu'après la localisation, vous devez l'ajouter en tant qu'entité enfant.
**Les composants par défaut de Studio, tels que Mesh, Physics Colliders, etc., ne seront pas compatibles avec l'entité Location. N'essayez pas de les ajouter directement à l'entité Location, car vous risquez de rencontrer des problèmes d'exécution avec l'activation du VPS, la localisation ou les interactions avec le contenu.
Localisation GLB
Un objet Emplacement vous permet de télécharger directement un fichier GLB (maillage) que vous pouvez intégrer à votre scène en tant que ressource. Vous pouvez utiliser l'actif pour mettre en place des occluders, créer des effets de texture superposés ou créer des couches de physique. La fonction de téléchargement GLB vous donne la possibilité de télécharger avec ou sans texture.
**Certains sites dotés d'un système de paiement virtuel et disposant d'une grande superficie peuvent avoir des fichiers GLB très volumineux, supérieurs à 50 Mo. Cela peut poser des problèmes de performance, en particulier lorsqu'il y a beaucoup d'autres objets ou des objets de grande taille dans la scène. Tenez compte de la taille du fichier de téléchargement du BGL lorsque vous l'utilisez comme atout dans le cadre du projet.
Dans certains cas, vous souhaiterez peut-être intégrer le GLB dans un outil d'édition 3D tiers tel que Maya ou Blender.
**IMPORTANT : L'origine de ce modèle 3D est l'origine de l'emplacement. Ne réinitialisez pas l'origine ou votre contenu ne sera pas aligné.
Lieu Événements
8th Wall émet des événements à différentes étapes du cycle de vie de l'emplacement du projet (par exemple, numérisation, recherche, mise à jour, perte, etc.) Veuillez consulter [la référence de l'API] (/api/studio/events/xr/vps/) pour obtenir des instructions spécifiques sur la gestion de ces événements dans votre application web.
Permettre aux utilisateurs finaux de bénéficier de la géolocalisation
Afin de permettre à VPS de fonctionner, les paramètres de votre caméra doivent être mis à jour.
Simulation de l'expérience de la réalité virtuelle
Avec le simulateur dans Studio, vous pouvez tester vos expériences à distance sans jamais quitter votre bureau. Le simulateur de Studio vous permet de simuler des mouvements dans votre scène à l'aide de simples commandes WASD et d'orbite afin de voir comment les éléments WebAR interagissent avec l'environnement réel et de vous assurer que tout fonctionne comme prévu avant le déploiement. Cette capacité réduit le temps d'itération et facilite l'amélioration de l'expérience.
**Lorsque vous actualisez le simulateur sur un site, il se peut que vous voyiez un écran blanc. Si cela se produit, vous devrez actualiser à nouveau pour revenir à l'affichage de l'emplacement.
Utilisation du simulateur avec des sites compatibles avec le SPV
Pour simuler le mouvement et le placement de contenu dans un lieu ajouté à votre scène :
- Assurez-vous que les paramètres de la caméra sont réglés sur Monde et que l'option VPS est activée. Voir les paramètres de la caméra pour VPS ci-dessus.
- Appuyez sur Play pour ouvrir le simulateur
- Utilisez les options de l'environnement du simulateur (sélecteur en bas à gauche) pour trouver l'emplacement du projet souhaité.
- Pour simuler le SPV, utilisez l'événement Localisation trouvée pour simuler une localisation réussie. IMPORTANT : les objets enfants de l'entité Location que vous simulez n'apparaîtront PAS tant que l'événement Location Found n'aura pas été déclenché. Vous pouvez utiliser d'autres événements de localisation et de maillage pour simuler d'autres scénarios (comme la perte de localisation). Pour plus d'informations sur les événements VPS, voir la section API sur les événements de localisation.
- La localisation non manuelle (désélection des événements manuels) n'est pas encore prise en charge par le simulateur, mais elle le sera bientôt.
- Les raccourcis clavier WASD et les commandes Orbit sont disponibles pour simuler les mouvements. Vous devez d'abord cliquer sur le panneau Simulateur, puis vous pouvez utiliser les raccourcis clavier et le contrôleur d'orbite.
- W = Avant
- A = Gauche
- S = Retour
- D = droite
- Q = Haut
- E = En bas
Pour certains lieux, il se peut que le lieu n'apparaisse pas dans le simulateur. Certains maillages VPS sont décalés par rapport à l'origine, ou hors de vue initialement dans le simulateur. Utilisez les commandes d'orbite pour vous déplacer afin de trouver votre maillage de localisation dans le cas où vous verriez un écran noir. Pour plus de conseils, d'astuces et de problèmes connus, voir la section Questions connues et FAQ ci-dessous.
Créer de nouveaux sites compatibles avec le SPV
- Cliquez sur un emplacement libre sur la carte pour sélectionner l'endroit où vous souhaitez créer un nouveau site VPS. Consultez la section Exigences relatives à l'emplacement du SPV pour en savoir plus sur le choix d'un bon emplacement pour créer un emplacement de SPV.
- Cliquez sur le bouton Créer un emplacement public pour lancer le processus de création de l'emplacement. Les emplacements publics sont accessibles à tous les développeurs et à toutes les personnes qui utilisent leurs projets. Lors de l'ajout d'un nouveau lieu public, veuillez tenir compte des lignes directrices suivantes :
- Les lieux publics doivent être des lieux ou des objets permanents, physiques, tangibles et identifiables.
- Les lieux publics doivent être sûrs et accessibles aux piétons.
- Veillez à inclure des informations précises dans le titre, la description et la photo afin d'aider vos utilisateurs à trouver le lieu.
Les espaces de travail sur le Pro plan auront également l'option de Créer un emplacement privé. Les emplacements privés ne seront visibles et accessibles qu'à votre espace de travail et à ses projets. Les emplacements privés sont une fonctionnalité haut de gamme pour les développeurs qui ont besoin de créer des expériences VPS temporaires ou à accès contrôlé.
- Vérifiez les doublons : Avant de créer un nouveau site, vous devez vérifier que le site n'existe pas déjà. Comparez l'emplacement souhaité à d'autres emplacements déjà présents sur la carte pour vous assurer que vous ne créez pas de doublon. S'il ne s'agit pas d'un emplacement en double, vous devez cocher la case Mon emplacement n'est pas en double et cliquer sur le bouton Suivant pour continuer.
- Ajouter des informations de localisation : Les métadonnées de localisation seront visibles pour les développeurs qui utilisent le navigateur géospatial et peuvent être visibles pour les utilisateurs finaux. N'oubliez pas que l'équipe Trust & Safety de Niantic utilise les informations que vous fournissez pour déterminer si l'emplacement répond à nos critères pour être rendu public . Une fois que vous avez ajouté les informations suivantes pour le lieu que vous essayez de créer, cliquez sur le bouton Submit :
- Titre (125 caractères)
- Description (250 caractères)
- Catégorie (1 ou plus)
- Image (si disponible)
- Utilisez l'application iOS Scaniverse pour terminer le processus de création de l'emplacement.
Scaniverse pour les développeurs de Niantic
Scaniverse pour les développeurs Niantic intègre de manière transparente le navigateur géospatial (GSB) avec l'expérience de numérisation primée de Scaniverse. Ce site rationalise considérablement les flux de travail des développeurs en ce qui concerne la navigation sur la carte, l'ajout d'emplacements et, bien sûr, la numérisation ( ) :
- Nous avons rendu le navigateur géospatial (GSB) convivial pour les mobiles afin qu'il puisse être utilisé efficacement sur a Scaniverse pour parcourir la carte, inspecter les emplacements, ajouter des emplacements et demander l'activation d'un SPV.
- Flux de connexion simplifié à l'aide d'un simple code QR qui relie Scaniverse à votre compte 8th Wall.
- Nous avons adopté l'interface utilisateur existante de Scaniverse pour faciliter la création et le téléchargement de scans.
- Nous avons permis de tester la localisation dans les sites activés par le VPS au sein de Scaniverse.
- Nous avons intégré les dernières améliorations apportées au filtrage des cartes afin qu'il soit plus facile que jamais de trouver le(s) site(s) que vous recherchez.
Lien entre Scaniverse et le navigateur géospatial (GSB)
Prérequis : Installez Scaniverse à partir de l'[App Store] iOS (https://apps.apple.com/us/app/scaniverse-3d-scanner/id1541433223). La prise en charge des appareils Android est imminente.
- Connectez-vous à votre compte 8th Wall sur votre ordinateur. Ouvrez le Geospatial Browser (GSB), sélectionnez n'importe quel emplacement sur la carte, puis sélectionnez View Details. Dans le coin inférieur droit de la carte de détails de l'emplacement , appuyez sur Générer un code QR. Un code QR s'affiche.
-
Scannez le code QR avec votre application Appareil photo. Ouvrez l'application Appareil photo sur votre téléphone et pointez-la sur le code QR.
-
Tapez sur le lien Scaniverse qui apparaît. Cela permettra de relier Scaniverse à votre compte de développeur 8th Wall . Cette opération ne doit être effectuée qu'une seule fois.
infoVeillez à autoriser www.8thwall.com à utiliser votre position actuelle lorsque vous y êtes invité ; cela est nécessaire au bon fonctionnement de l'interface GSB. :: :
-
Une fois que vous avez relié Scaniverse à GSB, vous pourrez revenir à l'écran GSB à tout moment en appuyant sur le bouton GSB dans le ruban inférieur de l'application Scaniverse. Notez que vous pouvez déconnecter Scaniverse de GSB à tout moment en allant dans le menu Settings et en désactivant l'option Niantic Developer Mode.
-
Tous les scans que vous avez pris en dehors du mode développeur de Niantic resteront accessibles lorsque liera ou déliera Scaniverse avec GSB.
Parcourir la carte du GSB dans Scaniverse
-
En tapant sur l'icône Personne, vous pourrez sélectionner votre espace de travail du 8e mur.
-
En cliquant sur le bouton Télécharger, vous pourrez sélectionner l'emplacement des scans à télécharger. Notez que seuls les scans provenant du mode développeur de Niantic (en utilisant les options Add Scans ou Test Scan) peuvent être téléchargés vers Niantic à des fins d'activation du VPS.
-
En cliquant sur le bouton Plus, vous pourrez créer de nouveaux emplacements et tester des balayages.
-
En appuyant sur le bouton Couches, la vue satellite de la carte s'affiche.
-
Le fait d'appuyer sur le bouton Réticule permet de centrer la carte sur votre position.
-
Le fait d'appuyer sur le bouton Compas ramène la carte à son orientation par défaut, vers le nord.
-
Le bouton Contrôles vous permet d'appliquer des filtres aux lieux qui apparaissent sur la carte en fonction de leur taille, de leur catégorie ou de leur statut d'activation.
-
Le bouton Verre grossissante vous permet d'effectuer une recherche sur la carte.
-
En appuyant sur le bouton X, vous fermerez le GSB et reviendrez à l'