Configuração do projeto do Unity

Dispositivos XR relevantes

Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.

Saiba mais sobre tipos de dispositivos XR →

Headsets XR

Óculos XR com fio

Saiba mais sobre esses dispositivos →

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 Android ao desenvolver um aplicativo Unity para Android XR.

Pré-requisitos

Para desenvolver com o Unity, é necessário fazer o download e instalar o Unity Hub.

Instale a versão 6000.0.58f2 ou mais recente do Unity Editor e do Android Build Support, que inclui:

• OpenJDK
• SDK do Android
• Ferramentas do NDK do Android

Selecionar um mecanismo de renderização

Recomendamos o uso da API Vulkan Graphics para renderizar apps Android XR. Para selecionar o Vulkan como sua API Graphics, siga estas etapas:

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

4. Na seção Graphics APIs, selecione o botão Add (+) e escolha Vulkan no menu suspenso.

   

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

6. Opcionalmente, selecione outras APIs Graphics e clique no botão Remove (-) 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 a passagem, atualize as configurações padrão do URP para ter o melhor desempenho de passagem no Android XR.

**Observação** :para projetos atuais com recursos feitos para o Pipeline de Renderização Integrado, use o conversor de pipeline de renderização para converter esses recursos para que sejam compatíveis com o URP.

A tabela a seguir tem uma lista das configurações recomendadas do URP do Unity, que são explicadas com 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

Observação: o Vulkan é necessário se você estiver usando o URP. Recomendamos o uso do Vulkan como API Graphics para Android XR, já que os recursos gráficos mais recentes são compatíveis apenas com essa API.

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 recurso do Pipeline de Renderização Universal do seu projeto. Uma maneira de fazer isso é digitar t:UniversalRenderPipelineAsset na barra de pesquisa da janela Project.

   **Observação** :se o projeto não contiver um recurso do Pipeline de Renderização Universal, consulte Como instalar o Pipeline de Renderização Universal em um projeto atual na documentação do URP.

2. No cabeçalho Quality, desative HDR.

   

Configurações de dados do renderizador universal

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

1. Localize o recurso de dados do renderizador universal do seu projeto. Uma maneira de fazer isso é digitar t:UniversalRendererData na barra de pesquisa da janela Project.

2. No Inspector, no cabeçalho Post-processing, desmarque Enabled.

   

Nível mínimo da API Android

Defina o projeto para um nível mínimo da API de 24, que é exigido pelo carregador OpenXR. Caso contrário, as builds poderão falhar.

Conclua estas etapas para definir o nível mínimo da API Android.

1. Acesse Edit > Project Settings > Player.
2. Selecione a guia Android e abra Other Settings.
3. Na seção Identification, para Minimal API level, selecione 24 ou mais.

Ponto de entrada do aplicativo

Defina as configurações a seguir para o ponto de entrada do aplicativo:

1. Acesse Edit > Project Settings > Player.
2. Selecione a guia Android e abra Other Settings.
3. Na seção Configuration, verifique se Application Entry Point tem GameActivity marcado e Activity desmarcado.

Caixas de diálogo

A maioria dos apps Android XR exige janelas redimensionáveis, já que elas são necessárias para renderizar caixas de diálogo, como solicitações de permissão do sistema.

Siga estas etapas para garantir que as caixas de diálogo sejam renderizadas corretamente.

1. Acesse Edit > Project Settings > Player.
2. Selecione a guia Android e abra Resolution and Presentation
3. Na seção Resolution, ative Resizeable Activity.

Consulte também

• Android XR do Unity: OpenXR
• Importar extensões do Android XR para Unity

---

OpenXR™ e o logotipo OpenXR são marcas registradas de propriedade da Khronos Group Inc. e estão registradas como marcas comerciais na China, na União Europeia, no Japão e no Reino Unido.