Remoting holográfico – MRTK2

A comunicação remota holográfica transmite conteúdos holográficos de um PC para o seu Microsoft HoloLens em tempo real, utilizando uma ligação Wi-Fi ou por cabo USB. Esta funcionalidade pode aumentar significativamente a produtividade dos programadores ao desenvolver aplicações de realidade mista.

O SDK XR, conforme mencionado abaixo, refere-se ao novo pipeline XR do Unity no Unity 2019.3 e posterior. Veja aqui para obter mais informações sobre como utilizar o SDK XR com MRTK. O Legacy XR refere-se ao pipeline XR existente incluído no Unity 2018, preterido no Unity 2019.3 e removido no Unity 2020.

Configuração inicial

Para permitir a comunicação remota para um HoloLens, é importante garantir que o projeto está a utilizar os componentes de remo mais recentes.

  1. Abrir o Gestor de Pacotes da Janela >
    • Se utilizar o XR legado: verifique se a versão mais recente do pacote de Windows Mixed Reality está instalada.
    • Se estiver a utilizar o SDK XR: verifique se a versão mais recente do pacote de Plug-in do Windows XR está instalada.
  2. Certifique-se de que a aplicação Holographic Remoting mais recente está instalada, no HoloLens, através da Microsoft Store.

Continue para instruções de configuração do Legacy XR ou instruções de configuração do SDK XR, consoante o pipeline utilizado no projeto.

Instruções de configuração do Legacy XR

As instruções abaixo aplicam-se apenas à comunicação remota com HoloLens 2. Se realizar apenas remoting com o HoloLens (1.ª Geração), avance para Ligar ao HoloLens com Wi-Fi.

Ao utilizar um HoloLens 2, o suporte para remoer dados articulados da mão e do controlo ocular foi adicionado ao MRTK. Para ativar estas funcionalidades, siga os passos documentados em Importar DotNetWinRT para o projeto.

Depois de importado, o próximo passo é selecionar Mixed Reality>Paraolkit>Utilitários>Windows Mixed Reality>Ver configuração. Este passo adiciona uma definição de script que permite a dependência DotNetWinRT.

Nota

Ao utilizar o Unity 2019.4 e o mais recente, não é necessário executar o utilitário Verificar Configuração.

Para ativar o controlo das articulações manos e do controlo ocular, siga os passos na secção Depurar HoloLens 2 remoting através da importação de pacotes do Unity e secções relacionadas.

Depurar HoloLens 2 remoting através da importação de pacotes do Unity

Se HoloLens 2 articulações manucas e o controlo ocular não estiverem a funcionar sobre a remoagem, existem alguns pontos comuns de potenciais problemas. Estão listados abaixo pela ordem em que devem ser verificados.

Estes problemas são particularmente relevantes quando são executados no Unity 2019.3 ou posterior.

Importar DotNetWinRT para o projeto

  1. Transferir a Ferramenta de Funcionalidades do Mixed Reality

  2. Na vista Descobrir funcionalidades, selecione Mixed Reality Projeções winRT

    Selecione Pacote DotNetWinRT

  3. Clique em Obter Funcionalidades e continue a importar o pacote.

DOTNETWINRT_PRESENT definir escritas nas definições do leitor

Nota

Ao utilizar o Unity 2019.4 e o mais recente, a definição DOTNETWINRT_PRESENT está contida nos ficheiros .asmdef adequados e não nas Definições do Leitor do Unity. O passo Verificar Configuração não é necessário.

A partir da versão 2.5.0 do MRTK, por motivos de desempenho, este #define já não está definido automaticamente. Para ativar este sinalizador, utilize o item de menuUtilitários>do Mixed Reality Toolkit>Windows Mixed Reality>Ver configuração.

Nota

O item Verificar Configuração não apresenta uma confirmação. Para confirmar que a definição foi definida, navegue para as Definições do Leitor do Unity. A partir daí, no separador UWP, verifique em Outras Definições para definir Símbolos de Scripting. Certifique-se de que DOTNETWINRT_PRESENT está escrito corretamente nessa lista. Se estiver aí, este passo foi bem-sucedido.

DotNetWinRT Presente

Remover o suporte de comunicação remota específico de HoloLens 2

Se estiver a ter conflitos ou outros problemas devido à presença do adaptador DotNetWinRT, contacte um dos nossos recursos de ajuda.

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

Siga as instruções de configuração do Windows Mixed Reality na página Introdução ao MRTK e ao SDK XR e certifique-se de que executa o passo necessário para o HoloLens Remoting no editor.

Ligar ao HoloLens com Wi-Fi

Depois de configurar o projeto, pode estabelecer uma ligação ao HoloLens.

  1. Em Definições de Compilação de Ficheiros>, certifique-se de que o tipo de compilação do projeto está definido para Plataforma Universal do Windows

  2. No HoloLens, inicie a aplicação Holographic Remoting .

  3. No Unity, selecione Mixed Reality > Remoting Holographic Remoting for Play Mode ( Remoting > Holográfico para Modo de Reprodução).

    Iniciar Emulação Holográfica

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

    Definir Modo de Emulação

  5. (Aplica-se apenas ao XR legado) Selecione a Versão do Dispositivo.

    Selecionar Versão do Dispositivo

  6. Com o Endereço IP apresentado pela aplicação Holographic Remoting Player, defina o campo Máquina Remota .

    Introduzir Endereço IP

  7. Clique em Ligar.

Nota

Se não conseguir estabelecer ligação, certifique-se de que a sua HoloLens 2 não está ligada ao PC e reinicie o Unity.

Ligar ao HoloLens com cabo USB

A ligação por cabo USB proporciona melhor qualidade e estabilidade de composição. Para utilizar a ligação por cabo USB, desligue-se do HoloLens do Wi-Fi nas Definições do HoloLens e inicie a aplicação Holographic Remoting Player. Irá apresentar um endereço IP que começa com 169. Utilize este endereço IP na definição de Emulação Holográfica do Unity para ligar. Assim que o endereço IP do cabo USB tiver sido identificado, é seguro ligar o HoloLens a Wi-Fi novamente.

Iniciar uma sessão remota

Com o Unity ligado ao HoloLens, introduza o modo de reprodução no editor.

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

Nota

Existe um problema conhecido com algumas versões do Unity em que o editor pode aguentar-se ao entrar no modo de reprodução durante uma sessão remota. Este problema poderá manifestar-se se a janela Holographic estiver aberta quando o projeto é carregado. Para garantir que este problema não ocorre, feche sempre a caixa de diálogo Holográfica antes de sair do Unity.

Ver também