5. Ancoraggi nello spazio di Azure per Android e iOS5. Azure Spatial Anchors for Android and iOS

Questa esercitazione illustra come compilare il progetto nei dispositivi Android e iOS usando AR Foundation, ARCore XR Plugin e ARKit XR Plugin.In this tutorial, you will learn how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.

ObiettiviObjectives

  • Imparare a compilare il progetto in un dispositivo Android usando Unity AR Foundation e ARCore XR PluginLearn how to build your project to your Android device using Unity's AR Foundation and ARCore XR Plugin
  • Imparare a compilare il progetto in un dispositivo iOS usando Unity AR Foundation e ARKit XR PluginLearn how to build your project to your iOS device using Unity's AR Foundation and ARKit XR Plugin

Installazione di pacchetti di Unity incorporatiInstalling inbuilt Unity packages

In questa sezione verrà eseguito l'aggiornamento e l'installazione dei seguenti pacchetti incorporati:In this section, you will upgrade and install the following inbuilt packages:

  • AR Foundation 3.1.3AR Foundation 3.1.3
  • Helper di input legacy XR 2.1.6XR Legacy Input Helpers 2.1.6
  • ARCore XR Plugin 3.1.3 per il supporto AndroidARCore XR Plugin 3.1.3 for Android support
  • ARKit XR plugin 3.1.3 per il supporto iOSARKit XR plugin 3.1.3 for iOS support

Attenzione

Non tutte le versioni sono compatibili con MRTK e solo alcune versioni interagiscono tra loro, quindi è importante assicurarsi di installare le versioni esatte elencate sopra.Not all version are compatible with MRTK and only certain version works together, so make sure you install the exact versions listed above.

Scegliere Window (Finestra) > Package Manager (Gestione pacchetti) dal menu Unity per aprire la finestra Package Manager(Gestione pacchetti), quindi selezionare AR Foundation > 3.1.3 e fare clic sul pulsante Update to 3.1.3 (Aggiorna a 3.1.3) per aggiornare il pacchetto:In the Unity menu, select Window > Package Manager to open the Package Manager window, then select AR Foundation > 3.1.3 and click the Update to 3.1.3 button to update the package:

Package Manager di Unity con AR Foundation selezionato

Seguire lo stesso processo per importare i pacchetti rimanenti, in base alle esigenze.Follow the same process to import the remaining packages as needed.

Nota

Se sviluppi il progetto per Android, non è necessario installare il pacchetto ARKit XR Plugin.If you are developing this project for Android, there is no need to install the ARKit XR Plugin package. Analogamente, se sviluppi il progetto per iOS, non è necessario installare ARCore XR Plugin.Similarly, if you are developing this project for iOS, you do not need to install the ARCore XR Plugin.

Configurare MRTK per AR Foundation CameraConfigure MRTK for AR Foundation Camera

In questa sezione verrà illustrato come configurare MRTK per la distribuzione in un dispositivo mobile.In this section, you will learn how to configure MRTK for deploying to a mobile device.

Nella finestra Hierarchy (Gerarchia) selezionare l'oggetto MixedRealityToolkit.In the Hierarchy window, select the MixedRealityToolkit object. Quindi, nella finestra Inspector (Controllo) selezionare la scheda Camera (Fotocamera), clonare i profilo della fotocamera e assegnare un nome adatto, ad esempio AzureSpatialAnchors_ARCameraProfile:Then in the Inspector window, select the Camera tab, clone the camera profile, and give it a suitable name, for example, AzureSpatialAnchors_ARCameraProfile:

Unity con il profilo ARCameraProfile appena creato selezionato

Suggerimento

Per rivedere la procedura di clonazione dei profili MRTK, fare riferimento alle istruzioni contenute in Configurazione dei profili di Mixed Reality Toolkit.For a reminder on how to clone MRTK profiles, you can refer to the Configuring the Mixed Reality Toolkit profiles instructions.

Con la scheda Camera (Fotocamera) ancora selezionata nella finestra Inspector (Controllo), espandere Camera Setting Providers (Provider impostazioni fotocamera) e fare clic sul pulsante + Add Camera Setting Provider (+ Aggiungi provider impostazioni fotocamera), quindi espandere New data provider 1 (Nuovo provider di dati 1):With the Camera tab still selected in the Inspector window, expand the Camera Setting Providers and click the + Add Camera Setting Provider button, then expand the newly added New data provider 1:

Profilo ARCameraProfile di Unity con il nuovo provider di dati aggiunto

Usando l'elenco a discesa Type (Tipo), cambiare il tipo in Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:Using the Type dropdown, change the type to Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:

Profilo ARCameraProfile di Unity con il percorso di selezione del tipo di provider di dati

