Zum Hauptinhalt springen

Einführung

AR Clip VPS ermittelt anhand dessen, was die Kamera sieht, wo sich ein Gerät befindet. Diese Seite erklärt, wie das funktioniert, und führt Sie durch Ihr erstes Projekt.

VPS steht für Visual Positioning System, also visuelle Positionsbestimmung. Es hält AR-Inhalte ohne Marker an ihrem Platz in der realen Welt. Es funktioniert auf Smartphones, im Browser und auf AR-Brillen und hängt weder von der GPS-Genauigkeit noch von einer installierten nativen App ab.

So funktioniert es​

VPS besteht aus zwei Teilen:

  1. Kartierung. Sie nehmen einen realen Ort auf, und AR Clip macht daraus eine Karte.
  2. Lokalisierung. Ein Gerät vergleicht sein Kamerabild mit dieser Karte und erhält seine genaue Position.

Kartierung​

Eine Karte ist ein für VPS aufbereitetes Abbild eines realen Ortes. Sie können sie auf mehreren Wegen aufnehmen:

  • AR Clip Mapper – unsere Smartphone-App. Sie nimmt das Video auf, das VPS braucht.
  • Scanner und Kameras – LiDAR, 360°-Kameras und RGB-D-Sensoren (mit Tiefeninformation).
  • REST API – laden Sie Bilder oder Punktwolken hoch, die Sie bereits haben.

AR Clip erstellt aus der Aufnahme die Karte. Danach funktioniert sie mit jedem SDK.

Die Standort-ID übergeben

Jede Karte hat eine Standort-ID. Übergeben Sie dem SDK eine oder mehrere Standort-IDs (locationIds), damit es weiß, mit welchen Karten es das Kamerabild vergleichen soll. In der REST API wird die Karte selbst über ihre mapId angesprochen.

Lokalisierung​

Die Lokalisierung bestimmt Position und Ausrichtung des Geräts auf der Karte – seine pose. VPS vergleicht die laufenden Kamerabilder mit der Karte und liefert die Pose. Wie genau sie ist, hängt von der Qualität der Karte und von den Bedingungen vor Ort ab, etwa vom Licht.

Lokalisieren können Sie mit:

  • den SDKs für iOS, Android, Unity und das Web;
  • Projekten aus AR Clip Studio, im Browser;
  • der REST API, für serverseitige oder eigene Clients.

Ihr erstes Projekt​

  1. Legen Sie ein Konto an auf arclip.design. Der kostenlose Tarif enthält die SDKs, die REST API und die Werkzeuge zur Kartierung. Ihren apiKey erhalten Sie bei der Registrierung.
  2. Nehmen Sie eine Karte auf. Nutzen Sie AR Clip Mapper oder laden Sie eigene Daten hoch. Ist die Verarbeitung fertig, erscheint die Karte in der Konsole unter Maps.
  3. Binden Sie das SDK ein. Installieren Sie das SDK für Ihre Plattform und übergeben Sie ihm Ihren apiKey und die Standort-IDs Ihrer Karten. Sobald die Lokalisierung gelingt, erhalten Sie laufend pose-Updates.
  4. Bauen Sie das AR-Erlebnis. Hängen Sie Anker, Routen und Inhalte in Unity, AR Clip Studio, Three.js oder Ihrem eigenen Renderer an.

Entwickler-Token​

<your-developer-token>

Ihr Token finden Sie in Ihren Kontoeinstellungen. Sie nutzen es für Aufrufe der REST API, etwa für die automatisierte Kartenverwaltung.

Halten Sie Ihr Token geheim

Behandeln Sie es wie ein Passwort. Es gehört nicht in clientseitigen Code, auf Screenshots oder in öffentliche Repositorys. Ist es nach außen gelangt, widerrufen Sie es in Ihrem Konto und erstellen Sie ein neues.

Weiter: AR Clip Mapper – Ihre erste Karte aufnehmen.