Configurazione di Ancoraggi nello spazio di Azure in un progetto Unity

Il framework plug-in XR è supportato solo in ASA SDK versione 2.9.0 o successiva. Per usare il framework plug-in XR, usare Unity 2020.3 (LTS) e AR Foundation 4.1.7 con i pacchetti seguenti, a seconda della piattaforma:

• plug-in OpenXR Realtà mista: 1.1.2
• Plug-in Windows XR: 4.5.0
• Plug-in ARCore XR: 4.1.7
• Plug-in ARKit XR: 4.1.7

XR predefinito legacy è supportato solo in ASA SDK versione 2.8.1 o precedente. Per usare XR predefinito legacy, usare Unity 2019.4 (LTS) e AR Foundation 3.1.3 con i pacchetti seguenti, a seconda della piattaforma:

• Windows Realtà mista: 4.2.1
• Plug-in ARCore XR: 3.1.3
• Plug-in ARKit XR: 3.1.3

Il supporto per Unity 2020 è stato aggiunto con ASA SDK 2.9.0. È consigliabile usare la versione più recente di ASA SDK per lo sviluppo di Unity 2020.

La versione minima supportata in Unity 2019 è ASA SDK 2.7.0. La versione più recente che fornisce supporto per Unity 2019 è ASA SDK 2.8.1.

Continuare con il passaggio successivo. In un passaggio successivo si userà lo strumento Realtà mista funzionalità.

Individuare il pacchetto principale di Ancoraggi nello spazio di Azure (com.microsoft.azure.spatial-anchors-sdk.core) per Unity qui. Selezionare la versione desiderata e scaricare il pacchetto usando il pulsante Scarica. Ripetere questo passaggio per scaricare il pacchetto per ogni piattaforma che si prevede di supportare.

I passaggi seguenti presuppongono che NPM sia installato e disponibile.

Eseguire il comando seguente sostituendo <version_number> con la versione di Ancoraggi nello spazio di Azure da scaricare nella cartella corrente:

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

Il pacchetto principale di Ancoraggi nello spazio di Azure verrà scaricato nella cartella in cui è stato eseguito il comando. Ripetere questo passaggio per scaricare il pacchetto per ogni piattaforma che si prevede di supportare.

Questo passaggio richiede che lo strumento per la funzionalità di realtà mista sia scaricato e disponibile.

1. Seguire la documentazione dello Strumento per la funzionalità di realtà mista per configurare lo strumento e imparare a usarlo.
2. Installare
   1. Azure Spatial Anchors SDK Core
   2. Azure Spatial Anchors SDK per <le piattaforme>
   3. Realtà mista plug-in OpenXR se si usa OpenXR , disponibile in Supporto della piattaforma

Seguire le istruzioni riportate qui per importare i pacchetti di Ancoraggi nello spazio di Azure scaricati nel progetto Unity usando il Gestione pacchetti Unity.

Seguire le istruzioni riportate qui per importare i pacchetti di Ancoraggi nello spazio di Azure scaricati nel progetto Unity usando il Gestione pacchetti Unity.

Configurare le impostazioni XR del progetto Unity

Quando si sviluppano app MixedReality in HoloLens, è necessario impostare la configurazione XR in Unity. Per altre informazioni, vedere Configurazione della configurazione XR - Realtà mista | Microsoft Docs e Scelta di una versione di Unity e di un plug-in XR - Realtà mista | Microsoft Docs.

Azure Spatial Anchors SDK versioni 2.9.0 o precedenti forniscono solo il supporto per il plug-in Windows XR (com.unity.xr.windowsmr), quindi il pacchetto di windows Ancoraggi nello spazio di Azure ha una dipendenza esplicita dal plug-in Windows XR.

Azure Spatial Anchors SDK versioni 2.10.0 o successive forniscono il supporto sia per il plug-in OpenXR Realtà mista (com.microsoft.mixedreality.openxr) che per il plug-in com.unity.xr.windowsmrWindows XR. È necessario includere il com.microsoft.mixedreality.openxr pacchetto o il com.unity.xr.windowsmr pacchetto nel progetto a seconda della scelta.

Configurare le funzionalità del progetto Unity

Assicurarsi di abilitare le funzionalità seguenti nel progetto Unity:

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Configurare il file mainTemplate.gradle

1. Andare a Modifica>Impostazioni progetto>Lettore.

2. Nel Pannello di controllo per Player Impostazioni selezionare l'icona Android.

3. Nella sezione Compilazione selezionare la casella di controllo Custom Main Gradle Template (Modello gradle principale personalizzato) per generare un modello gradle personalizzato in Assets\Plugins\Android\mainTemplate.gradle.

4. Apri il file mainTemplate.gradle in un editor di testo.

5. dependencies Nella sezione incollare le dipendenze seguenti:

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

Al termine, la dependencies sezione dovrebbe avere un aspetto simile al seguente:

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

Passaggi successivi