Aller au contenu principal

Introduction

AR Clip VPS détermine où se trouve un appareil à partir de ce que voit sa caméra. Cette page explique son fonctionnement et vous guide dans votre premier projet.

VPS signifie « visual positioning system », un système de positionnement visuel. Il maintient le contenu AR en place dans le monde réel, sans marqueur. Il fonctionne sur les téléphones, dans le navigateur et sur les lunettes AR, et il ne dépend ni de la précision du GPS ni de l'installation d'une application native.

Comment ça marche​

Le VPS a deux volets :

  1. La cartographie. Vous capturez un lieu réel, et AR Clip le transforme en carte.
  2. La localisation. Un appareil compare l'image de sa caméra avec cette carte et obtient sa position exacte.

Cartographie​

Une carte est une copie d'un lieu réel, prête pour le VPS. Vous pouvez la capturer de plusieurs façons :

  • AR Clip Mapper — notre application mobile. Elle filme la vidéo dont le VPS a besoin.
  • Scanners et caméras — LiDAR, caméras 360° et capteurs RGB-D (profondeur).
  • API REST — envoyez des images ou des nuages de points que vous avez déjà.

AR Clip construit la carte à partir de votre capture. Une fois le traitement terminé, la carte fonctionne avec tous les SDK.

Transmettez l'identifiant de lieu

Chaque carte a un identifiant de lieu. Transmettez un ou plusieurs identifiants de lieu au SDK (locationIds), pour qu'il sache avec quelles cartes comparer l'image de la caméra. Dans l'API REST, la carte elle-même est désignée par son mapId.

Localisation​

La localisation trouve la position et l'orientation de l'appareil sur la carte : sa pose. Le VPS compare les images de la caméra en direct avec la carte et renvoie la pose. Sa précision dépend de la qualité de la carte et des conditions sur place, comme l'éclairage.

Vous pouvez localiser avec :

  • les SDK iOS, Android, Unity et Web ;
  • les projets créés dans AR Clip Studio, dans le navigateur ;
  • l'API REST, pour des clients côté serveur ou sur mesure.

Votre premier projet​

  1. Créez un compte sur arclip.design. L'offre gratuite comprend les SDK, l'API REST et les outils de cartographie. Vous recevez votre apiKey à l'inscription.
  2. Capturez une carte. Utilisez AR Clip Mapper, ou envoyez vos propres données. Une fois le traitement terminé, la carte apparaît dans Maps dans la console.
  3. Ajoutez le SDK. Installez le SDK de votre plateforme et donnez-lui votre apiKey et les identifiants de lieu de vos cartes. Dès que la localisation réussit, vous commencez à recevoir des mises à jour de pose.
  4. Construisez l'expérience AR. Rattachez ancres, itinéraires et contenus dans Unity, AR Clip Studio, Three.js ou votre propre moteur de rendu.

Jeton développeur​

<your-developer-token>

Votre jeton se trouve dans les réglages de votre compte. Utilisez-le pour les appels à l'API REST, comme la gestion automatisée des cartes.

Gardez votre jeton secret

Traitez-le comme un mot de passe. Ne le mettez jamais dans du code côté client, sur des captures d'écran ou dans des dépôts publics. S'il fuite, révoquez-le dans votre compte et créez-en un nouveau.

Suite : AR Clip Mapper — capturez votre première carte.