Lightship VPS

Aperçu du VPS Lightship

Avec le système de positionnement visuel (VPS) 8th Wall, les développeurs ont désormais la possibilité de déterminer la position et l'orientation d'un utilisateur avec une précision de l'ordre du centimètre, et ce en quelques secondes. Grâce à la plateforme 8th Wall, vous pouvez utiliser VPS dans vos projets WebAR pour créer des expériences Web AR géolocalisées qui relient le monde réel au monde numérique. Le contenu WebAR peut être ancré sur le site , ce qui permet aux objets virtuels d'interagir avec l'espace dans lequel ils se trouvent. L'expérience de la réalité augmentée devient ainsi plus personnelle, plus significative, plus réelle, et donne aux utilisateurs de nouvelles raisons d'explorer le monde qui les entoure.

Gestion des Wayspots

Vous pouvez accéder au navigateur géospatial à partir de votre projet en sélectionnant l'icône de carte dans le menu de gauche(annoté comme #1 dans l'image ci-dessous). Sur cette page, vous trouverez une vue cartographique (#2) que vous pouvez utiliser pour rechercher les Wayspots de Niantic activés par VPS. La sélection d'un emplacement activé par VPS affichera le maillage 3D de l'emplacement (#3) afin que vous puissiez vérifier que vous avez sélectionné l'emplacement correct et l'ajouter à votre projet (#4).

Lorsque vous ajoutez un point de cheminement activé par VPS à votre projet, un point de cheminement apparaît dans le tableau "Projet Points de cheminement" dans le navigateur géospatial (annoté comme #1 dans l'image ci-dessous). Une fois que vous avez un Wayspot dans le tableau "Projet Wayspots", vous pouvez utiliser le bouton « Télécharger » (#2) pour télécharger une version GLB ou OBJ (comme sur #3) du maillage 3D et l'ouvrir dans des applications logicielles 3D tierces, telles que Blender, ou l'importer directement dans votre projet 8th Wall. Lorsque vous faites référence aux Wayspots dans votre code de projet , vous devez copier le champ "Nom" (#4) du tableau "Projet Wayspots".

Si l'endroit que vous souhaitez utiliser dans votre projet n'est pas disponible en tant que Wayspot, vous pouvez soumettre à Niantic les emplacements de Wayspot en suivant les instructions de la section Créer un nouveau Wayspot.

Créer un nouveau Wayspot

1. Sélectionnez sur la carte l'endroit où vous souhaitez créer un nouveau Wayspot. (voir Wayspot Requirements pour en savoir plus sur le choix d'un bon emplacement pour créer un Wayspot).

2. Créer un Wayspot : Cliquez sur le bouton "Créer un Wayspot" pour lancer la procédure de création d'un nouveau Wayspot.

3. Vérifiez qu'il n'y a pas de doublons : Avant de créer un nouveau Wayspot, vous devez vérifier que le Wayspot n'existe pas déjà. Comparez l'emplacement de votre Wayspot à d'autres 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 Wayspot dupliqué, vous devez cocher la case "Mon Wayspot n'est pas un duplicata" et cliquer sur le bouton "Suivant" pour continuer.

4. Ajouter des informations sur les Wayspots : Les métadonnées Wayspot seront visibles pour les développeurs qui utilisent le navigateur Geospatial et peuvent être visibles pour les utilisateurs finaux. N'oubliez pas que l'équipe Sécurité de Niantic utilise les informations que vous fournissez pour déterminer si le Wayspot répond à nos critères pour être mis à la disposition du public. Une fois que vous avez ajouté les informations suivantes pour le Wayspot que vous essayez de créer, cliquez sur le bouton « Soumettre » :

• Titre (125 caractères)
• Description (250 caractères)
• Catégorie (1 ou plus)
• Image (si disponible)

5. Votre Wayspot devrait être immédiatement ajouté à votre onglet Soumissions Wayspot dans le navigateur Geospatial avec le type « En attente » et le statut « Non activé ». Vous pouvez continuer à scanner et à activer ce Wayspot pendant que votre demande de rendre ce Wayspot "public" est en cours de traitement. Vous pouvez en savoir plus sur les types et les statuts de Wayspot dans la section Wayspot Types de la documentation.

Installation de Niantic Wayfarer

iOS

L'application Wayfarer de Niantic nécessite iOS 12 ou une version ultérieure et un iPhone 8 ou une version ultérieure. Un appareil compatible LiDAR n'est pas nécessaire.

Pour installer l'application Niantic Wayfarer, rendez-vous sur Testflight for Niantic Wayfarer (8th.io/wayfarer-ios) sur votre appareil iOS.

Android (Beta)

L'application Wayfarer de Niantic nécessite le package ARCore.

Pour installer l'application Niantic Wayfarer, rendez-vous sur Niantic Wayfarer (8th.io/wayfarer-android) sur votre appareil Android.

Utilisation de Niantic Wayfarer

Vous pouvez ajouter des scans aux Wayspots publics et créer Scans privés avec l'application Niantic Wayfarer.

Une fois l'application installée, connectez-vous avec vos identifiants 8th Wall en appuyant sur le bouton Se connecter avec 8th Wall.

Si vous avez accès à plusieurs espaces de travail, sélectionnez un espace de travail en cliquant sur le menu déroulant Espace de travail 8th Wall sur la page de profil.

Page de connexion	Page de profil

Sur la page Map, sélectionnez un Wayspot pour ajouter un scan à un Wayspot public (1), ou sélectionnez Scan pour ajouter un scan privé à votre espace de travail (2).

Effectuez un scan de la zone en utilisant la [technique de balayage] recommandée (#technique-de-balayage).

Page de carte	Page de numérisation

Une fois l'analyse terminée, sélectionnez public ou privé, puis chargez.

Type de scan	Chargement du scan

Le traitement des scans peut prendre de 15 à 30 minutes. Une fois traités, les scans s'affichent dans le navigateur géospatial.

Les questions relatives à la numérisation ou au traitement doivent être adressées à support@lightship.dev.

Vous trouverez de plus amples informations sur l'utilisation de l'application Wayfarer dans la [documentation Lightship] (https://lightship.dev/docs/ardk/vps/generating_scans.html#using-the-niantic-wayfarer-app).

Technique de scan

Les emplacements activés par le SPV scannés ne doivent pas dépasser un diamètre de 10 mètres autour de l'emplacement. Par exemple, une statue typique fonctionnerait comme un Wayspot activé par un VPS. Mais pas un bâtiment entier , par contre. Une face ou une porte/entrée dans un bâtiment pourrait fonctionner. Pour commencer, nous vous recommandons de vous en tenir à des petites surfaces (par exemple, un bureau, une statue ou une peinture murale).

Avant de scanner, envisagez votre environnement et assurez-vous que vous avez le droit d'accéder au lieu que vous scannez.

1. Vérifiez la zone à numériser et les environs de l'objet numérisé pour déterminer s'il y a des obstacles et pour sélectionner un itinéraire de numérisation. Il est nécessaire de planifier l'itinéraire que vous avez l'intention d'utiliser pour le balayage avant de commencer la procédure.
2. Assurez-vous que la mise au point de votre appareil photo est correcte. Le tremblement de la caméra peut avoir un effet négatif sur la reconstruction en 3D. Maintenez votre téléphone le plus près possible de votre corps pour éviter les flous. Marchez autour de l'objet que vous scannez à l'adresse au lieu de rester à un endroit précis et de déplacer votre téléphone.
3. Marchez à un rythme lent et naturel. Déplacez-vous lentement et sans à-coups pendant le scan. Les changements soudains de direction sont à proscrire. Déplacez-vous lentement et sans à-coups, les pieds au sol. Si vous numérisez dans un environnement sombre, il est d'autant plus important de vous déplacer lentement et sans à-coups. Déplacez le téléphone avec vous lorsque vous vous déplacez (pensez à la marche en crabe).
4. Wayspot doit toujours être le point central. Pour que nous puissions construire la carte, il est important de se concentrer sur le Wayspot et capturer l'orbite complète à 360° de celui-ci. S'il n'est pas possible ou pas sûr d'obtenir une couverture à 360° , capturez autant que possible.
5. Variez la distance et les angles (0-10m ou 0-35ft). Pour que la carte 3D fonctionne bien dans différents scénarios , il est important que nous capturions l'environnement autour du Wayspot et que nous disposions d'une variété de scans différents. Il est important de varier la distance et les angles de vue lorsque vous scannez le Wayspot.

Vidéo de la technique de scan Wayspot recommandée :

Choses à éviter lors de la numérisation

1. Évitez de scanner lorsque l'environnement n'est pas sûr, par exemple au milieu de la route ou dans une aire de jeux avec des enfants.
2. Évitez de scanner lorsque le Wayspot est trop éloigné (>10m ou 35ft) ou trop grand pour que vous puissiez y avoir un focus correct avec votre appareil photo.
3. Évitez de scanner pendant que vous vous promenez ou que vous faites du jogging. Il est important de garder le Wayspot comme point focal à tout moment.
4. Évitez de pointer votre téléphone vers des objets très lumineux tels qu'une lumière fluorescente ou le soleil.
5. Évitez de ne pas bouger ou de bouger trop vite lorsque vous scannez. Les mouvements brusques entraîneront des décalages dans la reconstruction.
6. Évitez de numériser si votre téléphone devient trop chaud. Si la température de l'appareil augmente trop, les performances seront fortement réduites, ce qui aura un effet négatif sur la numérisation.
7. Évitez de télécharger des scans qui semblent incomplets ou qui ne sont pas représentatifs de ce que vous essayez de scanner.

Scanners privés

Les scans privés sont un maillage unique, accessible à un seul espace de travail, pour développer et tester les expériences VPS. Bien que les scans privés soient une excellente solution pour développer et tester des expériences VPS pendant qu'un Wayspot public est en cours de nomination ou d'activation, ils ne sont pas autorisés à être utilisés dans les projets publiés.

Les scans privés sont créés à l'aide de l'application Niantic Wayfarer. Assurez-vous que vous êtes connecté à Wayfarer en utilisant les informations d'identification de 8th Wall et que l'espace de travail correct est sélectionné sur la page Profil. Le scan privé ne sera disponible que dans l'espace de travail 8th Wall sélectionné au moment du scan et du chargement. Les scans ne peuvent pas être déplacés vers un autre espace de travail ou un autre compte Lightship.

Dans l'application Wayfarer, sélectionnez Scan et [prenez un scan de la zone] (#using-niantic-wayfarer).

Les scans privés doivent durer 60 secondes ou moins ; une nouvelle maille est générée toutes les 60 secondes - un scan de 120 secondes donnera 2 scans privés. Tous les scans privés sont unaligned.

Une fois traité, vous pouvez prévisualiser le maillage et l'ajouter à votre projet à partir du navigateur géospatial onglet Scans privés.

Si le traitement de votre scan privé échoue, vous devrez peut-être procéder à nouveau. Contactez support@lightship.dev pour plus d'informations.

Types de Wayspots

Dans le navigateur géospatial, vous verrez quatre types différents de Wayspots :

Type	Icône	Description
Public		les Wayspots "publics" ont été approuvés par l'équipe Sécurité de Niantic et répondent aux critères de sécurité et d'accessibilité au public. Ces Wayspots peuvent être utilisés dans des projets publiés.
En attente		les Wayspots "en attente" sont examinés par l'équipe Sécurité de Niantic afin de déterminer s'ils répondent aux critères de sécurité et d'accessibilité au public. Cette opération peut durer jusqu’à 2 jours ouvrables Les Wayspots en attente peuvent être scannés et activés en attendant la fin de la révision.
Rejeté		Les Wayspots "rejetés" peuvent avoir échoué à l'examen de confiance et de sécurité de Niantic, être un doublon d'un Wayspot existant ou précédemment rejeté, ou ne pas être autorisés par Niantic pour une autre raison. Ces Wayspots ne peuvent pas être ajoutés à des projets.
Privé		Les Wayspots "privés" ne sont accessibles à votre espace de travail qu'en scannant l'emplacement à l'aide de l'application Wayfarer de Niantic. Les Wayspots privés sont destinés à être utilisés pendant le développement et ne peuvent pas être inclus dans un projet publié.

Pour toute question ou problème lié à la création de Wayspots ou à l'état des Wayspots existants, veuillez contacter support@lightship.dev

Statut du point d'accès (Wayspot)

Dans le navigateur géospatial, vous verrez cinq statuts différents pour les Wayspots :

Statut	Icône	Description
Non activé		Les Wayspots dont le statut est "Non activé" n'ont fait l'objet d'aucune analyse. Un minimum de 10 numérisations viables doit être soumis pour le lieu avant que vous puissiez demander l'activation. Une fois qu'un scan a été effectué, l'état du Wayspot passe à « Scanné ».
Numérisation		Les Wayspots dont le statut est « Scanné » ont fait l'objet d'au moins un scan. Un minimum de 10 numérisations viables doit être soumis pour le lieu avant que vous puissiez demander l'activation.
Traitement		Les Wayspots 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 le processus sera terminé.
Actif		Les Wayspots 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 Wayspots dont le statut est "Échec" ont rencontré un problème lors 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 ce Wayspot ne peut pas être utilisé pour créer du contenu WebAR à l'aide d'un VPS. Nous vous encourageons à trouver un nouveau point de passage à utiliser dans votre projet 8th Wall.

Pour toute question ou problème lié à l'analyse, à l'activation ou à l'état de Wayspot, veuillez contacter support@lightship.dev

Exigences de Wayspot

Les Wayspots ne seront approuvés et mis à la disposition du public que s'ils répondent aux critères suivants :

• Lieu ou objet permanent, physique, tangible et identifiable, ou objet qui marque une zone.
• Sont sûrs et accessibles aux piétons (à l'intérieur ou à l'extérieur).
• Le titre, la description et la photo doivent contenir des informations exactes.

Les Wayspots sont plus performants sur les VPS, lorsqu'ils répondent également aux critères suivants :

• Avoir un point focal clair qui s'inscrit dans une sphère de 10 m de diamètre.
• Présenter des caractéristiques distinctes et cohérentes. (Ex. Une plage de sable ou un patio bondé avec des meubles mobiles ne conviendront pas)
• Avoir des caractéristiques minimales qui sont réfléchissantes ou transparentes.

Quantités Wayspot

Il n'y a pas de limite au nombre de Wayspots qui peuvent être associés à un projet 8th Wall. Les Wayspots sont localisés côté serveur via le service VPS.

Événements Wayspot

8th Wall émet des événements à différentes étapes du cycle de vie du projet Wayspot (par exemple, balayage, trouvé, mis à jour, perdu, etc.) Veuillez consulter la référence de l'API pour obtenir des instructions spécifiques sur la gestion de ces événements dans votre application web :

• AFrame Events
• PlayCanvas Events
• XrController Dispatched Events

Qualité Wayspot

Une fois qu'un Wayspot a été activé par VPS, Niantic fournit une évaluation de la qualité dans le navigateur Geospatial. Les détails des Wayspots affichent soit Moyenne qualité, soit Bonne qualité.

La qualité du Wayspot fait référence à la capacité du Wayspot à se localiser à tout moment. Les Wayspots comportant plusieurs scans dans tous les types d'éclairage ont tendance à être de meilleure qualité. Les Wayspots pour lesquels le nombre de scans requis est minimal ou la majorité des scans dans un seul type d'éclairage ont tendance à être de moins bonne qualité.

L'évaluation de la qualité est un processus automatisé et peut ne pas refléter la performance réelle du Wayspot. La meilleure façon de déterminer la qualité est de l'essayer vous-même.

Alignement des Wayspots

L'avertissement de non-alignement peut se produire pour diverses raisons et signifie que la localisation par rapport au maillage ne peut pas ê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 scans privés sont non alignés.

Activation de Lightship VPS

Pour activer le VPS dans votre projet WebAR, vous devez mettre enableVPS à vrai.

Pour les projets A-Frame, définissez enableVps: vrai sur le composant xrweb sur le site <a-scene>

Pour les projets non-AFrame, définissez enableVps: vrai dans l'appel à XR8.XrController.configure() avant le démarrage.

Exemple - AFrame

<a-scene
  coaching-overlay
  landing-page
  xrextras-loading
  xrextras-runtime-error
  ...
  xrweb="enableVps: true;">

Exemple - Sans cadre

XR8.XrController.configure({enableVps: true})
// Ensuite, démarrez 8th Wall

FAQ VPS

Qu'est-ce que Lightship VPS ?

Lightship VPS (Visual Positioning System) est un service en cloud qui permet aux applications de localiser l'appareil d'un utilisateur dans des lieux réels, ce qui permet aux utilisateurs d'interagir avec du contenu AR persistant et , ce qui permet de nouvelles expériences immersives. VPS détermine la position et l'orientation de l'appareil (pose) en se référant aux données cartographiques qui existent dans le cloud de Niantic.

Comment fonctionne le VPS ?

Lorsqu'un appareil appelle le service VPS, le service prend en entrée une image de requête provenant de l'appareil de l'utilisateur ainsi que sa position GPS et tente de le localiser à l'aide de la ou des carte(s) qui existent à cet endroit. Si la localisation est réussie, le service renvoie la position et l'orientation de l'appareil correspondant à l'horodatage de l'image transmise. Comme il s'écoule un certain temps entre le moment où une image de requête VPS est capturée et celui où une réponse est reçue du service VPS , l'appareil doit être doté d'un système de suivi des mouvements afin de rester localisé avec précision lorsqu'il est en mouvement. Lorsque le service VPS renvoie une estimation de la position de l'appareil, la différence de position provenant du système de suivi de l'appareil est ajoutée à la réponse de localisation afin que VPS puisse "suivre" la façon dont l'appareil s'est déplacé au cours de la requête.

Qu'est-ce qu'un scan ?

Les scans AR des joueurs, des développeurs et des géomètres sont l'ingrédient fondamental que Niantic utilise pour construire sa carte AR du monde. Les scans AR sont enregistrés et chargés à l'aide du AR scanning framework de Niantic, un module utilisé dans Pokemon Go, Ingress et l'application Wayfarer, et qui peut désormais être intégré par les développeurs avec ARDK 2.5 et au-delà. Chaque scan AR consiste en une série d'images vidéo avec des données d'accéléromètres et de capteurs GPS qui construisent un modèle 3D du monde à partir de plusieurs images 2D. Les scans AR sont utilisés par Niantic pour construire des cartes et des maillages des emplacements réels.

Qu'est-ce qu'une carte ?

Dans le jargon du SPV, une carte est l'artefact de données utilisé pour localiser votre appareil lorsque l'API du SPV est appelée. Une carte peut être considérée comme une fonction qui prend une image en entrée et renvoie la position et l'orientation en sortie. La carte correspondant à un lieu donné est créée à partir des scans qui ont été chargés à cet endroit. Les cartes VPS ne sont pas lisibles par l'homme.

Qu'est-ce qu'un maillage ?

Dans le jargon du SPV, un maillage est un modèle 3D d'un lieu ou d'un objet réel. Les maillages fournissent une représentation détaillée d'un espace ou d'un objet physique, et sont utiles pour comprendre à quoi ressemble un lieu et comme référence pour la création de contenu AR. Les maillages peuvent également être utilisées par certaines applications à des fins de suivi. Comme les cartes, les maillages qui correspondent à un lieu donné sont créés à partir des scans qui ont été chargés à cet endroit. Les maillages sont lisibles à la fois par l'homme et par la machine.

Où puis-je utiliser le VPS ?

Le SPV est disponible dans plus de 100 000 lieux dans le monde réel, et de nouveaux lieux sont ajoutés chaque jour. Pour qu'un lieu soit disponible sur VPS, un nombre suffisant de données de scan AR doit être chargé sur et le processus d'activation VPS doit être achevé.

Comment fonctionne l'activation d'un VPS ?

Pour qu'un site soit éligible à l'activation VPS, il doit avoir au moins 10 scans chargés qui respectent les contrôles de qualité minimum, et la différence de temps entre les scans les plus anciens et les plus récents sur le site doit être d'au moins 5 heures. Ces exigences garantissent que les cartes et les maillages de qui en résultent sont d'une qualité suffisante et capturent suffisamment de variations pour que les utilisateurs soient en mesure de localiser de manière fiable. Le processus d'activation des VPS s'appuie sur l'infrastructure de cartographie AR de Niantic et comporte de nombreuses étapes complexes. À partir de l'ensemble des scans éligibles au Wayspot, un algorithme sélectionne la plupart des scans à utiliser pour construire des cartes et des maillages, et les quelques scans restants pour la validation et la mesure de la qualité de la localisation. Le processus d'activation prend généralement quelques heures.

Puis-je retrouver mes scans après l'activation du VPS ?

Au cours du processus d'activation, les cartes et maillages créés à partir des scans téléchargés sont fusionnés à l'adresse afin d'incorporer autant d'informations que possible. Le produit final, qui est utilisé par les développeurs pour créer du contenu et par les utilisateurs pour le localiser, est constitué de scans provenant de nombreuses sources différentes. Les données des scanners sont mélangées pour créer une représentation plus complète du lieu, il n'y a donc pas de relation univoque entre les scanners qui sont téléchargés sur un lieu et les cartes et maillages qui sont créés une fois que le lieu est activé par le système VPS.

Puis-je ajouter d'autres analyses à un site déjà activé ?

Dans certains cas, les développeurs peuvent souhaiter ajouter des scans supplémentaires à un lieu qui a été précédemment activé afin d'améliorer la qualité et la couverture des cartes et maillages du lieu. Pour qu'un Wayspot soit éligible à la "réactivation", il faut qu'au moins 5 analyses supplémentaires aient été chargées depuis la dernière fois qu'il a été activé. Il est important de noter qu'il n'est pas encore possible d'ajouter de nouveaux scans à une carte fusionnée existante. Le processus de réactivation nécessite plutôt la construction d'une nouvelle carte fusionnée qui intègre les nouveaux scans dans le contexte des cartes existantes.

Comment puis-je demander l'activation d'un nouveau lieu ?

Une fois qu'un lieu a suffisamment de scans chargés pour répondre aux conditions d'activation du VPS (au moins 10 scans au total avec une différence de temps d'au moins 5 heures entre le plus ancien et le plus récent), les développeurs peuvent demander l'activation du VPS en sélectionnant le lieu dans l'application Wayfarer ou dans le navigateur géospatial et en appuyant sur le bouton "activer". Cela ajoutera le lieu à la file d'attente de l'activation. En général, une demande d'activation est traitée dans les 4 heures. Les développeurs ont également la possibilité de demander la réactivation d'un site existant après le téléchargement de cinq scans supplémentaires.

Le SPV fonctionne-t-il la nuit ou dans de mauvaises conditions météorologiques ?

Le SPV fonctionne mieux lorsqu'il y a une bonne visibilité. Afin de maximiser les chances de réussite de l'expérience VPS, il est préférable de télécharger de nombreux scans de RA couvrant un large éventail de conditions différentes (par exemple, différentes heures de la journée, différentes conditions météorologiques, etc.) Si vous créez une expérience dans un endroit où il pleut beaucoup, il est très utile d'avoir des images d'un jour de pluie.

La numérisation AR et le VPS nécessitent-ils des téléphones équipés de capteurs LiDAR ?

Le scan AR et VPS ne nécessitent pas de LiDAR.