Konfigurieren von Azure Spatial Anchors in einem Unity-Projekt

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 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

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.

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.

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

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.

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/

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.

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)

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.

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.

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

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