Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Usando o editor XR
Em 2024, introduzimos o Godot XR editor, uma versão do editor Godot projetada para rodar nativamente em dispositivos XR, permitindo a criação, desenvolvimento e exportação de aplicativos e jogos 2D, 3D e XR diretamente no dispositivo.
O aplicativo pode ser baixado da Google Play Store, Meta Horizon Store, ou da página de download da Godot.
Nota
O editor XR está em acesso antecipado enquanto continuamos a refinar a experiência. Veja Limitações e problemas conhecidos abaixo.
Suporte a dispositivos XR
Por enquanto, o editor XR do Godot está disponível apenas para dispositivos XR Android e para os seguintes dispositivos Meta Quest executando Meta Horizon OS v69 ou superior:
Meta Quest 2
Meta Quest 3
Meta Quest 3s
Meta Quest Pro
Nota
Estamos trabalhando para adicionar suporte para mais dispositivos XR, incluindo dispositivos PCVR.
Permissões de execução
Permissão de acesso a todos os arquivos: Permite ao editor criar, importar e ler arquivos de projeto em qualquer local do dispositivo. Sem essa permissão, o editor continua funcional, mas com acesso limitado aos arquivos e diretórios do dispositivo.
REQUEST_INSTALL_PACKAGES: Permite que o editor instale APKs de projetos exportados.
RECORD_AUDIO: Requisitado quando a configuração de projeto audio/driver/enable_input está habilitada.
USE_SCENE (APENAS META): Necessária para habilitar e acessar as APIs de cena ao executar um projeto XR.
Dicas e truques
Input (Entrada)
Para a melhor experiência e um alto nível de produtividade, recomenda-se conectar um teclado e mouse bluetooth para interagir com o editor XR. O editor XR oferece suporte a todos os atalhos e mapeamentos de teclas usuais.
Ao interagir com controladores rastreados ou mãos rastreadas, você pode ativar a configuração do editor interface/touchscreen/enable_long_press_as_right_click para habilitar o clique com o botão direito por meio de um pressionamento longo.
Ao interagir com controles ou mãos rastreados, você pode aumentar o tamanho da barra de rolagem usando a configuração do editor interface/touchscreen/increase_scrollbar_touch_area.
Multi-tasking on Quest (Multitarefa no Quest)
Theater View pode ser usado para colocar a janela do Editor em modo de tela cheia.
Habilite Seamless Multitasking, disponível nas Configurações Experimentais do Quest, para permitir a transição rápida entre um projeto XR em execução e a janela do Editor.
Ao desenvolver um projeto não-XR, o ícone do aplicativo editor Godot fornecerá a capacidade de alternar entre a janela do editor e a janela de reprodução quando esta última estiver ativa, usando o recurso menu do aplicativo do Quest.
Ao desenvolver e executar um projeto XR, você pode trazer de volta a janela do Editor:
Pressionando o botão Meta para invocar a barra de menu
Clique no ícone do aplicativo editor Godot para abrir o Menu do aplicativo e selecione o bloco Janela do editor.
Sincronização de projetos
A sincronização de projetos via Git pode ser feita baixando um cliente Git para Android. Recomendamos o Termux terminal, um emulador de terminal para Android que fornece acesso a utilitários comuns de terminal, como Git e SSH.
Nota: Para usar o Git com o terminal Termux, você precisará conceder permissão de ESCRITA ao terminal. Isso pode ser feito executando o seguinte comando dentro do terminal:
termux-setup-storage
Plugins
Os plugins GDExtension funcionam conforme o esperado, mas exigem que o desenvolvedor do plugin forneça binários nativos do Android.
Limitações e problemas conhecidos
Aqui estão as limitações e problemas conhecidos do editor XR:
Sem suporte a C#/Mono.
Sem suporte para editores de script externos.
Enquanto disponível, o renderizador Vulkan Forward+ não é recomendado devido a problemas graves de desempenho.