Configurazione di Ancoraggi nello spazio di Azure in un progetto Unity

Questa guida illustra come iniziare a usare Azure Spatial Anchors SDK nel progetto Unity.

Requisiti del progetto

Quando si avvia un nuovo progetto Unity, è possibile scegliere tra Il framework di plug-in Unity XR e XR predefinito legacy.

XR Plug-in Framework

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

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

Configurazione di un progetto

Prima di includere Azure Spatial Anchors SDK nel progetto Unity, assicurarsi di installare i pacchetti necessari tramite il Gestione pacchetti Unity.

Scegliere la versione asa

Per determinare quale versione di ASA SDK usare nel progetto Unity, selezionare la versione di Unity seguente.

Unity 2020

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.

Importante

Se si usa il plug-in OpenXR Realtà mista, ASA SDK 2.10.0 è la versione minima supportata. Se si usa Windows XR 4.5.1 o versione successiva, ASA SDK 2.11.0 è la versione minima supportata.

Unity 2019

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.

Scaricare i pacchetti ASA

Il passaggio successivo consiste nel scaricare i pacchetti di Ancoraggi nello spazio di Azure per Unity.

Per usare Ancoraggi nello spazio di Azure in Unity, è necessario scaricare sia il pacchetto principale (com.microsoft.azure.spatial-anchors-sdk.core) che un pacchetto specifico della piattaforma per ogni piattaforma che si prevede di supportare.

Piattaforma	Nomi dei pacchetti obbligatori
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>

Strumento per la funzionalità di realtà mista

Nota

Lo strumento per la funzionalità di realtà mista supporta attualmente solo Windows.

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

Download Web

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.

Download NPM

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/

Nota

Per elencare le versioni disponibili del pacchetto Ancoraggi nello spazio di Azure, eseguire le operazioni seguenti:

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.

Importare pacchetti ASA

Strumento per la funzionalità di realtà mista

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

Download Web

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

Download NPM

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

Configurazioni aggiuntive

Se si sta sviluppando per HoloLens o Android, seguire la procedura di configurazione aggiuntiva seguente

HoloLens

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

Avviso

Se non si abilita la funzionalità PrivateNetworkClientServer, potrebbe verificarsi un errore durante l'esecuzione di query sugli ancoraggi quando il dispositivo usa una rete configurata per essere privata.

Android

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

Procedura: Creare e individuare ancoraggi in Unity