Lightship VPS

Lightship VPS Übersicht

Mit dem Visual Positioning System (VPS) von Niantic können Entwickler reichhaltige Location AR-Erlebnisse erstellen, die virtuelle Inhalte über die physische Welt legen. WebAR-Inhalte können an realen Standorten verankert werden, so dass virtuelle Objekte mit ihrer physischen Umgebung interagieren können. Dadurch fühlt sich das AR-Erlebnis persönlicher, bedeutungsvoller und intensiver an und gibt den Nutzern neue Gründe, die Welt um sie herum zu erkunden.

**Hinweis: Die VPS-Lokalisierung kann derzeit nicht im Simulator angezeigt werden.

Hinweis: VPS und Geospatial Browser (GSB) erfordern derzeit ein Pro-Abo. Diese Funktionen von sind im Basic-Tarif (kostenlos) nicht verfügbar.

Standorte verwalten

Auf den Geospatial Browser können Sie von Ihrem Projekt aus zugreifen, indem Sie das Kartensymbol im linken Menü von auswählen (in der Abbildung unten als #1 gekennzeichnet). Auf dieser Seite finden Sie eine Kartenansicht (#2) , die Sie für die Suche nach VPS-aktivierten Standorten verwenden können. Wenn Sie einen VPS-aktivierten Standort auswählen, wird das 3D-Mesh des Standorts angezeigt (#3), so dass Sie überprüfen können, ob Sie den richtigen Standort ausgewählt haben und ihn zu Ihrem Projekt hinzufügen können (#4).

Wenn Sie einen VPS-aktivierten Standort zu Ihrem Projekt hinzufügen, sehen Sie den Standort in der Tabelle "Projekt Standorte" im Geospatial Browser (in der Abbildung unten als #1 gekennzeichnet). Sobald Sie einen Standort in der Tabelle "Projektstandorte" haben, können Sie die Schaltfläche "Herunterladen" (#2) verwenden, um eine GLB- oder OBJ-Version des 3D-Meshes herunterzuladen (als #3 angezeigt) und es in 3D-Softwareanwendungen von Drittanbietern zu öffnen, wie z. B. Blender, oder es direkt in Ihr 8th Wall-Projekt zu importieren. Wenn Sie in auf Standorte verweisen, müssen Sie das Feld "Name" (#4) aus der Tabelle "Projektstandorte" kopieren.

Wenn der Standort, den Sie in Ihrem Projekt verwenden möchten, nicht als VPS-Standort verfügbar ist, können Sie den Standort erstellen, indem Sie den Anweisungen im Abschnitt Neuen Standort erstellen folgen.

Neuen Standort erstellen

1. Klicken Sie auf einen freien Punkt auf der Karte, um den Ort auszuwählen, an dem Sie einen neuen VPS-Standort erstellen möchten. Unter Anforderungen an den VPS-Standort erfahren Sie mehr über die Auswahl eines guten Ortes für , um einen VPS-Standort zu erstellen.

2. Arbeitsbereiche mit den Plänen "Pro" oder "Enterprise" haben die Option Öffentlichen Standort erstellen oder Privaten Standort erstellen. Öffentliche Standorte sind für alle Entwickler und Personen zugänglich, die und ihre Projekte verwenden, während private Standorte nur für Ihren Arbeitsbereich und und seine Projekte sichtbar und zugänglich sind. Die Erstellung eines öffentlichen Standorts ist für die meisten Projekte die richtige Wahl; private Standorte sind eine Premium-Funktion für Entwickler, die spezielle zugangskontrollierte oder temporäre VPS Erfahrungen erstellen müssen. Klicken Sie entweder auf die Schaltfläche Öffentlichen Standort erstellen oder auf die Schaltfläche Privaten Standort erstellen , um die Erstellung des Standorts zu starten.

3. Prüfen Sie auf Duplikate: Bevor Sie einen neuen Standort erstellen, müssen Sie überprüfen, ob Ihr Standort nicht bereits existiert. Vergleichen Sie Ihren gewünschten Standort mit anderen, die bereits auf der Karte vorhanden sind, um sicherzustellen, dass Sie kein Duplikat erstellen. Wenn es sich nicht um einen doppelten Standort handelt, müssen Sie das Kontrollkästchen Mein Standort ist kein Duplikat aktivieren und auf die Schaltfläche Weiter klicken, um fortzufahren.

4. Standortinformationen hinzufügen: Standort-Metadaten sind für Entwickler sichtbar, die den Geospatial Browser verwenden, und können für Endbenutzer sichtbar sein. Denken Sie daran, dass das Trust & Safety Team von Niantic die von Ihnen zur Verfügung gestellten Informationen verwendet, um festzustellen, ob der Standort unsere Kriterien erfüllt, um öffentlich zugänglich gemacht zu werden. Sobald Sie die folgenden Informationen für den Standort, den Sie erstellen möchten, eingegeben haben, klicken Sie auf auf die Schaltfläche Submit:

• Titel (125 Zeichen)
• Beschreibung (250 Zeichen)
• Kategorie (1 oder mehr)
• Bild (falls verfügbar)

5. Ihr Standort sollte sofort mit seinem Typ ("Öffentlich" oder "Privat") und dem Status ("Nicht aktiviert") zu Ihrer Registerkarte "Standortübermittlung" im Geospatial Browser hinzugefügt werden. Sie wird innerhalb weniger Minuten auf zum Scannen verfügbar sein und die VPS-Aktivierung kann angefordert werden, sobald sie vollständig gescannt wurde.

Scaniverse für Niantic-Entwickler (iOS Beta)

info

**Scaniverse für Niantic-Entwickler ist in der Beta-Version für iOS-Geräte verfügbar. Android-Unterstützung folgt in Kürze.

Wir führen derzeit eine Beta-Version von Scaniverse für Niantic-Entwickler durch, die den Geospatial Browser (GSB) nahtlos mit dem preisgekrönten Scaniverse-Erlebnis verbindet. Mit werden die Arbeitsabläufe von Entwicklern beim Durchsuchen der Karte, beim Hinzufügen von Standorten und beim Scannen von erheblich vereinfacht:

• Wir haben den Geospatial Browser (GSB) mobilfreundlich gestaltet, so dass er innerhalb von Scaniverse effektiv genutzt werden kann, um die Karte zu durchsuchen, Standorte zu prüfen, Standorte hinzuzufügen und die VPS-Aktivierung anzufordern.
• Wir haben den Anmeldevorgang in der Wayfarer-App durch einen einfachen QR-Code ersetzt, der Scaniverse mit Ihrem 8th Wall-Konto verbindet.
• Wir haben die bestehende Benutzeroberfläche von Scaniverse übernommen, um das Erstellen und Hochladen von Scans zu erleichtern.
• Wir haben das Testen der Lokalisierung an VPS-aktivierten Standorten in Scaniverse aktiviert
• Wir haben unsere neuesten Verbesserungen in die Kartenfilterung integriert, um die Suche nach dem/den Standort(en), die Sie suchen, noch einfacher zu machen.

8th Wall-Entwickler mit iOS-Geräten können die Beta-Version jetzt ausprobieren, indem sie die folgenden Anweisungen befolgen.

Verknüpfung von Scaniverse mit dem Geospatial Browser (GSB)

Voraussetzung: Installieren Sie Scaniverse aus dem iOS App Store. Die Unterstützung für Android-Geräte ist in Vorbereitung.

1. Melden Sie sich auf Ihrem Desktop bei Ihrem 8th Wall-Konto an. Öffnen Sie den Geodaten-Browser (GSB), wählen Sie einen beliebigen Ort auf der Karte aus, und wählen Sie dann Details anzeigen. Drücken Sie in der unteren rechten Ecke der Karte mit den Standortangaben auf QR-Code generieren. Es wird ein QR-Code angezeigt.

2. Scannen Sie den QR-Code mit Ihrer Kamera-App. Öffnen Sie die Kamera-App auf Ihrem Telefon und richten Sie sie auf den QR-Code.

3. Tippen Sie auf den Link Scaniverse, der angezeigt wird. Dadurch wird Scaniverse mit Ihrem 8th Wall Entwicklerkonto verknüpft. Dieser Vorgang muss nur einmal durchgeführt werden.

   info

   Stellen Sie sicher, dass Sie www.8thwall.com erlauben, Ihren aktuellen Standort zu verwenden, wenn Sie dazu aufgefordert werden; dies ist für den ordnungsgemäßen Betrieb der GSB-Schnittstelle erforderlich.

4. Sobald Sie Scaniverse mit GSB verknüpft haben, können Sie jederzeit zum GSB-Bildschirm zurückkehren , indem Sie auf die GSB-Schaltfläche in der unteren Leiste der Scaniverse-App tippen. Beachten Sie, dass Sie Scaniverse jederzeit vom GSB trennen können, indem Sie im Menü Einstellungen die Option Niantic Entwicklermodus deaktivieren.

5. Alle Scans, die du außerhalb des Niantic-Entwicklermodus gemacht hast, bleiben zugänglich, wenn Scaniverse mit GSB verknüpft/entkoppelt.

Durchsuchen der GSB-Karte in Scaniverse

1. Wenn Sie auf das Symbol Person tippen, können Sie Ihren 8. Wandarbeitsplatz auswählen.

2. Wenn Sie auf die Schaltfläche Hochladen tippen, können Sie die hochzuladenden Ortsscans auswählen. Beachten Sie, dass nur Scans, die aus dem Niantic-Entwicklermodus stammen (unter Verwendung der Optionen "Scans hinzufügen" oder "Testscan"), zu Niantic für VPS-Entwicklungszwecke hochgeladen werden können .

3. Wenn Sie auf die Schaltfläche Plus tippen, können Sie neue Standorte und Testscans erstellen.

4. Durch Tippen auf die Schaltfläche Ebenen können Sie die Satellitenansicht der Karte einschalten.

5. Durch Tippen auf die Schaltfläche Reticule wird die Karte auf Ihren Standort zentriert.

6. Wenn Sie auf die Schaltfläche Kompass tippen, wird die Karte wieder auf die Standardausrichtung nach Norden zurückgesetzt.

7. Über die Schaltfläche Steuerung können Sie die Standorte, die auf der Karte angezeigt werden, nach Größe, Kategorie oder Aktivierungsstatus filtern.

8. Die Schaltfläche Lupe ermöglicht Ihnen die Suche auf der Karte.

9. Durch Tippen auf die Schaltfläche X wird der GSB geschlossen und Sie kehren zum Scaniverse-Startbildschirm zurück.

10. Wenn Sie einen Ort auf der Karte auswählen, wird ein Vorschaubildschirm angezeigt, auf den Sie tippen können, um weitere Informationen zu zu erhalten.

11. Wenn Sie einen VPS-aktivierten Standort ausgewählt haben, können Sie auf die Schaltfläche VPS testen tippen, um zu überprüfen, ob die Lokalisierung funktioniert.

12. Um einen Scan zu erstellen, der einem bestimmten Ort hinzugefügt werden soll, tippen Sie auf die Schaltfläche Scans hinzufügen des entsprechenden Ortes. Beachten Sie, dass Sie sich in der Nähe des Ortes befinden müssen, damit die Option Scans hinzufügen verfügbar ist.

Erstellen und Hochladen von Scans

1. Die Schaltfläche Aufzeichnen dient zum Starten und Stoppen des Scanvorgangs.

2. Mit der Schaltfläche Pause können Sie den Scanvorgang vorübergehend unterbrechen, falls gewünscht.

3. Die Anzeige Zeit zeigt die Dauer des aktuellen Suchlaufs an. Eine Mindestlänge von 15 Sekunden ist erforderlich, damit ein Scan für den Upload für VPS-Entwicklungszwecke geeignet ist. Eine Scanlänge von 30-60 Sekunden ist ideal (Scans, die länger als 60 Sekunden dauern, werden in mehrere Teile aufgeteilt, um zu verarbeiten).

4. Durch Tippen auf die Schaltfläche X kehren Sie zum Startbildschirm von Scaniverse zurück.

5. Wenn Sie einen Scan abgeschlossen haben, können Sie ein Vorschaunetz der von Ihnen erfassten Szene einsehen.

6. Wenn Sie mit Ihrem Scan zufrieden sind, können Sie ihn sofort hochladen, indem Sie auf die Schaltfläche Upload Scan klicken.

7. Sie können auch Später hochladen wählen, wenn Sie eine WiFi-Verbindung nutzen möchten (empfohlen).

8. Wenn Sie mit Ihrem Scan nicht zufrieden sind, können Sie ihn durch Drücken der Taste Löschen verwerfen.

Installieren von Niantic Wayfarer

Um neue VPS-Standorte zu scannen oder Scans zu bereits aktivierten Standorten hinzuzufügen, musst du unter die Niantic Wayfarer-App auf deinem Handy installieren. Hinweise zur Installation und Verwendung finden Sie unter .

iOS

Die Niantic Wayfarer App erfordert iOS 12 oder neuer und ein iPhone 8 oder neuer. Ein LiDAR-fähiges Gerät ist nicht erforderlich.

Um die Niantic Wayfarer App zu installieren, gehen Sie auf Testflug für Niantic Wayfarer (8th.io/wayfarer-ios) auf Ihrem iOS-Gerät.

Niantic Wayfarer verwenden

Du kannst mit der Niantic Wayfarer App Scans zu Öffentliche Orte hinzufügen sowie Test-Scans erstellen.

Sobald Sie die App installiert haben, melden Sie sich mit Ihren 8th Wall-Zugangsdaten an, indem Sie auf die Schaltfläche Login with 8th Wall klicken.

Wenn Sie Zugang zu mehreren Arbeitsbereichen haben, wählen Sie einen Arbeitsbereich aus, indem Sie auf der Profilseite auf das Dropdown-Menü 8th Wall Workspace klicken.

Login-Seite	Profilseite

Wählen Sie auf der Seite Karte einen VPS-Standort, um einen Scan zu einem öffentlichen Standort hinzuzufügen (1), oder wählen Sie Scan, um einen Testscan zu Ihrem Arbeitsbereich hinzuzufügen (2).

Machen Sie einen Scan des Bereichs mit der empfohlenen Scan-Technik.

Karte Seite	Seite scannen

Wählen Sie nach Abschluss des Scans entweder „Öffentlich“ oder „Test“ aus und laden Sie dann die Datei hoch.

Scan-Typ	Scan-Upload

Die Verarbeitung von Scans kann 15-30 Minuten dauern. Sobald die Scans verarbeitet sind, werden sie im Geodaten-Browser angezeigt.

Fragen zum Scannen oder zur Verarbeitung richten Sie bitte an support@lightship.dev.

Weitere Informationen zur Verwendung der Wayfarer-App finden Sie in der Lightship-Dokumentation.

Scan-Technik

Gescannte VPS-aktivierte Standorte sollten nicht größer sein als ein Durchmesser von 10 Metern um den Standort herum. Eine typische Statue würde zum Beispiel als VPS-aktivierter Standort funktionieren. Ein ganzes Gebäude jedoch nicht, . Ein Gesicht oder eine Tür/ein Eingang zu einem Gebäude könnte funktionieren. Wir empfehlen, sich zunächst auf kleinere Flächen zu beschränken (z. B. einen Schreibtisch, eine Statue oder ein Wandbild).

Bevor Sie scannen, sollten Sie sich Ihrer Umgebung bewusst sein und sicherstellen, dass Sie das Recht haben, den Ort zu betreten, den Sie scannen.

1. Überprüfen Sie den zu scannenden Bereich und die Umgebung des gescannten Objekts, um festzustellen, ob es irgendwelche Hindernisse gibt, und um eine Scanroute auszuwählen. Bevor Sie mit dem Scannen beginnen, müssen Sie die Route planen, die Sie für verwenden möchten.

2. Stellen Sie sicher, dass Ihre Kamera scharf eingestellt ist. Kameraverwacklungen können die 3D-Rekonstruktion negativ beeinflussen. Halten Sie Ihr Telefon so nah wie möglich an Ihrer Seite, um Unschärfe zu vermeiden. Gehen Sie um das Objekt herum, das Sie scannen, anstatt an einer Stelle zu stehen und Ihr Telefon zu bewegen.

3. Gehen Sie in einem langsamen und natürlichen Schritttempo. Bewegen Sie sich beim Scannen langsam und gleichmäßig. Plötzliche Richtungsänderungen sind ein absolutes Tabu. Bewegen Sie sich langsam und gleichmäßig mit den Füßen auf dem Boden. Wenn Sie in einer dunkleren Umgebung scannen, ist es noch wichtiger, dass Sie sich langsam und gleichmäßig bewegen. Bewegen Sie das Telefon mit Ihnen, während Sie sich bewegen (z. B. beim Krabbengehen).

4. Der VPS-Standort sollte immer im Mittelpunkt stehen. Damit wir die Karte erstellen können, ist es wichtig, dass sich auf den VPS-Standort konzentriert und die volle 360°-Umlaufbahn davon erfasst. Wenn es nicht sicher oder nicht möglich ist, einen 360°-Rundumblick zu erhalten, sollten Sie so viel wie möglich aufnehmen.

5. Variieren Sie die Entfernung/Winkel (0-10m oder 0-35ft). Damit die 3D-Karte in verschiedenen Szenarien gut funktioniert, ist es wichtig, dass wir die Umgebung des Standorts erfassen und eine Vielzahl von verschiedenen Scans haben. Es ist wichtig, dass Sie beim Scannen des Standorts die Entfernung und den Winkel variieren.

Video der empfohlenen VPS-Standort-Scan-Technik:

Dinge, die Sie beim Scannen vermeiden sollten

1. Vermeiden Sie das Scannen, wenn die Umgebung nicht sicher ist, z. B. mitten auf der Straße oder auf einem Spielplatz mit Kindern.

2. Vermeiden Sie es, den Standort zu scannen, wenn er zu weit entfernt ist (>10m oder 35ft) oder zu groß, um ihn mit der Kamera zu fokussieren .

3. Vermeiden Sie das Scannen, während Sie einen Spaziergang machen oder joggen. Es ist wichtig, dass Sie den Standort immer im Blick haben.

4. Vermeiden Sie es, Ihr Telefon auf sehr helle Objekte wie Neonröhren oder die Sonne zu richten.

5. Vermeiden Sie es, sich beim Scannen nicht oder zu schnell zu bewegen. Abrupte Bewegungen führen zu Verschiebungen in der Rekonstruktion.

6. Vermeiden Sie das Scannen, wenn Ihr Telefon zu heiß wird. Wenn die Temperatur des Geräts zu hoch ansteigt, wird die Leistung des Geräts stark reduziert, was sich negativ auf den Scanvorgang auswirkt.

7. Vermeiden Sie es, Scans hochzuladen, die unvollständig oder nicht repräsentativ für das sind, was Sie zu scannen versuchen .

Test-Scans

Test-Scans sind ein einzelnes Mesh, das nur einem Workspace zur Verfügung steht, um VPS Erfahrungen zu entwickeln und zu testen. Während Test-Scans eine großartige Lösung für die Entwicklung und das Testen von VPS-Erfahrungen sind, während ein öffentlicher Standort nominiert oder aktiviert wird, sind sie nicht für die Verwendung in veröffentlichten Projekten zugelassen.

Test-Scans werden mit der Niantic Wayfarer-App erstellt. Vergewissern Sie sich, dass Sie mit den Zugangsdaten von 8th Wall bei Wayfarer angemeldet sind und dass der richtige Arbeitsbereich auf der Profilseite ausgewählt ist. Der Test-Scan ist nur im ausgewählten 8th Wall-Workspace zum Zeitpunkt des Scannens und Hochladens verfügbar. Scans können nicht auf einen anderen Arbeitsbereich oder ein anderes Lightship-Konto verschoben werden.

Wählen Sie in der Wayfarer-App die Option Scannen und machen Sie einen Scan des Bereichs.

Test-Scans sollten 60 Sekunden oder weniger dauern; alle 60 Sekunden wird ein neues Mesh generiert – ein Scan von für 120 Sekunden ergibt also 2 Test-Scans. Alle Testscans sind unaligned.

Nach der Verarbeitung können Sie eine Vorschau des Mesh anzeigen und dieses über die Registerkarte Test Scans des Geodatenbrowsers Ihrem Projekt hinzufügen.

Wenn Ihr Test-Scan nicht verarbeitet werden kann, müssen Sie möglicherweise einen neuen Scan durchführen. Wenden Sie sich an support@lightship.dev für weitere Informationen.

Standorttypen

Im Geospatial Browser sehen Sie vier verschiedene Arten von Standorten:

Typ	Symbol	Beschreibung
Öffentlich		"Öffentliche" Standorte wurden vom Trust & Safety Team von Niantic genehmigt und erfüllen die erforderlichen Kriterien für Sicherheit und öffentliche Zugänglichkeit. Diese Standorte können in veröffentlichten Projekten verwendet werden.
Ausstehend		"Ausstehende" Standorte werden vom Trust & Safety Team von Niantic überprüft, um festzustellen, ob sie die erforderlichen Kriterien für Sicherheit und öffentliche Zugänglichkeit erfüllen. Dieser Vorgang kann bis zu 2 Arbeitstage dauern. Ausstehende Standorte können gescannt und aktiviert werden, während Sie auf den Abschluss der Überprüfung warten.
Abgelehnt		"Abgelehnte" Orte können die Vertrauens- und Sicherheitsprüfung von Niantic nicht bestanden haben, ein Duplikat eines bestehenden oder zuvor abgelehnten Ortes sein oder von Niantic aus einem anderen Grund nicht zugelassen werden. Diese Standorte können nicht zu Projekten hinzugefügt werden.
Test		"Test"-Standorte sind für deinen Arbeitsbereich nur zugänglich, wenn du den Standort mit der Wayfarer-App von Niantic scannst. Testlokationen sind für die Verwendung während der Entwicklung vorgesehen und dürfen nicht in ein veröffentlichtes Projekt aufgenommen werden.

Bei Fragen oder Problemen im Zusammenhang mit der Erstellung von VPS-Standorten oder um den Status eines bestehenden Standorts zu überprüfen, wenden Sie sich bitte an support@lightship.dev

Standort Status

Im Geospatial Browser sehen Sie fünf verschiedene Status für VPS-Standorte:

Status	Symbol	Beschreibung
Nicht aktiviert		Bei Standorten mit dem Status "Nicht aktiviert" wurden keine Scans für den Standort eingereicht. Es müssen mindestens 10 brauchbare Scans für den Standort eingereicht werden, bevor Sie die Aktivierung beantragen können. Nachdem ein Scan durchgeführt wurde, ändert sich der Status des Standorts auf "Scanning".
Scannen von		Bei Standorten mit dem Status "Scanning" wurde mindestens ein Scan für den Standort durchgeführt. Es müssen mindestens 10 brauchbare Scans für den Standort eingereicht werden, bevor Sie die Aktivierung beantragen können.
Verarbeitung		Standorte mit dem Status "in Bearbeitung" haben einen Aktivierungsantrag gestellt und zeigen den Status "in Bearbeitung" an, bis der Aktivierungsprozess abgeschlossen ist. **In der Regel wird eine Aktivierungsanfrage innerhalb von 4 Stunden bearbeitet. Sie erhalten eine E-Mail, wenn der Vorgang abgeschlossen ist
Aktiv		Standorte mit dem Status "Aktiv" können in Projekten zur Erstellung von WebAR-Inhalten mit VPS for Web verwendet werden.
Gescheitert		Bei Standorten mit dem Status "Fehlgeschlagen" ist während des Aktivierungsprozesses ein Problem aufgetreten. Dies könnte auf eine Reihe von Faktoren zurückzuführen sein, wie z.B. eine schlechte Eignung des Standorts für VPS, unzureichende Scans oder beschädigte Daten. Leider bedeutet dies, dass dieser Standort nicht für die Erstellung von WebAR-Inhalten mit VPS verwendet werden kann. Wir möchten Sie ermutigen, einen neuen Standort für Ihr Projekt an der 8.

Bei Fragen oder Problemen im Zusammenhang mit Standort-Scans, Aktivierung oder Status wenden Sie sich bitte an support@lightship.dev

Standortanforderungen

Bei der Wahl eines Standortes für die Nutzung von VPS sollten Sie Folgendes beachten:

• VPS funktioniert am besten an Orten, die ein klares und einheitliches Erscheinungsbild haben (z. B. ein Sandstrand oder ein überfüllter Innenhof mit beweglichen Möbeln funktioniert nicht gut).
• Standorte, die von reflektierenden oder transparenten Elementen (z. B. Fenstern und Spiegeln) dominiert werden, sind nicht zu empfehlen.
• Je größer das Erlebnis ist, desto mehr Scans müssen Sie durchführen, um den Raum zu erfassen. Die von empfohlene Maximalgröße für ein VPS-Erlebnis beträgt heute 400 m^2 (20 x 20 m), obwohl größere Erlebnisse mit sorgfältigen Scans unterstützt werden können .

Anforderungen an öffentliche Standorte

Öffentliche Standorte sind für alle Entwickler und Personen, die ihre Projekte und Anwendungen nutzen, zugänglich. Wenn Sie unter einen neuen öffentlichen Standort hinzufügen, beachten Sie bitte die folgenden Richtlinien:

• Öffentliche Orte sollten dauerhafte physische, greifbare und identifizierbare Orte oder Objekte sein.
• Öffentliche Standorte sollten für Fußgänger sicher und öffentlich zugänglich sein.
• Achten Sie darauf, dass der Titel, die Beschreibung und das Foto genaue Informationen enthalten, damit Ihre Nutzer den Ort finden können.

Anforderungen an private Standorte

Private Standorte sind ein Premium-Feature für Entwickler, die spezielle zugangskontrollierte oder temporäre VPS-Erlebnisse schaffen müssen. Sie sind nur für den Arbeitsbereich, der sie erstellt hat, sichtbar und zugänglich. Wenn Sie einen neuen privaten Standort erstellen, beachten Sie bitte Folgendes:

• Private Standorte sind nur von dem Arbeitsbereich auffindbar, in dem sie erstellt wurden, so dass sie nur von Mitgliedern und Benutzern der Projekte dieses Arbeitsbereichs unter durchsucht und lokalisiert werden können.
• Private Standorte sind eine gute Wahl, wenn Sie ein spezielles zugangskontrolliertes Erlebnis bauen (z. B. auf Ihrem oder dem Privatgrundstück Ihres Kunden).
• Private Standorte sind auch eine Option, wenn Sie ein Erlebnis an einem öffentlichen Ort aufbauen, der vorübergehend ein anderes Aussehen hat (z. B. ein Konzert, eine Museumsausstellung oder eine andere besondere Veranstaltung).

Standort Mengen

Es gibt keine Begrenzung für die Anzahl der Standorte, die mit einem 8th Wall-Projekt verbunden werden können. Die Standorte werden serverseitig über den VPS-Dienst lokalisiert.

Standort Veranstaltungen

8th Wall sendet Ereignisse in verschiedenen Phasen des Lebenszyklus des Projektstandorts (z. B. Scannen, gefunden, aktualisiert, verloren, usw.). Bitte lesen Sie die API-Referenz für spezifische Anweisungen zur Handhabung dieser Ereignisse in Ihrer Webanwendung:

• AFrame Ereignisse
• PlayCanvas Ereignisse
• XrController Versendete Ereignisse

Standortqualität

Nachdem ein Standort in der VPS aktiviert wurde, gibt Niantic im Geospatial-Browser eine Qualitätsbewertung ab. Die Ortsangaben zeigen entweder Mäßige Qualität oder Gute Qualität.

Die Standortqualität bezieht sich auf die Fähigkeit des Standorts, jederzeit zu lokalisieren. Standorte mit mehreren Scans in allen Beleuchtungsarten haben in der Regel eine höhere Qualität. Standorte mit einem Minimum an erforderlichen Scans oder einer Mehrheit von Scans bei einer bestimmten Beleuchtungsart haben tendenziell eine geringere Qualität.

Die Qualitätsbewertung ist ein automatischer Prozess und spiegelt möglicherweise nicht die tatsächliche Leistung des Standorts wider. Der beste Weg, die Qualität zu bestimmen, ist, es selbst auszuprobieren.

Standortausrichtung

Die nicht ausgerichtete Warnung kann aus verschiedenen Gründen auftreten und bedeutet, dass die Lokalisierung gegenüber dem Netz nicht garantiert werden kann . Obwohl das Netz gut für die Lokalisierung geeignet ist, weist die Warnung darauf hin, dass das Netz experimentell ist und auf eigene Gefahr verwendet werden sollte.

Hinweis: Alle Test-Scans sind nicht ausgerichtet.

Aktivieren von Lightship VPS

Um VPS in Ihrem WebAR-Projekt zu aktivieren, müssen Sie enableVPS auf true setzen.

Für A-Frame-Projekte setzen Sie enableVps: true auf der Komponente xrweb auf der Seite <a-scene>

Für Non-AFrame-Projekte setzen Sie enableVps: true in dem Aufruf von XR8.XrController.configure() vor dem Start der Engine .

Beispiel - AFrame

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

Beispiel - Non-AFrame

XR8.XrController.configure({enableVps: true})
// Dann starten Sie die 8th Wall Engine

Entwicklung von maßgeschneiderten VPS-Erfahrungen

Maßgeschneiderte VPS-Szenen sind für einen einzigen Standort konzipiert und verwenden ein Referenznetz aus dem Geospatial Browser, um AR-Inhalte auszurichten.

Teil 1: Standort zur Szene hinzufügen

1. Öffnen Sie den Geospatial Browser (Kartensymbol 🗺 auf der linken Seite)
2. Finden Sie einen VPS-aktivierten Standort (oder nominieren/aktivieren Sie Ihren eigenen)
3. Hinzufügen des Standorts zum Projekt

Teil 2: Standort-GLB als Referenz für benutzerdefinierte AR-Animation verwenden

4. Laden Sie die Referenz-GLB auf der rechten Seite der Zeile herunter.
5. Verwenden Sie dies in Ihrer 3D-Modellierungssoftware (Blender, Maya, A-Frame, etc.), um AR-Inhalte relativ zum Mesh-Ursprung zu positionieren.

WICHTIG: Der Ursprung dieses 3D-Modells ist der Ursprung des Standorts. SETZEN SIE DEN URSPRUNG NICHT ZURÜCK, SONST WIRD IHR INHALT NICHT AUSGERICHTET.

OPTIONAL: Wenn das aus dem Geospatial Browser heruntergeladene Mesh nicht hochwertig genug ist, um es für eine gebackene Animation, Physik oder Okkluder-Material zu verwenden, können Sie einen Scan mit einer Anwendung eines Drittanbieters wie Scaniverse erstellen und dieses hochwertige Mesh mit dem aus dem Geospatial Browser heruntergeladenen ausrichten.

6. Animation GLB in Cloud Editor importieren und zur Szene hinzufügen
7. Fügen Sie die Komponente "named-location" zu Ihrem Asset <a-entity> hinzu. Das Attribut "Name" bezieht sich auf den "Namen" des Projektstandorts im Geospatial Browser.

Ta-da! 🪄 Ihre Animation sollte auf den Standort in der realen Welt ausgerichtet sein.

Teil 3: Hinzufügen von Okklusion und Schatten

1. Fügen Sie in Ihrer Szene <a-entity named-location="name: LOCATIONNAME"><a-entity> hinzu.
2. Fügen Sie drei <a-entity> innerhalb dieses Elements als dessen Kinder hinzu. Dies sind das Okkluder-Mesh, das Schatten-Mesh und die VPS-Animation.
3. Im ersten <a-entity> fügen Sie "xrextras-hider-material" und "gltf-model="#vps-mesh" hinzu. "#vps-mesh" sollte auf eine Version Ihrer Referenz-GLB verweisen, bei der die Texturen entfernt und die Geometrie dezimiert wurde.
4. In der zweiten <a-entity>, fügen Sie shadow-shader, gltf-model="#vps-mesh" und shadow="cast: false" hinzu. Der Schattenshader wendet ein Schattenmaterial auf das Referenzmesh mit einem Polygonversatz an, um Z-Fighting zu verhindern. Mit shadow="cast: true" kann man wählen, ob das vps-mesh einen Schatten auf die reale Welt werfen soll.
5. Im dritten <a-entity> fügen Sie gltf-model="#vps-anim", reflections="type: realtime", play-vps-animation und shadow="receive:false" hinzu. play-vps-animation" wartet, bis das "vps-coaching-overlay" verschwunden ist, bevor die VPS-Animation abgespielt wird.

Remote-Desktop-Entwicklungseinrichtung

Es ist oft hilfreich, den A-Frame-Inspektor zu verwenden, um Inhalte an entfernten Stellen auf dem Desktop zu positionieren. Um die Szene dieses Projekts für die Remote-Desktop-Entwicklung einzurichten, deaktivieren Sie die folgenden Komponenten , indem Sie einen Buchstaben am Anfang hinzufügen (z. B. "Znamed-location"):

• xrweb" -> "Zxrweb
• xrextras-loading" -> "Zxrextras-loading".
• benannter-Ort" -> "benannter-Ort
• xrextras-verstecken-Material" -> "Zxrextras-verstecken-Material".

Nun können Sie den A-Frame Inspector (Mac: ctrl + opt + i, PC: ctrl + alt + i) öffnen und den Inhalt relativ zu dem aus dem Geospatial Browser importierten VPS-Netz positionieren. Denken Sie daran: Dies ist ein Inspector. Sie müssen die Transformationswerte zurück in Ihren Code kopieren.

Optional können Sie die <a-entity named-location> vorübergehend in die Mitte der Szene verschieben, um die Iterationsgeschwindigkeit zu erhöhen. HINWEIS: Setzen Sie <a-entity named-location> auf Position="0 0 0" zurück, um sicherzustellen, dass der Inhalt von VPS korrekt ausgerichtet ist.

Remote Mobile Development Setup

Es ist oft hilfreich, den A-Frame-Inspektor zu verwenden, um VPS aus der Ferne auf Ihrem mobilen Gerät zu simulieren. Um die Szene dieses Projekts für die mobile Fernentwicklung einzurichten, deaktivieren Sie die folgenden Komponenten , indem Sie einen Buchstaben am Anfang hinzufügen (z. B. "Znamed-location"):

• benannter-Ort" -> "benannter-Ort
• xrextras-verstecken-Material" -> "Zxrextras-verstecken-Material".

Als nächstes müssen Sie VPS deaktivieren und absolute Skalierung aktivieren. Dadurch wird sichergestellt, dass das Referenznetz die richtige Größe für eine genaue Simulation hat:

xrweb="enableVps: false; scale: absolute;"

Um die Iterationsgeschwindigkeit zu erhöhen, sollten Sie die <a-entity named-location> vorübergehend in die Mitte der Szene verschieben. Versuchen Sie, die Basis Ihres Referenznetzes mit y="0" (dem Boden) auszurichten. HINWEIS: Bevor Sie Ihr VPS-Projekt bereitstellen, setzen Sie <a-entity named-location> auf position="0 0 0" zurück, um sicherzustellen, dass der VPS-Inhalt korrekt ausgerichtet ist.

Entwicklung von prozeduralen VPS-Erfahrungen

Prozedurale VPS-Szenen sind so konzipiert, dass sie jeden erkannten Standort verwenden können (im Gegensatz zu bestimmten Projektstandorten). Sobald der Standort erkannt wurde, steht Ihnen das Mesh zur Verfügung, um prozedural generierte VPS-Erlebnisse zu erzeugen.

Es gibt zwei verfahrensbezogene Ereignisse, die von der 8th Wall-Engine ausgelöst werden:

• xrmeshfound: wird ausgegeben, wenn ein Netz zum ersten Mal entweder nach dem Start oder nach einem recenter() gefunden wird
• xrmeshlost: wird ausgegeben, wenn recenter() aufgerufen wird.

Nachdem ein Mesh erkannt wurde, verfolgt die 8th Wall Engine dieses Mesh weiter, bis recenter() aufgerufen wird.

VPS-FAQ

Was ist Lightship VPS?

Lightship VPS (Visual Positioning System) ist ein Cloud-Service, der es Anwendungen ermöglicht, das Gerät eines Nutzers an realen Orten zu lokalisieren, so dass Nutzer mit persistenten AR-Inhalten interagieren können und neue immersive Erfahrungen ermöglicht. VPS bestimmt die Position und Ausrichtung (Pose) des Geräts, indem auf Kartendaten in der Cloud von Niantic verweist.

Wie funktioniert VPS?

Wenn ein Gerät den VPS-Dienst anruft, empfängt der Dienst ein Abfrage-Bild vom Gerät des Benutzers zusammen mit dessen ungefährem Standort (von GPS) als Eingaben und versucht, ihn anhand der Karte(n) zu lokalisieren, die an diesem Standort existieren. Bei erfolgreicher Lokalisierung gibt der Dienst die Position und Ausrichtung (Pose) des Geräts zurück, die mit dem Zeitstempel des übermittelten Bildes übereinstimmen. Da eine Zeitverzögerung zwischen der Aufnahme eines VPS-Abfragebildes und dem Empfang einer Antwort von vom VPS-Dienst besteht, muss das Gerät über ein System zur Bewegungsverfolgung ( ) verfügen, um während der Bewegung genau lokalisiert zu bleiben. Wenn der VPS-Dienst eine Posenschätzung an das Gerät sendet, wird der Unterschied in der Pose vom Tracking-System des Geräts zur Antwort der Lokalisierung hinzugefügt, so dass der VPS mit der Bewegung des Geräts "Schritt halten" kann, während er auf die Antwort des Servers auf die VPS-Anfrage wartet.

Was ist ein Scan?

AR-Scans von Spielern, Entwicklern und Vermessern sind die Grundlage für die Erstellung der Niantic Map: Die 3D-Weltkarte von Niantic. AR-Scans werden mit dem AR-Scan-Framework von Niantic aufgezeichnet und hochgeladen, einem Modul, das in Pokemon Go, Ingress und der Wayfarer-App verwendet wird. Jeder AR -Scan besteht aus einer Reihe von Videobildern mit unterstützenden Daten von Beschleunigungsmessern und GPS-Sensoren , die ein 3D-Modell der Welt aus mehreren 2D-Bildern erstellen. AR-Scans werden von Niantic verwendet, um Karten und Meshes von realen Orten zu erstellen.

Was ist eine Karte?

In der VPS-Sprache ist eine Karte das Datenartefakt, das verwendet wird, um Ihr Gerät zu lokalisieren, wenn die VPS-API aufgerufen wird. Eine Karte kann man sich als eine Funktion vorstellen, die ein Abfragebild als Eingabe nimmt und dann Position und Ausrichtung (Pose) als Ausgabe zurückgibt. Die Karte, die einem bestimmten Ort entspricht, wird aus den Scans erstellt, die an diesem Ort hochgeladen wurden. VPS-Karten sind nicht für Menschen lesbar.

Was ist ein Netz?

Im VPS-Jargon ist ein Netz ein 3D-Modell eines realen Ortes oder Objekts. Meshes bieten eine detaillierte Darstellung eines physischen Raums oder Objekts und sind nützlich, um zu verstehen, wie ein Ort aussieht, als Referenz für die Erstellung von AR-Inhalten und für die Erstellung von Physik- und Okklusionseffekten. Wie die Karten von werden Meshes, die einem bestimmten Ort entsprechen, aus den Scans erstellt, die auf hochgeladen wurden. Meshes sind sowohl für Menschen als auch für Maschinen lesbar.

Wo kann ich VPS nutzen?

VPS ist an über 150.000 realen Standorten verfügbar, und täglich kommen weitere Standorte hinzu. Unter muss eine ausreichende Menge an AR-Scandaten auf hochgeladen und der VPS-Aktivierungsprozess abgeschlossen werden, damit ein Standort auf der VPS verfügbar ist. Entwickler können neue Standorte auf der Karte hinzufügen und die VPS-Aktivierung vollständig gescannter Standorte über den Geospatial Browser anfordern.

Wie funktioniert die VPS-Aktivierung?

Damit ein Standort für die VPS-Aktivierung in Frage kommt, müssen mindestens 10 Scans hochgeladen werden, die die Mindestqualitätsprüfungen von bestehen, und die Zeitdifferenz zwischen den ältesten und neuesten Scans am Standort muss mindestens 5 Stunden betragen. Diese Anforderungen stellen sicher, dass die resultierenden Karten und Netze von ausreichender Qualität sind und genügend Variationen erfassen, so dass die Benutzer in der Lage sind, zuverlässig zu lokalisieren. Der VPS-Aktivierungsprozess läuft über die AR-Mapping-Infrastruktur von Niantic und umfasst viele komplexe Schritte . Aus dem Pool der in Frage kommenden Scans am Standort wählt ein Algorithmus die meisten Scans aus, um für die Erstellung von Karten und Netzen zu verwenden, und die verbleibende Handvoll für die Validierung und die Messung der Lokalisierungsqualität . Der Aktivierungsprozess für einen Standort läuft auf den Servern von Niantic und dauert normalerweise 1-2 Stunden.

Kann ich meine Scans finden, nachdem die VPS-Aktivierung abgeschlossen ist?

Während des Aktivierungsprozesses werden die Karten und Netze, die aus den hochgeladenen Scans erstellt wurden, mit verschmolzen, um so viele Informationen wie möglich einzubeziehen. Das Endprodukt, das von Entwicklern zur Erstellung von Inhalten und von Benutzern zur Lokalisierung verwendet wird, besteht aus Scans aus vielen verschiedenen Quellen. Die Scandaten werden gemischt, um eine umfassendere Darstellung des Standorts zu erstellen, . Es besteht also keine Eins-zu-eins-Beziehung zwischen den Scans, die an einem Standort hochgeladen werden, und den Karten und Netzen, die nach der VPS-Aktivierung erstellt werden.

Kann ich weitere Scans zu einem bereits aktivierten Standort hinzufügen?

In manchen Fällen möchten Entwickler zusätzliche Scans zu einem Standort hinzufügen, der zuvor unter aktiviert wurde, um die Qualität und den Abdeckungsgrad der Karten und Meshes des Standorts zu verbessern. Damit ein Standort für eine "Reaktivierung" in Frage kommt, müssen seit der letzten Aktivierung mindestens 5 zusätzliche Scans hochgeladen worden sein ( ). Wichtig ist, dass es noch nicht möglich ist, neue Scans zu einer bestehenden fusionierten Karte hinzuzufügen. Vielmehr muss für die Reaktivierung eine neue fusionierte Karte erstellt werden, die die neuen Scans in den Kontext der bestehenden Scans einbezieht.

Wie beantrage ich die VPS-Aktivierung eines neuen Standorts?

Sobald ein Standort genügend Scans hochgeladen hat, um die Anforderungen für die VPS-Aktivierung zu erfüllen (insgesamt mindestens 10 Scans mit einem Zeitunterschied von mindestens 5 Stunden zwischen dem ältesten und dem neuesten Scan), können Entwickler unter die VPS-Aktivierung beantragen, indem sie den Standort in der Wayfarer App oder im Geospatial Browser auswählen und unter auf die Schaltfläche "aktivieren" klicken. Dadurch wird der Ort in die Aktivierungswarteschlange aufgenommen. Normalerweise wird eine Aktivierungsanfrage innerhalb von 2 Stunden bearbeitet. Die Entwickler haben auch die Möglichkeit, die Reaktivierung eines bestehenden Standorts unter zu beantragen, sobald 5 zusätzliche Scans hochgeladen wurden.

Funktioniert VPS auch nachts oder bei schlechten Wetterbedingungen?

VPS funktioniert am besten, wenn eine gute Sichtbarkeit gegeben ist. Um die Wahrscheinlichkeit erfolgreicher VPS-gestützter Erfahrungen zu maximieren, ist es am besten, viele AR-Scans hochzuladen, die eine große Bandbreite verschiedener Bedingungen abdecken (z. B. verschiedene Tageszeiten, verschiedene Wetterbedingungen usw.). Wenn Sie zum Beispiel ein Erlebnis an einem Ort aufbauen, an dem es viel regnet, ist es sehr hilfreich, einige Scans von einem Regentag zu haben .

Benötigen AR-Scanner und VPS Telefone mit LiDAR-Sensoren?

AR-Scanning und VPS erfordern kein LiDAR.