Configuração do projeto do Unity

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 ou mais recente do Unity Editor e do 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:

  1. No Unity, acesse Edit > Project Settings > Player.
  2. Selecione a guia Android e navegue até Outras configurações > Renderização.
  3. Se a API Auto Graphics estiver ativada, desative essa configuração para revelar a seção APIs Graphics.

  4. Na seção APIs gráficas, selecione o botão Adicionar (+) e selecione Vulkan no menu suspenso.

    Exemplo mostrando como mudar as configurações da API Graphics na interface

  5. Reordene as APIs gráficas usando os identificadores (=) para que o Vulkan seja listado primeiro.

  6. 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:

  1. Localize o Universal Render Pipeline Asset do seu projeto. Uma maneira de fazer isso é digitar t:UniversalRenderPipelineAsset na barra de pesquisa da janela Project.

  2. No cabeçalho Qualidade, desative HDR.

    Recurso do pipeline de renderização universal mostrado com as configurações recomendadas

Configurações de dados do renderizador universal

Siga estas etapas para otimizar os dados do renderizador universal para Android XR:

  1. Localize o Universal Renderer Data Asset do seu projeto. Uma maneira de fazer isso é digitar t:UniversalRendererData na barra de pesquisa da janela Project.

  2. No Inspector, em Post-processing, desmarque a opção Enabled.

    Dados do renderizador universal mostrados com as configurações recomendadas

Nível mínimo da API do 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.

  1. Acesse Editar > Configurações do projeto > Player.
  2. Selecione a guia "Android" e abra Outras configurações.
  3. 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:

  1. Acesse Editar > Configurações do projeto > Player.
  2. Selecione a guia Android e abra Outras configurações.
  3. 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 são necessárias para renderizar pop-ups, como solicitações de permissão do sistema.

Siga estas etapas para garantir que as janelas pop-up sejam renderizadas corretamente.

  1. Acesse Editar > Configurações do projeto > Player.
  2. Selecione a guia Android e ative a opção Resizeable Activity.

Veja também