Comunicação remota holográfica – MRTK2

A comunicação remota holográfica transmite conteúdo holográfico de um computador para seu Microsoft HoloLens em tempo real, usando uma conexão de cabo Wi-Fi ou USB. Esse recurso pode aumentar significativamente a produtividade do desenvolvedor ao desenvolver aplicativos de realidade misturada.

O SDK do XR, conforme mencionado abaixo, refere-se ao novo pipeline XR do Unity no Unity 2019.3 e além. Confira aqui mais informações sobre como usar o SDK do XR com o MRTK. O XR herdado refere-se ao pipeline XR existente incluído no Unity 2018, preterido no Unity 2019.3 e removido no Unity 2020.

Instalação inicial

Para habilitar a comunicação remota para um HoloLens, é importante garantir que o projeto esteja usando os componentes de comunicação remota mais recentes.

  1. Abrir janela > Gerenciador de Pacotes
    • Se estiver usando o XR herdado: verifique se a versão mais recente do pacote de Windows Mixed Reality está instalada.
    • Se estiver usando o SDK do XR: verifique se a versão mais recente do pacote do plug-in do Windows XR está instalada.
  2. Verifique se o aplicativo de Comunicação Remota Holográfica mais recente está instalado, no HoloLens, por meio do Microsoft Store.

Continue com instruções de instalação do XR Herdado ou instruções de instalação do SDK do XR , dependendo de qual pipeline é usado no projeto.

Instruções de instalação do XR herdado

As instruções abaixo se aplicam somente à comunicação remota com HoloLens 2. Se você executar apenas a comunicação remota com HoloLens (1ª Geração), pule para Conectar-se ao HoloLens com Wi-Fi.

Ao usar um HoloLens 2, o suporte para comunicação remota de dados articulados de acompanhamento de mão e olho foi adicionado ao MRTK. Para habilitar esses recursos, siga as etapas documentadas em Importar DotNetWinRT para o projeto.

Depois de importado, a próxima etapa é selecionar Realidade Misturada>Toolkit>Utilities>Windows Mixed Reality>Check Configuration. Esta etapa adiciona uma definição de script que habilita a dependência DotNetWinRT.

Observação

Ao usar o Unity 2019.4 e versões mais recentes, não é necessário executar o utilitário Verificar Configuração.

Para habilitar o acompanhamento das articulações das mãos e do acompanhamento ocular, siga as etapas na depuração HoloLens 2 de comunicação remota por meio da importação de pacote do Unity e das seções relacionadas.

Depuração da comunicação remota HoloLens 2 por meio da importação de pacote do Unity

Se HoloLens 2 articulações de mão e acompanhamento ocular não estiverem funcionando na comunicação remota, haverá alguns pontos comuns de possíveis problemas. Eles estão listados abaixo na ordem em que devem ser verificados.

Esses problemas são particularmente relevantes ao serem executados no Unity 2019.3 ou posterior.

Importar DotNetWinRT para o projeto

  1. Baixar a Ferramenta de Recurso Realidade Misturada

  2. No modo de exibição Descobrir recursos, selecione Realidade Misturada Projeções do WinRT

    Select DotNetWinRT package

  3. Clique em Obter Recursos e continue importando o pacote.

DOTNETWINRT_PRESENT definir escrito nas configurações do player

Observação

Ao usar o Unity 2019.4 e versões mais recentes, o DOTNETWINRT_PRESENT definir está contido nos arquivos .asmdef apropriados e não no Configurações do Unity Player. A etapa Verificar Configuração não é necessária.

A partir da versão 2.5.0 do MRTK, por motivos de desempenho, essa #define não é mais definida automaticamente. Para habilitar esse sinalizador, use o item de menu Realidade Misturada Toolkit>Utilities>Windows Mixed Reality>Check Configuration.

Observação

O item Verificar Configuração não exibe uma confirmação. Para confirmar se a definição foi definida, navegue até a Configurações do Unity Player. Nela, na guia UWP, verifique em Outros Configurações para os Símbolos de Definição de Script. Verifique se DOTNETWINRT_PRESENT está escrito corretamente nessa lista. Se isso estiver lá, esta etapa foi bem-sucedida.

DotNetWinRT Present

Removendo HoloLens suporte à comunicação remota específica de 2

Se você estiver em conflitos ou outros problemas devido à presença do adaptador DotNetWinRT, entre em contato com um de nossos recursos de ajuda.

Instruções de instalação do SDK do XR

Siga as instruções de instalação do Windows Mixed Reality na página Introdução ao MRTK e ao SDK XR e execute a etapa necessária para comunicação remota HoloLens no editor.

Conectando-se ao HoloLens com Wi-Fi

Depois que o projeto for configurado, uma conexão poderá ser estabelecida com o HoloLens.

  1. No Configurações de Build de Arquivo>, verifique se o tipo de build do projeto está definido como Plataforma Universal do Windows

  2. No HoloLens, inicie o aplicativo De Comunicação Remota Holográfica.

  3. No Unity, selecione Realidade Misturada > Comunicação > Remota Holográfica para Modo de Reprodução.

    Start Holographic Emulation

  4. Defina o Modo de Emulação como Remoto para Dispositivo.

    Set Emulation Mode

  5. (Aplica-se somente ao XR herdado) Selecione a versão do dispositivo.

    Select Device Version

  6. Usando o endereço IP exibido pelo aplicativo Player de Comunicação Remota Holográfica, defina o campo Máquina Remota .

    Enter IP Address

  7. Clique em Conectar.

Observação

Se você não puder se conectar, verifique se o HoloLens 2 não está conectado ao computador e reinicie o Unity.

Conectando-se ao HoloLens com o cabo USB

A conexão de cabo USB oferece melhor qualidade de renderização e estabilidade. Para usar a conexão de cabo USB, desconecte-se do HoloLens do Wi-Fi no Configurações do HoloLens e inicie o aplicativo Holographic Remoting Player. Ele exibirá um endereço IP que começa com 169. Use esse endereço IP na configuração de Emulação Holográfica do Unity para se conectar. Depois que o endereço IP do cabo USB for identificado, é seguro conectar o HoloLens ao Wi-Fi novamente.

Iniciando uma sessão de comunicação remota

Com o Unity conectado à HoloLens, insira o modo de reprodução no editor.

Quando a sessão for concluída, saia do modo de reprodução.

Observação

Há um problema conhecido com algumas versões do Unity em que o editor pode ficar travado ao entrar no modo de reprodução durante uma sessão de comunicação remota. Esse problema poderá se manifestar se a janela holográfica estiver aberta quando o projeto for carregado. Para garantir que esse problema não ocorra, sempre feche a caixa de diálogo holográfica antes de sair do Unity.

Veja também