Ausführen der Beispiel-App: iOS – Unity (C#)

In dieser Schnellstartanleitung erfahren Sie, wie Sie die Azure Spatial Anchors-Beispiel-App für iOS-Geräte mit Unity (C#) ausführen. Azure Spatial Anchors ist ein plattformübergreifender Entwicklerdienst, mit dem Sie Mixed Reality-Umgebungen mit Objekten erstellen können, die ihre Position im Zeitverlauf geräteübergreifend beibehalten. Nach Abschluss des Vorgangs verfügen Sie über eine mit Unity erstellte ARKit-iOS-App, mit der ein räumlicher Anker gespeichert und abgerufen werden kann.

Sie lernen Folgendes:

  • Erstellen eines Spatial Anchors-Kontos
  • Vorbereiten von Unity-Buildeinstellungen
  • Konfigurieren des Bezeichners und Kontoschlüssels für das Spatial Anchors-Konto
  • Exportieren des Xcode-Projekts
  • Bereitstellen und Ausführen auf einem iOS-Gerät

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

Voraussetzungen

Stellen Sie für diese Schnellstartanleitung sicher, dass Sie über Folgendes verfügen:

  • Ein für Entwickler geeignetes ARKit-kompatibles iOS-Gerät.
  • Ein macOS-Computer, auf dem die aktuelle Version von Xcode installiert ist.
  • Eine Unity-Installation. Unterstützte Versionen und erforderliche Funktionen finden Sie auf der Setupseite für Unity-Projekte.
  • Git-Installation über Homebrew. Geben Sie den folgenden Befehl in einer einzelnen Zeile am Terminal ein: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Führen Sie dann brew install git und brew install git-lfs aus.

Erstellen einer Spatial Anchors-Ressource

Öffnen Sie das Azure-Portal.

Wählen Sie im linken Bereich Ressource erstellen aus.

Suchen Sie über das Suchfeld nach Spatial Anchors.

Screenshot: Ergebnisse einer Suche nach Spatial Anchors

Wählen Sie Spatial Anchors und dann Erstellen aus.

Führen Sie im Bereich Spatial Anchors-Konto die folgenden Schritte aus:

  • Geben Sie einen eindeutigen Ressourcennamen in regulären alphanumerischen Zeichen ein.

  • Wählen Sie das Abonnement aus, an das die Ressource angefügt werden soll.

  • Erstellen Sie eine Ressourcengruppe durch Auswählen von Neu erstellen. Nennen Sie sie myResourceGroup, und wählen Sie OK aus.

    Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen wie Web-Apps, Datenbanken und Speicherkonten bereitgestellt und verwaltet werden. Sie können z.B. die gesamte Ressourcengruppe später in einem einfachen Schritt löschen.

  • Wählen Sie einen Standort (Region) für die Ressource aus.

  • Wählen Sie Erstellen aus, um mit der Ressourcenerstellung zu beginnen.

Screenshot: Spatial Anchors-Bereich zum Erstellen einer Ressource

Nachdem die Ressource erstellt wurde, zeigt das Azure-Portal an, dass die Bereitstellung abgeschlossen ist.

Screenshot: Abgeschlossene Ressourcenbereitstellung

Wählen Sie Zu Ressource wechseln aus. Nun können Sie die Ressourceneigenschaften anzeigen.

Kopieren Sie den Wert für Konto-ID der Ressource zur späteren Verwendung in einen Text-Editor.

Screenshot des Bereichs „Ressourceneigenschaften“

Kopieren Sie außerdem den Wert für Kontodomäne der Ressource zur späteren Verwendung in einen Text-Editor.

Screenshot: Wert für „Kontodomäne“ der Ressource

Wählen Sie unter Einstellungen die Option Zugriffsschlüssel aus. Kopieren Sie die Werte für Primärschlüssel und Kontoschlüssel zur späteren Verwendung in einen Text-Editor.

Screenshot: Bereich „Schlüssel“ für das Konto

Herunterladen eines Beispielprojekts und Importieren des SDK

Klonen des Beispielrepositorys

Klonen Sie das Beispielrepository, indem Sie die folgenden Befehle ausführen:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

Importieren des ASA SDK

Befolgen Sie diese Anweisungen, um die für die iOS-Plattform erforderlichen ASA SDK-Pakete herunterzuladen und zu importieren.

Konfigurieren von Unity

Öffnen Sie in Unity das Projekt im Ordner Unity. Unity weist Sie unter Umständen darauf hin, dass die Version im Projekt nicht mit der Version identisch ist, die Sie auf Ihrem Computer installiert haben. Diese Warnung ist in Ordnung, solange Ihre Version des Unity-Editors neuer ist als diejenige, mit der das Projekt erstellt wurde. Wenn Ihre Version neuer ist, wählen Sie Weiter aus. Wenn Ihre Version älter ist als die, die das Projekt benötigt, wählen Sie Beenden aus, und aktualisieren Sie Ihren Unity-Editor.

Screenshot des Unity-Bereichs

Wählen Sie Datei>Buildeinstellungen aus, um Buildeinstellungen zu öffnen.

Wählen Sie im Abschnitt Plattform die Option iOS aus.

Wählen Sie Plattform wechseln, um die Plattform in iOS zu ändern. Bei Bedarf werden Sie in Unity zur Installation fehlender unterstützender iOS-Komponenten aufgefordert.

Screenshot: Fenster für Unity-Buildeinstellungen

Schließen Sie das Fenster Buildeinstellungen.

Konfigurieren der Kontoinformationen

Im nächsten Schritt wird die App zur Verwendung der Kontoinformationen konfiguriert. Sie haben die Werte für Kontoschlüssel, Konto-ID und Kontodomäne zuvor im Bereich Erstellen einer Spatial Anchors-Ressource in einen Text-Editor kopiert.

Navigieren Sie im Bereich Projekt zu Assets\AzureSpatialAnchors.SDK\Resources.

Wählen Sie SpatialAnchorConfig aus. Geben Sie im Bereich PrüfungAccount Key als Wert für den Spatial Anchors-Kontoschlüssel, Account ID als Wert für die Spatial Anchors-Konto-ID und Account Domain als Wert für die Spatial Anchors-Kontodomäne ein.

Exportieren des Xcode-Projekts

Wählen Sie Datei>Buildeinstellungen aus, um Buildeinstellungen zu öffnen.

Stellen Sie unter Scenes In Build (Szenen im Build) sicher, dass sich neben allen Szenen ein Häkchen befindet.

Wählen Sie Build aus. Wählen Sie im dann geöffneten Bereich einen Ordner aus, in den das Xcode-Projekt exportiert wird.

Nach Abschluss des Exports wird ein Ordner angezeigt, der das exportierte Xcode-Projekt enthält.

Hinweis

Wenn ein Fenster mit der Auswahl zwischen „Ersetzen“ und „Anfügen“ angezeigt wird, empfiehlt es sich, Anfügen auszuwählen, da dies schneller ist. Ersetzen entfernt alle Dateien aus dem Zielordner und generiert einen neuen Inhalt.

Öffnen des Xcode-Projekts

Nun können Sie Ihr Projekt Unity-iPhone.xcodeproj in Xcode öffnen.

Sie können entweder Xcode starten und das exportierte Unity-iPhone.xcodeproj-Projekt öffnen oder das Projekt in Xcode starten, indem Sie den folgenden Befehl an dem Ort ausführen, an dem Sie das Projekt exportiert haben:

open ./Unity-iPhone.xcodeproj

Wählen Sie den Hauptknoten Unity-iPhone aus, um die Projekteinstellungen anzuzeigen, und wählen Sie dann die Registerkarte General (Allgemein) aus.

Stellen Sie unter Deployment Info (Bereitstellungsinformationen) sicher, dass das Bereitstellungsziel auf iOS 11.0 festgelegt ist.

Wählen Sie die Registerkarte Signing & Capabilities (Signieren und Funktionen) aus, und stellen Sie sicher, dass die Option Automatically manage signing (Signierung automatisch verwalten) aktiviert ist. Wenn dies nicht der Fall ist, aktivieren Sie diese Option, und setzen Sie dann die Buildeinstellungen zurück, indem Sie im angezeigten Bereich die Option Enable Automatic (Automatik aktivieren) auswählen.

Bereitstellen der App auf Ihrem iOS-Gerät

Verbinden Sie das iOS-Gerät mit dem Mac, und legen Sie das aktive Schema auf Ihr iOS-Gerät fest.

Screenshot: Schaltfläche „My iPhone“ (Mein iPhone) zum Auswählen des Geräts

Wählen Sie Build and then run the current scheme (Aktuelles Schema erstellen und dann ausführen) aus.

Screenshot der Pfeilschaltfläche zum Bereitstellen und Ausführen

Wählen Sie in der App mithilfe der Pfeile BasicDemo aus, und klicken Sie dann auf die Schaltfläche Los, um die Demo zu starten. Befolgen Sie die Anleitung zum Anordnen und Abrufen eines Ankers.

Screenshot 1Screenshot 2Screenshot 3

Wenn Sie fertig sind, beenden Sie die App, indem Sie in Xcode Beenden wählen.

Problembehandlung

Probleme beim Rendern

Falls beim Ausführen der App die Kamera nicht als Hintergrund angezeigt wird (sondern stattdessen beispielsweise ein leerer blauer Bereich oder andere Texturen), müssen Sie die Ressourcen wahrscheinlich erneut in Unity importieren. Beenden Sie die App. Wählen Sie in Unity im Menü am oberen Rand die Option Assets > Re-import all (Ressourcen > Alle erneut importieren) aus. Führen Sie die App dann erneut aus.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.

Wählen Sie im Azure-Portalmenü oder auf der Startseite die Option Ressourcengruppen aus. Wählen Sie auf der Seite Ressourcengruppen die Option myResourceGroup aus.

Stellen Sie auf der Seite myResourceGroup sicher, dass die Ressourcen aufgelistet sind, die Sie löschen möchten.

Wählen Sie die Option Löschen aus, geben Sie zur Bestätigung im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.

Nächste Schritte

In diesem Schnellstart haben Sie ein Spatial Anchors-Konto erstellt. Dann haben Sie eine App zum Speichern und Abrufen von Spatial Anchors konfiguriert und bereitgestellt. Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie die App verbessert wird, damit Spatial Anchors für andere Geräte freigegeben werden können.