Uso dell'emulatore HoloLens

Articolo
03/21/2023

L'emulatore HoloLens consente di testare le applicazioni olografiche nel PC senza l'uso di un dispositivo HoloLens fisico, incluso il set di strumenti per lo sviluppo per HoloLens. L'emulatore usa una macchina virtuale Hyper-V, dove gli input umani e ambientali letti dai sensori HoloLens vengono simulati tramite tastiera, mouse o controller Xbox. Non è nemmeno necessario modificare i progetti da eseguire nell'emulatore. L'app, infatti, non sa che non è in esecuzione in un dispositivo HoloLens reale.

Se intendi sviluppare applicazioni per visori VR immersive per Windows Mixed Reality o giochi per PC desktop, vedi le informazioni relative al simulatore di Windows Mixed Reality, che consente di simulare i visori per computer desktop.

Panoramica sull'emulatore HoloLens 2

Installazione dell'emulatore HoloLens

Scarica l'emulatore HoloLens.

Versioni:

Scaricare la build più recente dalla pagina di archiviazione dell'emulatore HoloLens.
Emulatore HoloLens (prima generazione) e modelli di progetto olografico.

Requisiti di sistema per l'emulatore HoloLens

L'emulatore HoloLens usa Hyper-V con RemoteFx (emulatore di prima generazione) o GPU-PV (emulatore HoloLens 2) per grafica con accelerazione hardware. Per usare l'emulatore, assicurati che il PC soddisfi i requisiti hardware seguenti:

Windows 10 Pro, Enterprise o Education a 64 bit

Nota

Windows 10 Home Edition non supporta Hyper-V o l'emulatore HoloLens.
L'emulatore HoloLens 2 richiede l'aggiornamento di Windows 10 (ottobre 2018) o versione successiva.
CPU a 64 bit
CPU con quattro core (o CPU multiple con quattro core in totale)
Almeno 8 GB di RAM
Nel BIOS le funzionalità seguenti devono essere supportate e abilitate:
- Virtualizzazione basata su hardware
- Conversione indirizzi di secondo livello (SLAT)
- Protezione esecuzione programmi basata su hardware
Requisiti della GPU
- DirectX 11.0 o versioni successive
- Driver di grafica WDDM 1.2 o versioni successive (prima generazione)
- Driver di grafica WDDM 2.5 (emulatore HoloLens 2)
- L'emulatore può funzionare con una GPU non supportata, ma sarà più lento

Se il sistema soddisfa i requisiti elencati in precedenza, verificare che sia stata abilitata la funzionalità"Hyper-V". Passare a Pannello di controllo -> Programmi -> Programmi e funzionalità -> Attivare o disattivare le funzionalità di Windows e verificare che Hyper-V sia selezionato.

Distribuzione delle app all'emulatore HoloLens

Carica la soluzione dell'applicazione in Visual Studio.

Nota

Se usi Unity, compila il progetto da Unity e quindi carica in Visual Studio la soluzione compilata, come al solito.
Per l'emulatore HoloLens (prima generazione), verificare che la piattaforma sia impostata su x86. Per l'emulatore HoloLens 2, verifica che la piattaforma sia impostata su x86 o x64.
Selezionare la versione di Emulatore HoloLens da usare come dispositivo di destinazione per il debug.
Passare a Debug > Avvia debug o premere F5 per avviare l'emulatore e distribuire l'applicazione per il debug.

Al primo avvio, l'emulatore può impiegare almeno un minuto a partire. È consigliabile mantenere aperto l'emulatore durante la sessione di debug, in modo da potervi distribuire rapidamente le applicazioni.

Input di base per l'emulatore

È possibile controllare l'emulatore in modo simile a molti videogiochi 3D comuni. Usando la tastiera, il mouse o il controller Xbox, sono disponibili diverse opzioni di input. Puoi controllare l'emulatore dirigendo le azioni di un utente simulato che indossa un dispositivo HoloLens. Le azioni spostano l'utente simulato in tutto l'ambiente. Le applicazioni in esecuzione nell'emulatore rispondono come farebbero in un dispositivo reale.

