Guida introduttiva: Creare un'app HoloLens con Ancoraggi oggetti di Azure in Unity

In questa guida introduttiva si creerà un'app HoloLens unity che usa Ancoraggi oggetti di Azure. Ancoraggi oggetti di Azure è un servizio cloud gestito che converte gli asset 3D in modelli di intelligenza artificiale che consentono esperienze di realtà mista con riconoscimento degli oggetti per HoloLens. Al termine, si avrà un'app HoloLens compilata con Unity in grado di rilevare gli oggetti nel mondo fisico.

Nello specifico:

• Preparare le impostazioni di compilazione di Unity.
• Esportare il progetto Visual Studio HoloLens.
• Distribuire l'app ed eseguirla in un dispositivo HoloLens 2.

Prerequisiti

Per completare questa guida introduttiva, accertarsi di disporre di quanto segue:

• Un oggetto fisico nell'ambiente e il relativo modello 3D (CAD o digitalizzato).
• Un computer Windows con installato quanto segue:
  • Git per Windows
  • Visual Studio 2019 con il carico di lavoro di sviluppo piattaforma UWP (Universal Windows Platform) e il componente Windows 10 SDK (10.0.18362.0 o versione successiva)
  • Unity 2019.4
• Un dispositivo HoloLens 2 aggiornato e in cui è abilitata la modalità sviluppatore.
  • Per aggiornare alla versione più recente per HoloLens, aprire l'app Impostazioni, scegliere Aggiornamento e sicurezza, quindi selezionare Verifica disponibilità aggiornamenti.

Creare un account di ancoraggi di oggetti

Prima di tutto, è necessario creare un account con il servizio Ancoraggi oggetti.

1. Passare al portale di Azure e selezionare Crea una risorsa.

   

2. Cercare la risorsa Ancoraggi oggetto .

   Cercare "Ancoraggi oggetto".

   

   Nella risorsa Ancoraggi oggetti nei risultati della ricerca selezionare Crea -> Ancoraggi oggetto.

   

3. Nella finestra di dialogo Account di Ancoraggi di oggetti:

   • Immettere un nome di risorsa univoco.
   • Selezionare la sottoscrizione a cui collegare la risorsa.
   • Creare o usare un gruppo di risorse esistente.
   • Selezionare l'area in cui si vuole collocare la risorsa.

   

   Selezionare Crea per iniziare a creare la risorsa.

4. Creata la risorsa, selezionare Vai alla risorsa.

   

5. Nella pagina di panoramica:

   Prendere nota del dominio account. in quanto sarà necessario più avanti.

   

   Prendere nota dell'ID account. in quanto sarà necessario più avanti.

   

   Passare alla pagina Chiavi di accesso e prendere nota della chiave primaria. in quanto sarà necessario più avanti.

   

Configurare il dispositivo

Per distribuire le app in HoloLens, è necessario associare HoloLens al computer.

1. In HoloLens passare a Impostazioni -> Aggiornamento e sicurezza -> Per sviluppatori.
2. Fare clic su Associa e lasciare aperta la schermata fino a quando non si immette il PIN in Visual Studio durante la prima distribuzione.

Caricare il modello

Prima di eseguire l'app, è necessario rendere i modelli disponibili per l'app. Se non si ha già un modello di Ancoraggi oggetti, seguire le istruzioni in Creare un modello per crearne uno. Poi, torna qui.

Con holoLens acceso e connesso al dispositivo di sviluppo (PC), seguire questa procedura per caricare un modello nella cartella 3D Objects in HoloLens:

1. Selezionare e copiare i modelli da usare premendo CTRL e C insieme (CTRL+C).

2. Premere tasto Logo Windows e E insieme (Win + E) per avviare Esplora file. Nel riquadro sinistro dovrebbe essere elencato HoloLens con altre unità e cartelle.

   

3. Toccare il collegamento HoloLens per visualizzare lo spazio di archiviazione nel dispositivo HoloLens nel riquadro destro.

   

4. In Esplora file passare a Interno Archiviazione > oggetti 3D. È ora possibile incollare i modelli nella cartella 3D Objects premendo CTRL e V insieme (CTRL+V).

   

Aprire il progetto di esempio

Per clonare il repository di esempi, eseguire questo comando:

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

Il passaggio successivo consiste nel scaricare il pacchetto Ancoraggi oggetti di Azure per Unity.

Download Web

Individuare il pacchetto Ancoraggi di oggetti di Azure per Unity (com.microsoft.azure.object-anchors.runtime) qui. Selezionare la versione desiderata e scaricare il pacchetto usando il pulsante Scarica.

Download NPM

