Configurar a Prévia direta para Unity

A prévia direta permite testar e iterar interações complexas diretamente no modo de reprodução do Unity Editor usando dados ativos do dispositivo Android XR. Com a prévia direta, a máquina host renderiza e depura o conteúdo, transmite a janela de visualização diretamente para o dispositivo Android XR físico e transmite as extensões OpenXR compatíveis de volta para o host em tempo real.

Siga este guia para configurar a prévia direta do seu projeto no Unity.

Pré-requisitos

Antes de começar, verifique se o ambiente de desenvolvimento atende aos seguintes requisitos:

• Versão do Unity: Unity 6 versão 6000.3.5f2 ou mais recente.
• Configuração do projeto: siga todas as etapas do guia de configuração do projeto do Unity.
• Pacotes do Unity: siga todas as etapas do guia de início rápido das extensões do Android XR para Unity. Ao importar pacotes, use a versão 1.2.0 ou mais recente das extensões do Android XR para Unity. Ela é fornecida como um arquivo tar em cada versão.

• Android XR Engine Hub: siga todas as etapas da seção de introdução do guia do Android XR Engine Hub para instalar e configurar sua máquina host para a prévia direta.

• Hardware:

  • Use uma máquina host com o Windows 11.
  • Use uma placa de vídeo moderna com suporte à codificação de vídeo Vulkan.

Analisar problemas e limitações conhecidos

Analise os problemas e limitações conhecidos a seguir para saber o que esperar ao usar a prévia direta no Unity:

• Áudio: o áudio não é transmitido para o headset. Em vez disso, ele é reproduzido nos alto-falantes ou fones de ouvido da máquina host.
• Resolução: os controles para alterar a resolução são limitados. O sistema solicita {2364, 2880} por olho.
• Interface/experiência do usuário: o fluxo de conexão do cliente é funcional, mas não refinado para essa versão inicial.
• Suporte a extensões: embora muitas extensões sejam compatíveis (como rastreamento de mãos , olhar e rosto), esse é um conjunto limitado em comparação com builds nativos.

Configurar elementos gráficos

Defina o Vulkan como o renderizador padrão no Windows que processa a codificação de transmissão de vídeo:

1. Acesse Edit > Project Settings > Player.
2. Clique na guia Other Settings.
3. Desmarque a opção Auto Graphics API for Windows.
4. Se Direct3D11 ou Direct3D12 estiverem listados, selecione cada um deles e clique em menos (-).

5. Adicionar Vulkan: clique em mais (+) e selecione Vulkan.

   

6. Reinicie o Unity Editor para aplicar essas mudanças.

Configurar as definições de gerenciamento de plug-ins do OpenXR

Configure os plug-ins do OpenXR para transmissão:

1. Acesse Edit > Project Settings > XR Plug-in Management.
2. Clique na guia Windows / Standalone (ela tem um ícone de computador).
3. Na seção Plug-in Providers, selecione OpenXR.
4. Na seção OpenXR Feature Group, selecione Android XR (Extensions).

5. Selecione Android XR Support e Android XR: AR Sessions.

   Isso ativa todos os recursos e dependências compatíveis para transmissão.

   

6. Reinicie o Unity Editor para aplicar essas mudanças.

Configurar elementos gráficos e qualidade

Configure as seguintes definições para garantir a compatibilidade da transmissão:

1. Acesse Edit > Project Settings > XR Plugin Management > OpenXR.

2. Para cada uma das seguintes configurações, selecione as seguintes opções:

   • Render Mode: Multi-pass
   • Depth Submission: Depth 24 bit
   • Foveated Rendering API: Legacy

   

Realizar a validação do projeto

Realize a validação do projeto para corrigir erros do OpenXR na configuração do projeto:

1. Acesse Edit > Project Settings > XR Plug-in Management > Project Validation.
2. Clique na guia Standalone.
3. Clique em Fix All para erros com o prefixo [OpenXR].

4. Clique em Fix All para erros com o prefixo [Android XR Streaming].

   

Iniciar a prévia direta

Inicie a prévia direta para transmitir diretamente do Unity:

1. Conecte o dispositivo Android XR à máquina host usando um cabo USB-C de alta qualidade.

2. Se você nunca usou esse dispositivo com a prévia direta antes, conecte e configure o dispositivo para a prévia direta no Android XR Engine Hub antes de iniciar a prévia direta pelo mecanismo de jogo.

3. No Unity Editor, clique em Play.

   A transmissão do dispositivo é iniciada automaticamente.