Il cursore in HoloLens (prima generazione) segue il movimento e la rotazione della testa. Nell'emulatore HoloLens 2 il cursore segue il movimento e l'orientamento delle mani.

Camminare avanti, indietro, verso sinistra e verso destra: usa i tasti W, A, S e D della tastiera oppure il joystick sinistro di un controller Xbox.
Guardare in alto, in basso, a sinistra e a destra: fare clic e trascinare il mouse, usare i tasti di direzione della tastiera o il joystick destro di un controller Xbox.
Simulare il tocco: fai clic con il pulsante destro del mouse, premi INVIO sulla tastiera oppure usa il pulsante A di un controller Xbox.
Aprire la mano a fiore/eseguire il movimento di sistema: premi il tasto Windows o F2 sulla tastiera oppure il pulsante B su un controller Xbox.
Usare il movimento della mano per scorrere: tenere premuti contemporaneamente ALT e il pulsante destro del mouse e trascinare il mouse verso l'alto o verso il basso. In un controller Xbox tenere premuti il grilletto destro e il pulsante A e spostare il joystick destro verso l'alto e verso il basso.
Movimento e orientamento della mano (solo emulatore HoloLens 2): tenere premuto ALT e trascinare il mouse verso l'alto o verso il basso, verso sinistra o verso destra per spostare la mano. È anche possibile usare i tasti di direzione e Q o E per ruotare e inclinare la mano. Per un controller Xbox, tenere premuto il pulsante dorsale sinistro o destro e usare la levetta sinistra per spostare la mano verso sinistra, verso destra, in avanti e indietro e la levetta destra per farla ruotare. Fare clic su croce direzionale su o giù per alzare o abbassare la mano.

Hai un visore VR immersive di Windows Mixed Reality? A partire dall'emulatore HoloLens 2 (Windows Holographic, versione 2004), puoi usare i controller del movimento e il visore VR immersive di Windows Mixed Reality per controllare l'emulatore HoloLens 2 e visualizzarlo in stereo. Vedi Uso di un visore VR immersive di Windows Mixed Reality e di controller del movimento con l'emulatore HoloLens 2

Struttura dell'emulatore HoloLens 2

Finestra principale

Finestra principale dell'emulatore HoloLens 2

A destra della finestra principale è presente la barra degli strumenti dell'emulatore. La barra degli strumenti contiene i pulsanti seguenti:

Chiudi: chiude l'emulatore.
Riduci a icona: riduce al minimo la finestra dell'emulatore.
Pannello di controllo simulazione: mostra o nasconde il pannello di controllo Simulazione per la configurazione e il controllo dell'input nell'emulatore.
Adatta allo schermo: adatta l'emulatore allo schermo.
Zoom: rendere l'emulatore più grande e più piccolo.
Guida: Aprire la Guida per gli emulatori.
Aprire Portale di dispositivi: aprire Il portale di dispositivi di Windows per il sistema operativo HoloLens nell'emulatore.
Strumenti: aprire il riquadro Strumenti aggiuntivi.

Simulation Control Panel (Pannello di controllo simulazione)

Tale pannello consente di visualizzare la posizione e l'orientamento correnti dell'utente simulato e dei dispositivi di input simulati. Consente anche di configurare sia l'input simulato, ad esempio per mostrare o nascondere una o entrambe le mani, sia i dispositivi usati per controllare l'input simulato, come la tastiera, il mouse e il game pad del PC.

Simulation Control Panel (Pannello di controllo simulazione)

