Configuração do projeto do Godot Engine

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Saiba mais sobre esses dispositivos →
Headsets XR
Óculos XR com fio
Saiba mais sobre esses dispositivos →

Este guia detalha as versões recomendadas do mecanismo, os SDKs necessários e as configurações do projeto Android ao desenvolver um app do Godot Engine para Android XR.

Pré-requisitos

Antes de configurar um projeto do Godot Engine para desenvolvimento de Android XR, você precisa atender aos seguintes pré-requisitos:

  1. Faça o download do Godot 4.6.2 no site oficial do Godot.
  2. Verifique se você tem um headset XR ou óculos XR.
  3. Instale o Android Studio.

Instalar o suporte para build do Android

O Godot requer ferramentas de build do Android específicas para compilar e exportar pacotes para computação espacial.

  1. No Android Studio, use o SDK Manager para instalar os seguintes pacotes e ferramentas:

    • SDK do Android Platform: Android 14.0 ("UpsideDownCake") (nível 34 da API)
    • SDK do Android Build-Tools: versão 34.0.0 ou mais recente
    • NDK: qualquer versão 28.x
    • CMake: versão 3.10.2

    Talvez seja necessário selecionar Mostrar detalhes do pacote no SDK Manager para ver todas as versões disponíveis de uma ferramenta.

  2. No Godot, acesse Editor > Editor Settings > Export > Android e forneça o caminho para o SDK.

Criar um projeto do Godot XR

Configure um novo projeto para renderização espacial:

  1. Abra o Godot e crie um projeto.

  2. Em Renderizador, selecione Dispositivos móveis.

    Essa é a API gráfica de alto desempenho e com prioridade para Vulkan recomendada para Android XR.

    Caixa de diálogo "Criar novo projeto" no Godot Engine.

  3. Selecione outras opções e clique em Criar.

  4. Construa sua cena XR interna (incluindo XROrigin3D e XRCamera3D) usando o Guia oficial de configuração de cena XR do Godot.

    Construa sua cena de RV interna no novo projeto do Godot

Definir configurações do projeto

Em seguida, configure as definições do projeto para ativar o OpenXR e o pipeline de renderização para desempenho em dispositivos móveis:

  1. Abra o Godot.
  2. Configure as seguintes configurações de projeto para o OpenXR:
    • Acesse Project > Project Settings > XR > OpenXR e selecione Enabled.
    • Acesse Project > Project Settings > XR > Shaders e selecione Enabled.

  3. Acesse Renderização > Anti-aliasing > Qualidade > MSAA 3D e selecione 4x.

    Essa configuração oferece a melhor clareza no Android XR.

Configurar o projeto para exportar para o Android XR

Conclua as etapas a seguir para configurar seu projeto e exportar para o Android XR:

  1. Configurar uma predefinição de exportação: acesse Projeto > Exportar e clique em Adicionar... > Android.

  2. Conclua o guia de implantação: siga o guia oficial de implantação do Android do Godot para instruções detalhadas sobre permissões e implantação com um clique.

  3. Verifique as versões do SDK do seu projeto:

    • Para o SDK mínimo: 34
    • Para o SDK de destino: 34

  4. Configurar o modo XR: defina o Modo XR como OpenXR nas configurações de exportação.

Instalar o plug-in OpenXR Vendors do Godot

Seu app precisa usar o plug-in Vendors para acessar extensões específicas do Android XR. Siga estas etapas para ter uma versão compatível:

  1. No Godot, selecione AssetLib.

  2. Pesquise "Fornecedor".

    Encontre diferentes versões do plug-in Godot OpenXR Vendors pesquisando na Biblioteca de recursos do Godot.

  3. Encontre e baixe a versão 5.1 (ou mais recente) do plug-in Godot OpenXR Vendors.

  4. Quando o download terminar, selecione Instalar.

    Instalar o plug-in Godot OpenXR Vendors

Consulte também

Para mais informações sobre o desenvolvimento do Android XR com o Godot, consulte as seguintes páginas na documentação do Godot Engine: