Konfigurieren von Azure Spatial Anchors in einem Unity-Projekt

In diesem Leitfaden lernen Sie die ersten Schritte mit dem Azure Spatial Anchors SDK in Ihrem Unity-Projekt kennen.

Anforderungen des Projekts

Wenn Sie ein neues Unity-Projekt starten, können Sie zwischen dem Unity XR-Plug-In-Framework und Legacy Built-in XR wählen.

XR-Plug-In-Framework

Das XR Plug-In-Framework wird nur ab der ASA SDK-Version 2.9.0 unterstützt. Verwenden Sie für das XR-Plug-In-Framework abhängig von Ihrer Plattform Unity 2020.3 (LTS) und AR Foundation 4.1.7 mit den folgenden Paketen:

• Mixed Reality OpenXR-Plug-In: 1.1.2
• Windows XR-Plug-In: 4.5.0
• ARCore XR-Plug-In: 4.1.7
• ARKit XR-Plug-In: 4.1.7

Legacy Built-in XR

Legacy Built-in XR wird nur bis zur ASA SDK-Version 2.8.1 unterstützt. Verwenden Sie für Legacy Built-in XR abhängig von Ihrer Plattform Unity 2019.4 (LTS) und AR Foundation 3.1.3 mit den folgenden Paketen:

• Windows Mixed Reality: 4.2.1
• ARCore XR-Plug-In: 3.1.3
• ARKit XR-Plug-In: 3.1.3

Konfigurieren eines Projekts

Bevor Sie das Azure Spatial Anchors SDK in Ihr Unity-Projekt einschließen, stellen Sie sicher, dass Sie die erforderlichen Pakete über den Unity Package Manager installieren.

Auswählen der ASA-Version

Um zu bestimmen, welche ASA SDK-Version in Ihrem Unity-Projekt verwendet werden soll, wählen Sie unten Ihre Unity-Version aus.

Unity 2020

Unterstützung für Unity 2020 wurde mit ASA SDK 2.9.0 hinzugefügt. Wir empfehlen die Verwendung des neuesten ASA SDK für die Unity 2020-Entwicklung.

Wichtig

Bei Verwendung des Mixed Reality OpenXR-Plug-Ins ist ASA SDK 2.10.0 die unterstützte Mindestversion. Bei Verwendung von Windows XR 4.5.1 oder höher ist ASA SDK 2.11.0 die unterstützte Mindestversion.

Unity 2019

Die unterstützte Mindestversion in Unity 2019 ist ASA SDK 2.7.0. Die neueste Version, die Unterstützung für Unity 2019 bietet, ist ASA SDK 2.8.1.

Herunterladen von ASA-Paketen

Im nächsten Schritt werden die Azure Spatial Anchors-Pakete für Unity heruntergeladen.

Damit Sie Azure Spatial Anchors in Unity verwenden können, müssen Sie sowohl das Hauptpaket (com.microsoft.azure.spatial-anchors-sdk.core) als auch ein plattformspezifisches Paket für alle Plattformen herunterladen, die unterstützt werden sollen.

Plattform	Namen der erforderlichen Pakete
HoloLens	com.microsoft.azure.spatial-anchors-sdk.core@<version_number> com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android	com.microsoft.azure.spatial-anchors-sdk.core@<version_number> com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS	com.microsoft.azure.spatial-anchors-sdk.core@<version_number> com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

Mixed Reality-Featuretool

Hinweis

Das Mixed Reality-Featuretool unterstützt aktuell nur Windows.

Fahren Sie mit dem nächsten Schritt fort. Das Mixed Reality-Featuretool verwenden Sie in einem späteren Schritt.

Download im Web

Suchen Sie hier nach dem Azure Spatial Anchors-Hauptpaket (com.microsoft.azure.spatial-anchors-sdk.core) für Unity. Wählen Sie die gewünschte Version aus, und laden Sie das Paket über die Schaltfläche Download herunter. Wiederholen Sie diesen Schritt, um das Paket für jede Plattform herunterzuladen, die Sie unterstützen möchten.

Download mit npm

Bei den folgenden Schritten wird davon ausgegangen, dass NPM installiert und verfügbar ist.

Führen Sie den folgenden Befehl aus. Ersetzen Sie dabei <version_number> durch die Version der Azure Spatial Anchors-Instanz, die Sie in den aktuellen Ordner herunterladen möchten:

npm pack com.microsoft.azure.spatial-anchors-sdk.core@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