Con l'oggetto MixedRealityToolkit ancora selezionato nella finestra Hierarchy (Gerarchia), usare il pulsante Add Component (Aggiungi componente) nella finestra Inspector (Controllo) per aggiungere i componenti seguenti:With the MixedRealityToolkit object still selected in the Hierarchy window, use the Add Component button in the Inspector window to add the following components:

  • AR Anchor Manager (Script)AR Anchor Manager (Script)
  • DisableDiagnosticsSystem (Script)DisableDiagnosticsSystem (Script)

Oggetto MixedRealityToolkit di Unity con i componenti AR Anchor Manager e DisableDiagnosticsSystem aggiuntiUnity MixedRealityToolkit object with AR Anchor Manager and DisableDiagnosticsSystem components added

Nota

Quando si aggiunge il componente AR Reference Point Manager (Script), viene aggiunto automaticamente il componente AR Session Origin (Script) perché è richiesto dal componente AR Reference Point Manager (Script).When you add the AR Reference Point Manager (Script) component, the AR Session Origin (Script) component is automatically added because it is required by the AR Reference Point Manager (Script) component.

Aggiornare lo script di MRTK Unity per le definizioni richiamando la voce di menu: mixed reality Toolkit > Utilities > Unity > Update scripting definisceUpdate the MRTK UnityAR scripting defines by invoking the menu item: Mixed Reality Toolkit > Utilities > UnityAR > Update Scripting Defines

Compilazione dell'applicazione in un dispositivo AndroidBuilding your application to your Android device

In questa sezione verrà illustrato come configurare il progetto per la compilazione e la distribuzione in un dispositivo Android.In this section, you will learn how to configure your project to build and deploy it to an Android device.

Dal menu di Unity scegli File > Build Settings (Impostazioni di compilazione) per visualizzare la finestra corrispondente, quindi impostare la piattaforma su Android:In the Unity menu, select File > Build Settings... to open the Build Settings window and then switch the platform to Android:

Finestra Build Settings di Unity con la piattaforma Android selezionata

Suggerimento

Per rivedere la procedura per cambiare piattaforma di compilazione, fare riferimento alle istruzioni contenute in Passaggio a un'altra piattaforma di compilazione.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

Chiudere la finestra Build Settings (Impostazioni di compilazione).Close the Build Settings window.

Nel menu di Unity selezionare Mixed Reality Toolkit > Utilities > Configure Unity Project (Mixed Reality Toolkit > Utilità > Configura progetto Unity) per aprire la finestra MRTK Project Configurator (Configuratore progetto MRTK), verificare che tutte le opzioni siano selezionate, quindi fare clic sul pulsante Apply (Applica) per applicare le impostazioni:In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

Finestra MRTK Project Configurator di Unity - Android

Dal menu Unity scegliere Edit > Project Settings... (Modifica > Impostazioni del progetto) per aprire la finestra Player Settings (Impostazioni lettore) e quindi individuare la sezione Player > Other Settings (Lettore > Altre impostazioni), selezionare Vulkan e rimuoverlo facendo clic sul simbolo "-" :In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, select Vulkan and remove it by clicking the "-" symbol:

Area Other Settings di Unity con Vulkan selezionato

Nel menu Unity selezionare modifica > Impostazioni progetto... > Lettore > di Impostazione di XR, assicurarsi di trovarsi nella piattaforma Android e selezionare la casella di controllo Virtual Reality supported , quindi fare clic sull'icona + e selezionare None:In the Unity menu, select Edit > Project Settings... >Player> XR Setting, make sure you are in Android platform and check the Virtual Reality Supported checkbox then click the + icon, and select None:

Finestra MRTK Project Configurator di Unity - Android

Chiudere la finestra Player Settings (Impostazioni giocatore) e aprire di nuovo la finestra Build Settings (Impostazioni di compilazione).Close the Player Settings window and open the Build Settings window again.

Nella finestra Build Settings (Impostazioni di compilazione) fare clic sul pulsante Add Open Scenes (Aggiungi scene aperte) per aggiungere la scena corrente all'elenco Scenes In Build (Scene nella compilazione).In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list. Quindi, usare un cavo USB, connettere il dispositivo Android al computer e selezionarlo nell'elenco a discesa Run Device (Esegui dispositivo):Then, use a USB cable, connect your Android device to your computer and select it from the Run Device dropdown:

Finestra Build Settings di Unity con la scena aggiunta e Run Device selezionato

Nota

Se il dispositivo non è presente nell'elenco a discesa Run Device (Esegui dispositivo), potrebbe essere necessario premere il pulsante Refresh (Aggiorna) accanto all'elenco a discesa.If your device does not appear in the Run Device dropdown, you might need to press the Refresh button next to the dropdown.

