Die ARCore Cloud Anchor API oder der ARCore Cloud Anchor-Dienst bietet Cloud Anchor-Funktionen für iOS-Apps. Nutzer mit iOS- und Android-Geräten können AR-Erlebnisse miteinander teilen.
In diesem Leitfaden erfahren Sie, wie Sie:
- Entwicklungsumgebung für die Arbeit mit Cloud-Ankern einrichten
- Anchors in einer Beispiel-App hosten und auflösen
Vorbereitung
- Xcode Version 13.0 oder höher
- CocoaPods 1.4.0 oder höher bei Verwendung von CocoaPods
- Ein ARKit-kompatibles Apple-Gerät mit iOS 12.0 oder höher (Bereitstellungsziel für iOS 12.0 oder höher erforderlich)
Cloud-Anchors verwenden
In den folgenden Schritten wird anhand der Cloud Anchors-Beispiel-App Aufgaben zum Konfigurieren und Erstellen einer App, die ARCore Cloud Anchors unterstützt
Cloud Anchors-Beispielanwendung abrufen
Klonen Sie das ARCore SDK für iOS von GitHub oder laden Sie es herunter. um den Beispielcode für die App abzurufen.
Öffnen Sie ein Terminal- oder Finder-Fenster und gehen Sie zum Ordner, in den Sie den Klonen kopiert haben oder das SDK heruntergeladen haben.
Den Beispielcode der App findest du in
./arcore-ios-sdk-master/Examples/CloudAnchorExample
.Der Beispielcode für persistente Cloud-Anchors ist in
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
.
Sitzungseinrichtung
Die Beispiel-App führt im Rahmen der Einrichtung des Sitzung:
GARSession
erstellenARSession
erstellen und die AusführungARSessionDelegate
festlegen.- Bestanden:
ARFrame
s zuGARSession
in dersession:didUpdateFrame:
-Methode.
Freigabe der Cloud-Anchor-ID einrichten
Die Beispiel-App "Cloud Anchors" verwendet Firebase, um Cloud Anchor-IDs zwischen Geräte. Sie können in Ihren eigenen Apps eine andere Lösung verwenden.
So richten Sie die Firebase-Datenbank in der Beispiel-App ein:
- Folgen Sie der Firebase-Anleitung zum Hinzufügen von Firebase zu Ihrer App.
- Laden Sie die Datei
GoogleService-Info.plist
herunter, die beim Hinzufügen generiert wurde Firebase zu Ihrer App hinzufügen. - Aktivieren Sie Firebase Storage für das Beispiel:
<ph type="x-smartling-placeholder">
- </ph>
- Gehen Sie zur Firebase Console und wählen Sie das Projekt aus, für das Sie Beispiel-App.
- Wählen Sie das Steuerfeld Database aus.
- Klicken Sie bei der Option Realtime Database auf Get Started.
- Das Menü Security rules for Realtime Database wird geöffnet.
- Wählen Sie Start in test mode aus, um das Beispiel auszuführen.
- Wenn Sie Firebase für eine App verwenden, die Sie veröffentlichen möchten, restriktivere Sicherheitsregeln verwenden.
- Fügen Sie in Xcode Ihrer App die Datei
GoogleService-Info.plist
nebenInfo.plist
.
ARCore API einrichten
Um Cloud-Anker verwenden zu können, müssen Sie zunächst den ARCore API für Ihre Anwendung
Pod-Update ausführen
Die App CloudAnchorExample wird mit einem Podfile
ausgeliefert, das mit dem
ARCore SDK und die erforderlichen iOS-Versionen. So installieren Sie diese Abhängigkeiten:
- Öffnen Sie ein Terminalfenster und führen Sie
pod update
in dem Ordner aus, in dem die Xcode-Projekt ist vorhanden.
Dadurch wird eine.xcworkspace
-Datei generiert, die Sie später zum Erstellen und die App ausführen.
Weitere Informationen finden Sie unter ARCore SDK zur App hinzufügen.
finden Sie weitere Informationen zum Konfigurieren von Podfile
in Ihren eigenen Apps.
Öffnen Sie die Datei
.xcworkspace
für das Projekt in Xcode.Achten Sie darauf, dass Sie aus dem
.xcworkspace
erstellen, um Build-Fehler zu vermeiden und nicht die.xcodeproj
-Datei.
App-Bundle-ID ändern
Ändern Sie in Xcode die Bundle-ID der App, damit Sie die App mit Ihrem Team signieren können.
Anwendung erstellen und ausführen
Verbinden Sie Ihr Gerät und starten Sie die App in Xcode.
(Optional) Wenn Sie die Beispielanwendung erstellen und ausführen, beachten Sie Folgendes: finden Sie weitere Informationen zur Verwendung der Anwendung zum Hosten und Auflösen von Cloud-Anchors.
Beispiel-App testen
Erstellen Sie zum Starten die Beispiel-App aus der Datei
.xcworkspace
und führen Sie sie aus auf Ihrem Gerät.Wenn Sie dazu aufgefordert werden, gewähren Sie der App Kameraberechtigungen. Dann ARKit erkennt Flugzeuge vor der Kamera.
Tippen Sie auf HOST, um den Hostingmodus zu starten. Raumcode zum Freigeben gehosteter Anker generiert und auf Ihrem Bildschirm angezeigt.
Tippen Sie auf ein Flugzeug, um dort einen Wolkenanker zu hosten.
- Die App platziert ein Android-Objekt von Andy im Flugzeug und verbindet einen Anker hinzufügen.
- Eine Hostanfrage wird an den ARCore API-Cloud-Endpunkt gesendet. Host -Anfrage enthält Daten, die die Position des Ankers relativ zu der visuelle Merkmale in der Nähe.
- Sobald der Anker gehostet wird, erhält er eine ID, die zur Auflösung der Cloud die Anker in diesem Bereich.
Tippe auf RESOLVE und gib einen Zimmercode ein, auf den du schon zugreifen möchtest gehostete Cloud-Anchors für diesen Raum auf demselben oder einem anderen Gerät.
- Eine Resolve-Anfrage wird an den Cloud-Endpunkt der ARCore API gesendet.
- Die Resolve-Anfrage enthält eine Cloud-Anchor-ID. Wenn die ID mit einem und die Lokalisierung erfolgreich war, gibt der Server Transformation des Ankers in Ihre lokalen Koordinaten.
- Die Beispiel-App verwendet die Transformation, um den Anker zu Ihrer Szene hinzuzufügen. damit verbundene virtuelle Objekte zu rendern.
ARCore SDK in Apps einbinden
In deinen eigenen Apps musst du auf deinem Gerät (Podfile
) den Parameter
ARCore SDK und unterstützte iOS-Versionsverwaltung Das geht so:
Fügen Sie Folgendes
platform
undpod
hinzu:Podfile
des Projekts:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.45.0'
- Öffnen Sie ein Terminalfenster und führen Sie
pod update
in dem Ordner aus, in dem Ihr Xcode-Projekt existiert.
Dadurch wird eine.xcworkspace
-Datei generiert, die Sie zum Erstellen und führen Sie die App aus.
Persistente Cloud-Anchors
Wie unter Cloud-Anchor mit Persistenz hosten beschrieben,
können Sie dem Cloudanker eine Gültigkeitsdauer von bis zu 365 Tagen geben. Beispielcode für
Die Verwendung persistenter Cloud-Anchors ist in der /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
verfügbar
im ARCore SDK for iOS auf GitHub
Nächste Schritte
Weitere Informationen finden Sie im Entwicklerleitfaden zu Cloud Anchors für iOS. um sich den Beispielcode der Anwendung anzusehen und mehr über die Arbeit mit Cloud-Ankern zu erfahren. in Ihren eigenen Apps.
Weitere Informationen finden Sie in der ARCore iOS API-Referenz.