Utilizar o Emulador do HoloLens

Artigo
07/12/2023

O Emulador do HoloLens permite-lhe testar aplicações holográficas no seu PC sem um HoloLens físico, incluindo o conjunto de ferramentas de desenvolvimento do HoloLens. O emulador utiliza uma máquina virtual Hyper-V, o que significa que as entradas humanas e ambientais lidas pelos sensores do HoloLens são simuladas a partir do teclado, rato ou comando Xbox. Nem precisa de modificar os seus projetos para serem executados no emulador. A aplicação não sabe que não está a ser executada num HoloLens real.

Se quiser desenvolver Windows Mixed Reality aplicações ou jogos de headset envolventes (VR) para PCs de ambiente de trabalho, consulte o simulador de Windows Mixed Reality, que lhe permite simular headsets de ambiente de trabalho.

Descrição Geral do Emulador do HoloLens 2

Instalar o Emulador do HoloLens

Transfira o HoloLens Emulator.

Versões:

Transfira a compilação mais recente a partir da página de arquivo do HoloLens Emulator .
HoloLens Emulator (primeira geração) e modelos de projeto holográfico.

Requisitos de sistema do HoloLens Emulator

O Emulador do HoloLens utiliza o Hyper-V com RemoteFx (emulador de primeira geração) ou GPU-PV (HoloLens 2 Emulador) para gráficos acelerados por hardware. Para utilizar o emulador, certifique-se de que o PC cumpre os seguintes requisitos de hardware:

Windows 10 Pro de 64 bits, Enterprise ou Education

Nota

Windows 10 Home Edition não suporta o Hyper-V ou o HoloLens Emulator.
O Emulador do HoloLens 2 requer a atualização Windows 10 outubro de 2018 ou posterior.
CPU de 64 bits
CPU com quatro núcleos (ou várias CPUs com um total de quatro núcleos)
8 GB de RAM ou mais
No BIOS, as seguintes funcionalidades têm de ser suportadas e ativadas:
- Virtualização assistida por hardware
- Tradução de Endereços de Segundo Nível (SLAT)
- Prevenção de Execução de Dados Baseada em Hardware (DEP)
Requisitos de GPU
- DirectX 11.0 ou posterior
- Controlador gráfico WDDM 1.2 ou posterior (primeira geração)
- Controlador gráfico WDDM 2.5 (HoloLens 2 Emulador)
- O emulador pode funcionar com uma GPU não suportada, mas será mais lento

Se o seu sistema cumprir os requisitos listados acima, certifique-se de que a funcionalidade "Hyper-V" foi ativada no seu sistema. Aceda a Painel de Controlo -> Programas -> Programas e Funcionalidades - Ative> ou desative as Funcionalidades do Windows e verifique se o Hyper-V está selecionado.

Implementar aplicações no Emulador do HoloLens

Carregue a solução de aplicação no Visual Studio.

Nota

Ao utilizar o Unity, crie o seu projeto a partir do Unity e, em seguida, carregue a solução incorporada para o Visual Studio, como habitualmente.
Para o HoloLens Emulator (primeira geração), certifique-se de que a Plataforma está definida como x86. Para o HoloLens 2 Emulador, certifique-se de que a Plataforma está definida como x86 ou x64.
Selecione a versão do HoloLens Emulator que pretende como o dispositivo de destino para depuração.
Aceda a Depurar > Iniciar Depuração ou prima F5 para iniciar o emulador e implementar a sua aplicação para depuração.

O emulador pode demorar um minuto ou mais a arrancar quando o iniciar pela primeira vez. Recomendamos que mantenha o emulador aberto durante a sessão de depuração, para que possa implementar rapidamente aplicações no emulador.

Entrada do emulador básico

Controlar o emulador é semelhante a muitos videojogos 3D comuns. As opções de entrada estão disponíveis para utilizar o teclado, o rato ou o comando Xbox. Pode controlar o emulador ao direcionar as ações de um utilizador simulado com um HoloLens. As suas ações movem o utilizador simulado pelo ambiente. As aplicações em execução no emulador respondem como se estivessem num dispositivo real.

O cursor no HoloLens (primeira geração) segue o movimento e a rotação da cabeça. No HoloLens 2 Emulador, o cursor segue o movimento e a orientação da mão.