Nella finestra delle impostazioni di compilazione fare clic sul pulsante Build And Run (Compila ed esegui) per aprire la finestra Build Android (Compila in Android).In the Build Settings window, click the Build And Run button to open the Build Android window.

Scegliere il percorso in cui archiviare la build, ad esempio D:\MixedRealityLearning\Builds, quindi assegnare un nome adeguato all'apk, ad esempio MRTKTutorials-AzureSpatialAnchors, e fare clic sul pulsante Save (Salva) per avviare il processo di compilazione:Choose a suitable location to store your build, for example, D:\MixedRealityLearning\Builds, then give the apk a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and click the Save button to start the build process:

Finestra Build Settings di Unity con la finestra del prompt di salvataggio - Android

Nota

Se nella finestra della console Unity viene visualizzato un errore relativo ai moduli Android SDK, NDK o JDK, è necessario aprire Unity Hub e installare i moduli Android Build Support associati.If you get any error in the Unity Console window related to Android SDK, NDK, or JDK modules, you need to open Unity Hub and install the associated Android Build Support modules.

Al termine del processo di compilazione, le app dovrebbero essere caricate automaticamente nel dispositivo Android.When the build process is complete, your apps should automatically load on your Android device.

Compilazione dell'applicazione in un dispositivo iOSBuilding your application to your iOS device

In questa sezione verrà illustrato come configurare il progetto per la compilazione e la distribuzione in un dispositivo iOS.In this section, you will learn how to configure your project, to build and deploy it to your iOS device.

Dal menu di Unity scegli File > Build Settings (Impostazioni di compilazione) per visualizzare la finestra corrispondente e impostare la piattaforma su iOS:In the Unity menu, select File > Build Settings... to open the Build Settings window and switch platform to iOS:

Finestra Build Settings di Unity con la piattaforma iOS selezionata

Suggerimento

Per rivedere la procedura per cambiare piattaforma di compilazione, fare riferimento alle istruzioni contenute in Passaggio a un'altra piattaforma di compilazione.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

Chiudere la finestra Build Settings (Impostazioni di compilazione).Close the Build Settings window.

Nel menu di Unity selezionare Mixed Reality Toolkit > Utilities > Configure Unity Project (Mixed Reality Toolkit > Utilità > Configura progetto Unity) per aprire la finestra MRTK Project Configurator (Configuratore progetto MRTK), verificare che tutte le opzioni siano selezionate, quindi fare clic sul pulsante Apply (Applica) per applicare le impostazioni:In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

Finestra MRTK Project Configurator di Unity - iOS

Dal menu Unity scegliere Edit > Project Settings... (Modifica > Impostazioni del progetto) per aprire la finestra Player Settings (Impostazioni lettore) e quindi individuare la sezione Player > Other Settings (Lettore > Altre impostazioni), deselezionare la casella di controllo Strip Engine Code (Rimuovi codice motore) per disabilitarla:In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, uncheck the Strip Engine Code checkbox to disable it:

Area Other Settings di Unity con l'opzione Strip Engine Code disabilitata

Chiudere la finestra Player Settings (Impostazioni lettore) e aprire di nuovo la finestra Build Settings (Impostazioni di compilazione).Close the Player Settings window and open the Build Settings window again.

Nella finestra Build Settings (Impostazioni di compilazione) fare clic sul pulsante Add Open Scenes (Aggiungi scene aperte) per aggiungere la scena corrente all'elenco Scenes In Build (Scene nella compilazione):In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list:

Finestra Build Settings di Unity con la scena aggiunta

Nella finestra delle impostazioni di compilazione fare clic sul pulsante Build (Compila) per aprire la finestra Build iOS (Compila in iOS).In the Build Settings window, click the Build button to open the Build iOS window.

Scegliere un percorso appropriato in cui archiviare il progetto Xcode, ad esempio D:\MixedRealityLearning\Builds, creare una nuova cartella e assegnarle un nome adatto, ad esempio, MRTKTutorials-AzureSpatialAnchors, e quindi fare clic sul pulsante Select Folder (Seleziona cartella) per avviare il processo di compilazione:Choose a suitable location to store your Xcode project, for example, D:\MixedRealityLearning\Builds, create a new folder and give it a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and then click the Select Folder button to start the build process:

Finestra Build Settings di Unity con la finestra del prompt di salvataggio - iOS

Al termine del processo di compilazione, seguire le istruzioni in Esportare il progetto Xcode per informazioni su come distribuire il progetto Xcode in un dispositivo iOS.When the build process is complete, follow the Export the Xcode project instructions to learn to deploy your Xcode project to your iOS device.

Lezione completataCongratulations

In questa esercitazione è stato descritto come compilare il progetto nei dispositivi Android e iOS usando AR Foundation, ARCore XR Plugin e ARKit XR Plugin.In this tutorial, you learned how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.