Per nascondere o visualizzare il pannello di simulazione, selezionare il pulsante della barra degli strumenti oppure premere F7 sulla tastiera.
Passare il puntatore del mouse su un controllo o un campo per visualizzare una descrizione comando contenente i controlli della tastiera, del mouse o del game pad.
Per mostrare o nascondere una mano, usa l'interruttore appropriato sotto Left hand (Mano sinistra) o Right hand (Mano destra).
Per controllare la mano, usa il tasto ALT sinistro o destro sulla tastiera oppure il pulsante dorsale sinistro o destro del game pad.
Per indirizzare tutto l'input a una o a entrambe le mani, selezionare il pulsante con la puntina da disegno sotto l'interruttore, che equivale a tenere premuto ALT per la mano.
Per controllare la direzione dello sguardo, selezionare la puntina da disegno nella sezione Eyes (Occhi), che corrisponde a tenere premuto il tasto Y sulla tastiera.
Per caricare la registrazione di una stanza, selezionare il pulsante Load (Carica) nella sezione Recording (Registrazione). Per altre informazioni, vedi Stanze simulate.
Per regolare la velocità con cui l'utente o i dispositivi di input simulati si muoveranno o ruoteranno in risposta all'input proveniente dalla tastiera, dal mouse o dal game pad, selezionare l'icona a forma di ingranaggio accanto a Input settings (Impostazioni input) e regolare i dispositivi di scorrimento.
Per impostazione predefinita, l'input da tastiera controlla l'utente simulato e l'input simulato. Se vuoi che l'input da tastiera del PC venga inviato a HoloLens, deseleziona l'opzione Use keyboard for simulation (Usa tastiera per simulazione). F4 è il tasto di scelta rapida per questa impostazione.
Se il pannello di simulazione è già visibile, premi F8 per spostarvi lo stato attivo della tastiera.
Per disancorare il pannello di simulazione dalla finestra dell'emulatore, selezionare il pulsante nella parte inferiore del pannello oppure premere F9 sulla tastiera. Se chiudi la finestra o premi ancora F9, tornerai all'emulatore.
Il pannello di controllo della simulazione può essere avviato come applicazione separata, consentendo di connettersi e controllare l'emulatore HoloLens 2, un dispositivo HoloLens 2 o una simulazione di Windows Realtà mista eseguendo PerceptionSimulationInput.exe da %ProgramFiles(x86)%\Windows Kits\10\Microsoft XDE\10.0.18362.0.

Scheda Account

La scheda Account consente di configurare l'emulatore per eseguire l'accesso con un account Microsoft. Ciò è utile per testare le API che richiedono che l'utente sia connesso con un account. Se attivi o disattivi questa opzione, devi chiudere completamente l'emulatore HoloLens e riavviarlo per rendere effettiva l'impostazione. Se questa opzione è abilitata, agli avvii successivi dell'emulatore verrà chiesto di eseguire l'accesso, come avverrebbe per un utente al primo avvio di HoloLens. Per immettere le credenziali usando la tastiera del PC, disattiva prima l'opzione Use keyboard for simulation (Usa tastiera per simulazione) nel pannello di controllo simulazione oppure premi F4 per attivare o disattivare l'impostazione della tastiera.

Scheda Optional settings (Impostazioni facoltative)

Nella scheda Optional settings (Impostazioni facoltative) viene visualizzato un controllo per abilitare o disabilitare la grafica con accelerazione hardware. Questo tipo di grafica verrà usato per impostazione predefinita, se è supportato dal driver della scheda grafica del PC. Se il driver della scheda grafica non supporta GPU-PV, questa opzione non sarà visibile.

Scheda Diagnostics (Diagnostica)

La scheda Diagnostics (Diagnostica) mostra l'indirizzo IP dell'emulatore sotto forma di collegamento al Portale di dispositivi di Windows insieme allo stato della GPU virtuale.

Scheda rete

La scheda Network (Rete) mostra i dettagli della scheda di rete per l'emulatore, nonché i dettagli della scheda di rete per il computer host. Per l'emulatore HoloLens 2, questa scheda verrà visualizzata solo se l'emulatore viene eseguito nell'Aggiornamento di Windows 10 (maggio 2019) o in versioni successive.

Scheda NAT Configuration (Configurazione NAT)

Questa scheda verrà visualizzata solo se l'emulatore viene eseguito nell'Aggiornamento di Windows 10 (maggio 2019) o in versioni successive.

L'emulatore usa la connessione di rete del PC e si trova dietro un NAT. Questa scheda consente di eseguire il mapping delle porte dal PC host all'emulatore e, in questo modo, i dispositivi remoti possono connettersi ad applicazioni e servizi in esecuzione nell'emulatore.