Andar para a frente, para trás, para a esquerda e para a direita – utilize as teclas W, A, S e D no teclado ou o pau esquerdo num comando Xbox.
Procurar para cima, para baixo, para a esquerda e para a direita – selecione e arraste o rato, utilize as teclas de seta no teclado ou a vara direita num comando Xbox.
Gesto de toque de ar – clique com o botão direito do rato, prima a tecla Enter no teclado ou utilize o botão A num comando Xbox.
Gesto Desabrochar/Sistema – prima a tecla Windows ou a tecla F2 no teclado ou prima o botão B num comando Xbox.
Movimento da mão para deslocamento – mantenha premida simultaneamente a tecla Alt e o botão direito do rato e arraste o rato para cima ou para baixo. Num comando Xbox, mantenha premido o acionador direito e o botão A e mova o stick direito para cima e para baixo.
Movimento e orientação da mão (apenas HoloLens 2 Emulador) – mantenha premida a tecla Alt e arraste o rato para cima ou para baixo, para a esquerda ou para a direita para mover a mão. Também pode utilizar as teclas de seta e Q ou E para rodar e inclinar a mão. Para um comando Xbox, mantenha premido o pára-choques esquerdo ou direito e utilize o manípulo esquerdo para mover a mão para a esquerda, direita, para a frente e para trás, o manípulo direito para rodá-lo. Utilize para cima ou para baixo no Dpad para levantar ou baixar a mão.

Tem um headset Windows Mixed Reality envolvente? A partir do Emulador do HoloLens 2 (Windows Holographic, versão 2004), pode utilizar os auscultadores e controladores de movimento envolventes Windows Mixed Reality para controlar o Emulador HoloLens 2 e vê-lo em estéreo. Consulte Utilizar um headset envolvente Windows Mixed Reality e comandos de movimento com o Emulador do HoloLens 2

Anatomia do Emulador HoloLens 2

Janela principal

HoloLens 2 janela principal do Emulador

À direita da janela principal, localize a barra de ferramentas do emulador. A barra de ferramentas contém os seguintes botões:

Fechar: fecha o emulador.
Minimizar: minimiza a janela do emulador.
painel de controlo Simulação: mostrar ou ocultar o painel de controlo Simulação para configurar e controlar a entrada no emulador.
Ajustar ao ecrã: ajusta o emulador ao ecrã.
Zoom: aumentar e diminuir o emulador.
Ajuda: Ajuda para abrir emuladores.
Abrir Portal do Dispositivo: abra o Portal do Dispositivo Windows para o SO HoloLens no emulador.
Ferramentas: abra o painel Ferramentas adicionais .

Painel de controlo simulação

O painel de controlo Simulação permite-lhe ver a posição e orientação atuais dos dispositivos humanos e de entrada simulados. Também lhe permite configurar entradas simuladas, como mostrar ou ocultar uma ou ambas as mãos, e dispositivos utilizados para controlar entradas simuladas, como o teclado, o rato e o gamepad do PC.

Painel de controlo simulação

Para ocultar ou mostrar o painel de simulação, selecione o botão da barra de ferramentas ou prima F7 no teclado.
Paire o rato sobre um controlo ou campo para apresentar uma descrição que contenha controlos de teclado, rato e gamepad.
Para mostrar ou ocultar uma mão, alterne o botão adequado em Mão esquerda ou Direita.
Para controlar a mão, utilize as teclas Alt esquerda ou direita no teclado ou o pára-choques esquerdo ou direito no gamepad.
Para direcionar todas as entradas para uma ou ambas as mãos, selecione o botão de alfinete sob o botão de alternar, que é o mesmo que segurar a tecla Alt para a mão.
Para controlar a direção do olhar, selecione o pino na secção Olhos, que é o mesmo que manter premida a tecla Y no teclado.
Para carregar uma gravação de sala, selecione o botão Carregar na secção Gravação. Veja salas simuladas para obter mais informações.
Para ajustar a velocidade que os dispositivos humanos ou de entrada simulados irão mover ou rodar em resposta à entrada de teclado, rato ou gamepad, selecione o ícone de engrenagem junto a Definições de entrada e ajuste os controlos de deslize.
Por predefinição, a entrada de teclado controla as entradas simuladas e humanas simuladas. Para que a entrada de teclado do PC seja enviada para o HoloLens, desmarque Utilizar teclado para simulação. F4 é a tecla de atalho para esta definição.
Se o painel de simulação já estiver visível, premir F8 move o foco do teclado para o mesmo.
Para desancorar o painel de simulação da janela do emulador, selecione o botão na parte inferior do painel ou prima F9 no teclado. Fechar a janela ou premir F9 novamente devolve a janela ao emulador.
O painel de controlo de simulação pode ser iniciado como uma aplicação separada, permitindo-lhe ligar e controlar o Emulador HoloLens 2, um dispositivo HoloLens 2 ou Windows Mixed Reality simulação ao executar PerceptionSimulationInput.exe a partir de %ProgramFiles(x86)%\Windows Kits\10\Microsoft XDE\10.0.18362.0.

