Kurzanleitung für Cloud Anchors in iOS

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
  • Anker in einer Beispiel-App hosten und auflösen

Vorbereitung

  • Xcode Version 13.0 oder höher
  • CocoaPods 1.4.0 oder höher, wenn Sie CocoaPods verwenden
  • Ein ARKit-kompatibles Apple-Gerät mit iOS 12.0 oder höher (Bereitstellungsziel muss iOS 12.0 oder höher sein)

Cloud-Anchors verwenden

In den folgenden Schritten wird anhand der Beispiel-App „Cloud Anchors“ gezeigt, wie Sie eine App konfigurieren und erstellen, die ARCore Cloud Anchors unterstützt.

Cloud Anchors-Beispielanwendung abrufen

  1. Klonen Sie das ARCore SDK für iOS von GitHub oder laden Sie es herunter. um den Beispielcode für die App abzurufen.

  2. Öffnen Sie ein Terminal- oder Finderfenster und wechseln Sie zum Ordner, in dem Sie das SDK geklont oder heruntergeladen haben.

  3. 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:

Freigabe der Cloud-Anchor-ID einrichten

In der Beispiel-App für Cloud Anchors wird Firebase verwendet, um Cloud Anchor-IDs zwischen Geräten zu teilen. Sie können in Ihren eigenen Apps eine andere Lösung verwenden.

So richten Sie die Firebase-Datenbank in der Beispiel-App ein:

  1. Folgen Sie der Firebase-Anleitung zum Hinzufügen von Firebase zu Ihrer App.
  2. Laden Sie die Datei GoogleService-Info.plist herunter, die beim Hinzufügen von Firebase zu Ihrer App generiert wurde.
  3. Aktivieren Sie Firebase Storage für das Beispiel:
    • Rufen Sie die Firebase Console auf und wählen Sie das Projekt aus, das Sie für die Beispiel-App eingerichtet haben.
    • 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, sollten Sie strengere Sicherheitsregeln verwenden.
  4. Fügen Sie in Xcode Ihrer App die Datei GoogleService-Info.plist neben Info.plist hinzu.

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 installierst du diese Abhängigkeiten:

  1. Öffnen Sie ein Terminalfenster und führen Sie pod update aus dem Ordner aus, in dem sich das Xcode-Projekt befindet.
    Dadurch wird eine .xcworkspace-Datei generiert, mit der Sie die App später erstellen und ausführen können.

Weitere Informationen zum Hinzufügen des ARCore SDK zu Ihrer App

  1. Öffnen Sie die .xcworkspace-Datei 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 sie mit Ihrem Team signieren können.

App erstellen und ausführen

  1. Verbinden Sie Ihr Gerät und starten Sie die App in Xcode.

  2. Optional: Wenn Sie die Beispielanwendung erstellen und ausführen, finden Sie im folgenden Abschnitt Informationen dazu, wie Sie mit der App Cloud-Markierungen hosten und auflösen.

Beispiel-App testen

  1. Erstellen Sie zum Starten die Beispiel-App aus der Datei .xcworkspace und führen Sie sie aus auf Ihrem Gerät.

  2. Gewähren Sie der App bei Aufforderung die Kameraberechtigungen. ARKit beginnt dann, Ebenen vor Ihrer Kamera zu erkennen.

  3. Tippen Sie auf HOST, um den Hostingmodus zu starten. Raumcode zum Freigeben gehosteter Anker generiert und auf Ihrem Bildschirm angezeigt.

  4. Tippen Sie auf ein Flugzeug, um dort einen Wolkenanker zu hosten.

    • Die App platziert ein Andy Android-Objekt auf der Ebene und fügt einen Anker hinzu.
    • Eine Hostanfrage wird an den ARCore API-Cloud-Endpunkt gesendet. Die Hostanfrage enthält Daten, die die Position des Ankers relativ zu den visuellen Elementen in seiner Nähe darstellen.
    • Sobald der Anker gehostet wurde, erhält er eine ID, die zum Auflösen von Cloud-Ankern in diesem Gruppenbereich verwendet wird.

  5. 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 Auflösungsanfrage 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 gerendert werden.

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:

  1. Fügen Sie Folgendes platform und pod hinzu: Podfile des Projekts:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.46.0'
  1. Ö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, mit der Sie die App erstellen und ausführen können.

Persistente Cloud-Markierungen

Wie unter Cloud-Anchor mit Persistenz hosten beschrieben, können Sie dem Cloudanker eine Gültigkeitsdauer von bis zu 365 Tagen geben. Beispielcode zur Verwendung persistenter Cloud-Anker ist im Verzeichnis /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample im ARCore SDK for iOS auf GitHub verfügbar.

Nächste Schritte