Ad esempio, se vuoi accedere al Portale di dispositivi nell'emulatore da un PC remoto:

Aggiungi una voce per la porta interna 80 (la porta su cui è in ascolto il Portale di dispositivi) facendo doppio clic su una riga libera nella tabella. Per altre applicazioni, immetti il numero di porta su cui l'applicazione è in ascolto.
Scegli una qualsiasi porta esterna disponibile. In questo esempio verrà usata la porta 8080 come porta esterna.
Seleziona il protocollo. L'impostazione predefinita è TCP. Poiché il Portale di dispositivi usa il protocollo TCP, l'impostazione predefinita verrà mantenuta.
Fai clic su "Apply Changes" (Applica modifiche) per abilitare il mapping. Nella colonna "Status" (Stato) lo stato passerà da "Pending" (In attesa) ad "Active" (Attiva).
Nel PC remoto apri un browser e passa a (IP-del-PC-che-esegue-emulatore):8080. Verrà visualizzata l'interfaccia del Portale di dispositivi. L'indirizzo IP usato in un PC remoto deve essere l'indirizzo IP del PC che esegue l'emulatore, non dell'emulatore stesso. Puoi recuperare l'indirizzo IP in diversi modi, ad esempio tramite l'app Impostazioni nel PC nella categoria Rete e Internet, tramite ipconfig al prompt dei comandi e dalla scheda Network (Rete) nella finestra di dialogo degli strumenti dell'emulatore cercando la voce relativa alla scheda desktop.

Considera inoltre che, se aggiungi un mapping di porte per il Portale di dispositivi, puoi controllare l'emulatore in remoto usando lo strumento per il controllo della simulazione della percezione incluso nell'installazione dell'emulatore oppure con le API di simulazione della percezione connettendoti all'indirizzo IP del PC host e alla porta esterna del Portale di dispositivi, ad esempio alla porta 8080 nell'esempio precedente. Quando usi il controllo della simulazione della percezione per connetterti e controllare l'emulatore in remoto, specifica solo l'indirizzo IP del PC e la porta configurata. Non includere "https://".

Per impostazione predefinita, non sono presenti mapping delle porte. Tutti gli eventuali mapping configurati vengono mantenuti tra un avvio e l'altro dell'emulatore HoloLens 2 e verranno abilitati automaticamente quando l'emulatore è completamente avviato.

Usa il pulsante Export (Esporta) per salvare i mapping in un file. Puoi quindi condividere questo file con altri membri del team, che potranno poi usare il pulsante Import (Importa) per configurare automaticamente gli stessi mapping.

Scheda NAT Configuration (Configurazione NAT) dell'emulatore HoloLens

Scheda Updates (Aggiornamenti)

Questa scheda verrà visualizzata solo se l'emulatore viene eseguito nell'Aggiornamento di Windows 10 (maggio 2019) o in versioni successive.

All'avvio, l'emulatore verificherà l'eventuale disponibilità di nuove versioni. Se è disponibile una nuova versione, l'emulatore visualizzerà un prompt che mostra la versione attualmente installata e la versione disponibile e che chiede se vuoi eseguire l'aggiornamento. Se selezioni 'Yes' (Sì), viene scaricato il programma di installazione per la nuova versione.

La scheda Aggiornamenti consente di controllare se l'emulatore controlla o meno le nuove versioni attivando la casella di controllo "Verifica automatica aggiornamenti" in questa scheda. Consente anche di visualizzare e scaricare altre versioni disponibili dell'emulatore, a partire dall'aggiornamento di settembre 2019. Per le versioni diverse da quella attualmente in esecuzione, viene fornito un collegamento per il download. Fai clic sul collegamento per scaricare il programma di installazione per la versione in questione.

Scheda Updates (Aggiornamenti) dell'emulatore HoloLens

Uso di un visore VR immersive di Windows Mixed Reality e di controller del movimento con l'emulatore HoloLens 2