Separador Conta

O separador Conta permite-lhe configurar o emulador para iniciar sessão com uma Conta Microsoft. Isto é útil para testar APIs que exigem que o utilizador tenha sessão iniciada com uma conta. Ativar esta opção requer que feche completamente e reinicie o Emulador do HoloLens para que a definição entre em vigor. Se esta opção estiver ativada, os lançamentos posteriores do emulador pedir-lhe-ão para iniciar sessão, tal como um utilizador faria com que o HoloLens fosse iniciado pela primeira vez. Para introduzir as suas credenciais com o teclado do PC, primeiro desative Utilizar teclado para simulação no Painel de Controlo de Simulação ou prima F4 no teclado para ativar ou desativar a definição do teclado.

Separador Definições opcionais

O separador Definições opcionais apresenta um controlo para ativar ou desativar gráficos acelerados por hardware. Os gráficos acelerados por hardware são utilizados por predefinição, se suportados pela unidade de placa gráfica do PC. Se o controlador da placa gráfica não suportar GPU-PV, esta opção não estará visível.

Separador Diagnóstico

O separador Diagnóstico mostra o endereço IP do emulador sob a forma de uma ligação para o Portal do Dispositivo Windows, juntamente com o estado da GPU virtual.

Separador Rede

O separador Rede mostra os detalhes da placa de rede para o emulador, bem como os detalhes da placa de rede do computador anfitrião. No HoloLens 2 Emulador, este separador só será apresentado quando executar o emulador no Atualização de Maio de 2019 do Windows 10 ou mais recente.

Separador Configuração NAT

Este separador só será apresentado ao executar o emulador no Atualização de Maio de 2019 do Windows 10 ou mais recente.

O emulador utiliza a ligação de rede do PC e fica atrás de um NAT. Este separador permite-lhe mapear portas do PC anfitrião para o emulador, o que permite que os dispositivos remotos se liguem a aplicações e serviços em execução no emulador.

Por exemplo, se quiser aceder ao Portal do Dispositivo no emulador a partir de um PC remoto:

Adicione uma entrada para a porta interna 80 (a porta na qual o Portal do Dispositivo está a escutar) ao fazer duplo clique numa linha gratuita na tabela. Para outras aplicações, introduza o número de porta em que essa aplicação está a escutar.
Escolha qualquer porta externa disponível. Neste exemplo, vamos utilizar a porta 8080 como porta externa.
Selecione o protocolo. A predefinição é TCP. Uma vez que o Portal do Dispositivo utiliza TCP, deixaremos a predefinição.
Clique em "Aplicar Alterações" para ativar o mapeamento. O "Estado" mudará de "Pendente" para "Ativo".
No PC remoto, abra um browser e navegue para (IP-of-the-PC-running-the-emulator):8080. Será apresentada a interface do Portal do Dispositivo. O endereço IP que utiliza num PC remoto tem de ser o endereço IP do PC que executa o emulador e não o próprio emulador. Pode obter o IP através de vários meios, como a aplicação Definições no PC, na categoria "Rede & Internet", "ipconfig" a partir de uma Linha de Comandos e a partir do separador Rede na caixa de diálogo Ferramentas do emulador ao procurar a entrada Adaptador de Ambiente de Trabalho.

Tenha também em atenção que, se adicionar um mapeamento de porta para o Portal do Dispositivo, pode controlar o emulador remotamente com a ferramenta Controlo de Simulação de Perceção incluída na instalação do emulador ou com as APIs de Simulação de Perceção ao ligar ao endereço IP do PC anfitrião e à porta externa do Portal do Dispositivo, tal como 8080 no exemplo acima. Ao utilizar o Controlo de Simulação de Percepção para ligar e controlar o emulador remotamente, especifique apenas o endereço IP do PC e a porta configurada. Não inclua "https://".

Por predefinição, não existem mapeamentos de portas. Todos os mapeamentos que configurar são persistentes nos lançamentos do HoloLens 2 Emulador e serão ativados automaticamente quando o emulador tiver iniciado completamente.

Utilize o botão "Exportar" para guardar os mapeamentos num ficheiro. Em seguida, pode partilhar este ficheiro com outros membros da equipa que podem utilizar o botão "Importar" para configurar automaticamente os mesmos mapeamentos.

Separador

separador Atualizações

Este separador só será apresentado ao executar o emulador no Atualização de Maio de 2019 do Windows 10 ou mais recente.

