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.

O aplicativo pode ser baixado na Meta Horizon Store, ou na página de downloads do Godot.

Nota

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

XR devices support

Por enquanto, o editor Godot XR está disponível apenas para os seguintes dispositivos Meta Quest que executam o Meta Horizon OS v69 ou superior:

  • Meta Quest 3

  • Meta Quest 3s

  • Meta Quest Pro

Nota

Estamos trabalhando para adicionar suporte para mais dispositivos XR, incluindo dispositivos PCVR.

Runtime Permissions

  • All files access permission: Enables the editor to create, import, and read project files from any file locations on the device. Without this permission, the editor is still functional, but has limited access to the device's files and directories.

  • 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: Necessário para habilitar e acessar as APIs de cena ao executar um projeto XR.

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

  • 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 para o Meta Quest 2 devido à quantidade limitada de memória no dispositivo. No entanto, usuários avançados podem obter o APK do editor XR na página de download e instalá-lo manualmente em seus dispositivos, se desejarem.

  • Não há suporte para compilação do Gradle.

  • Não há suporte para plugins do Android, pois eles exigem suporte para compilação do Gradle. Plugins GDExtension são suportados.

  • Sem suporte a C#/Mono.

  • Sem suporte para editores de script externos.

  • While available, the Vulkan Forward+ renderer is not recommended due to severe performance issues.