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

Using the XR editor

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.

The app can be downloaded from the Google Play Store, Meta Horizon Store, or from the Godot download page.

Nota

The XR editor is in early access, while we continue to refine the experience. See Limitations & known issues below.

XR devices support

For now, the Godot XR editor is only available for Android XR devices, and the following Meta Quest devices running Meta Horizon OS v69 or higher:

  • 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.

Runtime Permissions

Dicas e truques

Input

  • 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 controladores rastreados ou mãos rastreadas, você pode aumentar o tamanho da barra de rolagem usando a configuração do editor interface/touchscreen/increase_scrollbar_touch_area <https://docs.godotengine.org/en/stable/classes/class_editorsettings.html#class-editorsettings-property-interface-touchscreen-increase-scrollbar-touch-area>.

Multi-tasking on 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.

Projects sync

  • 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.

Limitations & known issues

Here are the known limitations and issues of the XR editor:

  • 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.