No arranque, o emulador irá verificar a existência de novas versões. Se estiver disponível uma nova versão, o emulador apresentará um pedido que mostra a versão que tem, juntamente com a versão disponível e perguntando se pretende atualizar. Se selecionar "Sim", o instalador da nova versão será transferido.

O separador Atualizações permite-lhe controlar se o emulador verifica ou não novas versões ao alternar a caixa de verificação "Procurar automaticamente atualizações" neste separador. Também lhe permite ver e transferir outras versões do emulador disponíveis, a partir da Atualização de Setembro de 2019. Para versões diferentes das que estão atualmente em execução, é fornecida uma ligação de transferência. Clicar nesta ligação irá transferir o instalador para essa versão.

Separador 'Atualizações' do Emulador do HoloLens

Utilizar um headset envolvente Windows Mixed Reality e comandos de movimento com o Emulador HoloLens 2

A partir do Emulador do HoloLens 2 (Windows Holographic, versão 2004), pode utilizar um headset Windows Mixed Reality e controladores de movimento para ver e interagir com o Emulador HoloLens 2 em estéreo. Isto permite-lhe fazer movimentos mais rápidos e naturais com a cabeça e as mãos sem um dispositivo HoloLens 2. Não é uma substituição completa para um dispositivo HoloLens 2, mas destina-se a proporcionar uma experiência melhorada para além de interagir com o emulador através do teclado, rato e gamepad numa janela de ambiente de trabalho 2D. Para ativar esta funcionalidade:

Certifique-se de que Windows Mixed Reality está configurado no PC e que o headset envolvente Windows Mixed Reality está ligado.
Iniciar o Emulador do HoloLens 2
Abra o painel Simulação clicando no botão da barra de ferramentas ou premindo F7.
Desloque o painel para a parte inferior.
Selecione a caixa com o nome "Utilizar HMD para simulação"
Windows Mixed Reality será iniciado e o ecrã do emulador mudará ligeiramente. Sem auscultadores, o emulador coloca ambos os olhos no centro da cabeça e apresenta apenas um olho. Com um auricular, o emulador gera uma saída estéreo verdadeira, mas só compõe um olho na janela de ambiente de trabalho, enquanto ambos os olhos são compostos para o headset.
Opcionalmente, ative um ou ambos os comandos de movimento. A entrada do controlador é mapeada para a introdução manual no emulador. Por exemplo, para tocar, puxe o acionador no comando de movimento. Para se mover, utilize o manípulo. Para obter uma lista completa dos controlos, veja Advanced HoloLens Emulator and Mixed Reality Simulator input (Entrada avançada do Emulador do HoloLens e do Simulador de Mixed Reality)

Está com dificuldades em ver conteúdo no headset?

Se o ecrã estiver em branco no headset e no Portal do Mixed Reality, mas vir conteúdo na janela HoloLens 2 Emulador no ambiente de trabalho, verifique se a aceleração de gráficos de hardware está ativada no emulador. Windows Mixed Reality suporte para auscultadores envolventes requer que a aceleração de gráficos de hardware seja ativada no emulador.
Se vir conteúdo no headset, mas os hologramas estiverem desfocados ou vir uma imagem dupla, utilize os passos seguintes para ajustar a vista estéreo para os seus olhos:

Desative temporariamente "Utilizar HMD para simulação".
Iniciar o Editor de Registo (regedit.exe)
Navegue para HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation
Crie um novo valor DWORD com o nome "EnableEyePoseControl" e defina o respetivo valor como 1.
Ative "Utilizar HMD para simulação" no emulador.
Quando o conteúdo aparecer no headset, utilize as teclas de seta para ajustar a rotação ocular. Prima Alt esquerdo para ajustar o olho esquerdo e Alt direito para ajustar o olho direito. Utilize "Q" e "E" para ajustar os rolos para cada olho, mantendo novamente a tecla Alt adequada para o olho. Utilize as teclas "+" e "-" para ajustar a distância entre os olhos. (Tenha em atenção que +/- num teclado numérico não funcionará. Utilize os botões no teclado principal.)
Quando a vista estéreo aparecer corretamente, prima "S" para guardar as alterações. A nova configuração será guardada para futuras iniciações do emulador.
Se quiser abandonar as alterações e reverter para a configuração anterior, prima "L" para carregar a configuração predefinida ou anterior.
Altere o valor "EnableEyePoseControl" no registo para 0 e ciclo a opção "Utilizar HMD para simulação".

Se tiver guardado uma configuração e quiser removê-la, pode eliminar o valor com o nome "DisplayConfiguration" em HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation. Se estiver a utilizar o headset com o emulador, terá de desativar "Utilizar HMD para simulação" e voltar a ativá-lo para ver esta alteração entrar em vigor.