Hinweis

Führen Sie zum Auflisten der verfügbaren Versionen des Azure Spatial Anchors-Pakets den folgenden Befehl aus:

npm view com.microsoft.azure.spatial-anchors-sdk.core --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

Das Azure Spatial Anchors-Hauptpaket wird in den Ordner heruntergeladen, in dem Sie den Befehl ausgeführt haben. Wiederholen Sie diesen Schritt, um das Paket für jede Plattform herunterzuladen, die Sie unterstützen möchten.

Importieren von ASA-Paketen

Mixed Reality-Featuretool

Für diesen Schritt ist erforderlich, dass das Mixed Reality-Featuretool heruntergeladen und verfügbar ist.

1. In der Dokumentation zum Mixed Reality-Featuretool erfahren Sie, wie Sie das Tool einrichten und verwenden.
2. Installieren von
   1. Azure Spatial Anchors SDK Core
   2. Azure Spatial Anchors SDK für <Ihre Plattform(en)>
   3. Mixed Reality OpenXR Plug, wenn OpenXR verwendet wird (zu finden unter Plattformunterstützung)

Download im Web

Befolgen Sie diese Anweisungen, um mithilfe von Unity Package Manager die Azure Spatial Anchors-Pakete zu importieren, die Sie in das Unity-Projekt heruntergeladen haben.

Download mit npm

Befolgen Sie diese Anweisungen, um mithilfe von Unity Package Manager die Azure Spatial Anchors-Pakete zu importieren, die Sie in das Unity-Projekt heruntergeladen haben.

Zusätzliche Konfigurationen

Wenn Sie für HoloLens oder Android entwickeln, führen Sie die folgenden zusätzlichen Setupschritte aus:

HoloLens

Konfigurieren Sie die Einstellungen Ihres Unity-Projekts XR

Bei der Entwicklung von MixedReality-Apps auf HoloLens müssen Sie die XR-Konfiguration in Unity einrichten. Weitere Informationen dazu finden Sie hier: Einrichten Ihrer XR-Konfiguration – Mixed Reality | Microsoft-Dokumentation und Auswählen einer Unity-Version und eines XR-Plugins – Mixed Reality | Microsoft-Dokumentation.

Azure Spatial Anchors SDK-Versionen 2.9.0 oder niedriger bieten nur Unterstützung für das Windows XR-Plug-In (com.unity.xr.windowsmr), weshalb das Azure Spatial Anchors Windows-Paket eine explizite Abhängigkeit vom Windows XR-Plug-In aufweist.

Azure Spatial Anchors SDK-Versionen 2.10.0 oder höher bieten Unterstützung sowohl für das Mixed Reality OpenXR-Plug-In (com.microsoft.mixedreality.openxr) als auch für das Windows XR-Plug-In com.unity.xr.windowsmr. Sie müssen je nach Ihrer Auswahl entweder das Paket com.microsoft.mixedreality.openxr oder das Paket com.unity.xr.windowsmr in Ihr Projekt einschließen.

Konfigurieren Sie die Fähigkeiten Ihres Unity-Projekts

Stellen Sie sicher, dass Sie die folgenden Funktionen in Ihrem Unity-Projekt aktivieren:

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Warnung

Wenn die PrivateNetworkClientServer-Fähigkeit nicht aktiviert ist, kann es zu einem Fehler bei der Abfrage von Ankern kommen, wenn das Gerät ein Netz verwendet, das als privat konfiguriert ist.

Android

Konfigurieren der Datei „maintemplate. gradle“

1. Wechseln Sie zu Bearbeiten>Projekteinstellungen>Player.

2. Wählen Sie im Inspector-Bereich für Playereinstellungen das Android-Symbol aus.

3. Aktivieren Sie unter dem Abschnitt Erstellen das Kontrollkästchen Custom Main Gradle Template (Benutzerdefinierte Gradle-Hauptvorlage), um eine benutzerdefinierte Gradle-Vorlage unter Assets\Plugins\Android\mainTemplate.gradle zu erstellen.

4. Öffne in einem Text-Editor die Datei mainTemplate.gradle.

5. Fügen Sie im Abschnitt dependencies die folgenden Abhängigkeiten ein:

   implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
   implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
   

Wenn alles fertig ist, sollte Ihr dependencies-Abschnitt ungefähr wie folgt aussehen:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
    implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
**DEPS**}

Nächste Schritte

Gewusst wie: Erstellen und Suchen von Ankern in Unity