Este guia detalha as versões recomendadas do editor, as configurações de gráficos, as configurações do URP e as configurações do projeto do Android ao desenvolver um aplicativo Unity para Android XR.
Pré-requisitos
Para desenvolver com o Unity, você precisa fazer o download e instalar o Unity Hub.
Instale a versão 6000.0.23f1 do Unity Editor e o Android Build Support, que inclui:
- OpenJDK
- SDK do Android
- Ferramentas do Android NDK
Selecionar um mecanismo de renderização
Recomendamos o uso da API Vulkan Graphics para renderizar apps Android XR. Para selecionar a Vulkan como sua API de gráficos, siga estas etapas:
- No Unity, acesse Edit > Project Settings > Player.
- Selecione a guia Android e navegue até Outras configurações > Renderização.
- Se a API Auto Graphics estiver ativada, desative essa configuração para revelar a seção APIs Graphics.
Na seção APIs gráficas, selecione o botão Adicionar (+) e selecione Vulkan no menu suspenso.
Reordene as APIs gráficas usando os identificadores (=) para que o Vulkan seja listado primeiro.
Opcionalmente, selecione outras APIs Graphics e clique no botão Remover (-) para removê-las.
Pipeline de Renderização Universal
O Android XR é compatível com o Pipeline de Renderização Universal (URP, na sigla em inglês). Se você planeja usar o passthrough, atualize as configurações padrão do URP para ter a melhor performance de passthrough no Android XR.
A tabela a seguir tem uma lista das configurações recomendadas do URP do Unity, que são explicadas em mais detalhes nas seções a seguir.
Configuração |
Local |
Valor recomendado |
---|---|---|
HDR |
Recurso do pipeline de renderização universal |
Desativado |
Pós-processamento |
Dados do renderizador universal |
Desativado |
Configurações de recursos do pipeline de renderização universal
Siga estas etapas para otimizar o recurso do pipeline de renderização universal para Android XR:
Localize o Universal Render Pipeline Asset do seu projeto. Uma maneira de fazer isso é digitar
t:UniversalRenderPipelineAsset
na barra de pesquisa da janela Project.No cabeçalho Qualidade, desative a opção HDR.
Configurações de dados do renderizador universal
Siga estas etapas para otimizar os dados do renderizador universal para Android XR:
Localize o ativo de dados do renderizador universal do seu projeto. Uma maneira de fazer isso é digitar
t:UniversalRendererData
na barra de pesquisa da janela Project.No Inspector, em Post-processing, desmarque a caixa de seleção Enabled.
Nível mínimo da API Android
Defina o projeto para um nível mínimo de API de 24, que é necessário pelo carregador OpenXR. Caso contrário, seus builds podem falhar.
Siga estas etapas para definir o nível mínimo da API do Android.
- Acesse Editar > Configurações do projeto > Player.
- Selecione a guia "Android" e abra Outras configurações.
- Na seção Identification, para Minimal API level, selecione 24 ou mais recente.
Ponto de entrada do aplicativo
Defina as seguintes configurações para o ponto de entrada do aplicativo:
- Acesse Editar > Configurações do projeto > Player.
- Selecione a guia Android e abra Outras configurações.
- Na seção Application Entry Point, verifique se GameActivity está marcado e Activity está desmarcado.
Janelas pop-up
A maioria dos apps Android XR exige janelas redimensionáveis, já que elas precisam renderizar pop-ups, como solicitações de permissão do sistema.
Siga estas etapas para garantir que as janelas pop-up sejam renderizadas corretamente.
- Acesse Editar > Configurações do projeto > Player.
- Selecione a guia Android e ative a opção Resizeable Activity.