Questo passaggio richiede che NPM sia installato e disponibile.

Eseguire il comando seguente sostituendo <version_number> con la versione di Ancoraggi di oggetti di Azure da scaricare:

npm pack com.microsoft.azure.object-anchors.runtime@<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 di oggetti di Azure, eseguire quanto segue:

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

Il pacchetto Ancoraggi di oggetti di Azure verrà scaricato nella cartella in cui è stato eseguito il comando.

Strumento per la funzionalità di realtà mista (beta)

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

In Unity aprire il quickstarts/apps/unity/basic progetto.

Download Web

Seguire le istruzioni riportate qui per importare il pacchetto Ancoraggi oggetti di Azure scaricato nel progetto Unity usando il Gestione pacchetti Unity.

Download NPM

Seguire le istruzioni riportate qui per importare il pacchetto Ancoraggi oggetti di Azure scaricato nel progetto Unity usando il Gestione pacchetti Unity.

Strumento per la funzionalità di realtà mista (beta)

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

Nota

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

1. Seguire la documentazione dello Strumento per la funzionalità di realtà mista per configurare lo strumento e imparare a usarlo.
2. Installare il pacchetto di funzionalità "Ancoraggi oggetti di Microsoft Azure" nella cartella del progetto Unity.

Configurare le informazioni sull'account

Il passaggio successivo consiste nel configurare l'app per l'uso delle informazioni sull'account. Sono stati presi nota dei valori chiave dell'account, ID account e dominio account nella sezione "Creare un account di ancoraggi di oggetti".

Nel riquadro Progetto passare a Assets\AzureObjectAnchors.SDK\Resources.

Selezionare ObjectAnchorsConfig. Nel riquadro Inspector (Controllo) immettere Account Key come valore per Object Anchors Account Key (Chiave account ancoraggi oggetto), Account ID come valore per Id account ancoraggi oggetto e come Account Domain valore per Dominio account ancoraggi oggetto.

Compilare ed eseguire l'app

Compilare la scena di esempio

Nell'editor di Unity passare a Assets/MixedReality.AzureObjectAnchors/Scenes e aprire AOASampleScene e aggiungerlo all'elenco di compilazioni della scena.

Selezionare File -> Compilazione Impostazioni. Selezionare piattaforma UWP (Universal Windows Platform) e quindi selezionare Cambia piattaforma. Se l'editor di Unity indica di dover prima scaricare alcuni componenti, scaricarli e installarli. Seguire lo screenshot seguente per configurare le impostazioni di compilazione. Assicurarsi che soloAOASampleScene abbia un segno di spunta accanto a esso: tutte le altre scene non devono essere incluse.

Selezionare Compila e selezionare una cartella di output. È ora possibile generare un progetto di Visual Studio nella cartella di output.

Compilare e distribuire l'app

Aprire il .sln file generato da Unity. Modificare la configurazione di compilazione come segue.

Sarà quindi necessario configurare l'indirizzo IP del computer remoto per distribuire ed eseguire il debug dell'app.

Fare clic con il pulsante destro del mouse sul progetto App e scegliere Proprietà. Nella pagina delle proprietà selezionare Proprietà di configurazione -> Debug. Modificare il valore nome computer con l'indirizzo IP del dispositivo HoloLens e fare clic su Applica.

Chiudere la pagina delle proprietà. Fare clic su Computer remoto. L'app deve iniziare a compilare e distribuire nel dispositivo remoto. Assicurarsi che il dispositivo sia attivo.

Dopo la schermata iniziale di Unity, verrà visualizzato un messaggio che indica che Object Observer è stato inizializzato.

L'app cerca gli oggetti nel campo corrente della visualizzazione e li tiene traccia una volta rilevati. Un'istanza verrà rimossa quando si trova a 6 metri dalla posizione dell'utente. Il testo di debug mostra i dettagli di un'istanza, ad esempio ID, timestamp aggiornato e rapporto di copertura della superficie.

Risoluzione dei problemi

Suggerimenti

Se l'oggetto non viene rilevato, è possibile provare i passaggi seguenti:

1. Verificare di usare il modello corretto per l'oggetto.
2. Visualizzare l'area di ricerca e assicurarsi che copre l'oggetto di destinazione.
3. Provare a ridurre .MinSurfaceCoverage
4. In Portale di dispositivi di Windows fare clic su Visualizzazioni -> Visualizzazioni 3D e verificare se l'analisi è stata completata.

Passaggi successivi

Unity HoloLens con MRTK

Concetti: Panoramica dell'SDK

Domande frequenti

SDK di conversione

Risoluzione dei problemi relativi al rilevamento degli oggetti