A partire dall'emulatore HoloLens 2 (Windows Holographic, versione 2004), puoi usare i controller del movimento e il visore VR immersive di Windows Mixed Reality per visualizzare e interagire con l'emulatore HoloLens 2 in stereo. Questa opzione consente di eseguire movimenti più veloci e naturali con la testa e le mani senza un dispositivo HoloLens 2. Non si tratta di sostituire completamente un dispositivo HoloLens 2, ma della possibilità di usufruire di un'esperienza migliorata in aggiunta all'interazione con l'emulatore tramite tastiera, mouse e game pad in una finestra desktop 2D. Per abilitare questa funzionalità:

Assicurati che Windows Mixed Reality sia configurato nel PC e che il visore VR immersive di Windows Mixed Reality sia connesso.
Avvia l'emulatore HoloLens 2
Apri il pannello di simulazione facendo clic sul pulsante della barra degli strumenti o premendo F7.
Scorri il pannello in basso.
Seleziona la casella "Use HMD for simulation" (Usa HMD per la simulazione).
Windows Mixed Reality viene avviato e lo schermo dell'emulatore viene modificato leggermente. Senza un visore VR, l'emulatore posiziona gli occhi al centro della testa e visualizza un solo occhio. Con una visore VR, l'emulatore genera un vero output stereo, ma esegue il rendering di un solo occhio nella finestra del desktop, mentre entrambi gli occhi vengono sottoposti a rendering nel visore VR.
Facoltativamente, attiva uno o entrambi i controller del movimento. L'input del controller viene mappato all'input della mano nell'emulatore, ad esempio per toccare, effettuare il pull del trigger sul controller del movimento. Per spostarti, usa la levetta. Per un elenco completo dei controlli, vedi Emulatore HoloLens avanzato e input per il simulatore di Windows Mixed Reality.

Problemi di visualizzazione del contenuto nel visore VR?

Se la visualizzazione è vuota sia nel visore che nel portale di Mixed Reality, ma nella finestra dell'emulatore HoloLens 2 sul desktop viene visualizzato il contenuto, verifica che l'accelerazione grafica hardware sia abilitata nell'emulatore. Per il supporto per il visore VR immersive di Windows Mixed Reality devi abilitare l'accelerazione grafica hardware nell'emulatore.
Se visualizzi contenuto nel visore VR, ma gli ologrammi sono sfocati o se visualizzi un'immagine doppia, segui questa procedura per modificare la visualizzazione stereo per gli occhi:

Disattiva temporaneamente "Use HMD for simulation" (Usa HMD per la simulazione).
Avvia l'editor del Registro di sistema (regedit.exe).
Passa a HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation
Crea un nuovo valore DWORD denominato "EnableEyePoseControl" e impostane il valore su 1.
Abilita "Use HMD for simulation" (Usa HMD per la simulazione) nell'emulatore.
Quando il contenuto viene visualizzato nel visore VR, usa i tasti di direzione per regolare la rotazione dell'occhio. Tieni premuto il tasto ALT di sinistra per modificare l'occhio sinistro e il tasto ALT di destra per modificare l'occhio destro. Usa i tasti "Q" ed "E" per regolare la rotazione degli occhi, tenendo premuto il tasto ALT specifico per l'occhio da modificare. Usa i tasti "+" e "-" per regolare la distanza tra gli occhi. Si noti che +/- in un riquadro numerico non funzionerà. Usare i pulsanti sulla tastiera principale.
Quando la visualizzazione stereo appare corretta, fai clic su "S" per salvare le modifiche. La nuova configurazione verrà salvata per gli avvi futuri dell'emulatore.
Se vuoi abbandonare le modifiche e ripristinare la configurazione precedente, premi il tasto "L" per caricare la configurazione predefinita o precedente.
Imposta il valore "EnableEyePoseControl" nel Registro di sistema su 0 e scorri fino all'opzione "Use HMD for simulation" (Usa HMD per la simulazione).

Se si vuole rimuovere una configurazione precedentemente salvata, è possibile eliminare il valore denominato "DisplayConfiguration" in HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation. Se attualmente usi il visore VR con l'emulatore, dovrai disabilitare l'opzione "Use HMD for simulation" (Usa HMD per la simulazione) e riattivarla per verificare che la modifica abbia effetto.