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

Utilizzare l'editor XR

Nel 2024 abbiamo introdotto l'editor Godot XR, una versione dell'editor Godot progettata per funzionare nativamente sui dispositivi XR, consentendo la creazione, lo sviluppo e l'esportazione di app e giochi 2D, 3D e XR direttamente sul dispositivo.

L'app si può scaricare dal Google Play Store, dal Meta Horizon Store <https://www.meta.com/experiences/godot-game-engine/7713660705416473/>`__, oppure dalla pagina di download di Godot.

Nota

L'editor XR è in accesso anticipato, mentre continuiamo a perfezionarne l'esperienza. Consultare Limitazioni e problemi noti in seguito.

Supporto per dispositivi XR

Per ora, l'editor Godot XR è disponibile solo per i dispositivi Android XR, e i seguenti dispositivi Meta Quest , con Meta Horizon OS v69 o versione successiva:

• Meta Quest 2

• Meta Quest 3

• Meta Quest 3s

• Meta Quest Pro

Nota

Stiamo lavorando per aggiungere il supporto per più dispositivi XR, compresi i dispositivi PCVR.

Permessi in fase di esecuzione

• Autorizzazione di accesso a tutti i file: permette all'editor di creare, importare e leggere file di progetto da qualsiasi posizione sul dispositivo. Senza questa autorizzazione, l'editor è comunque funzionante, ma ha accesso limitato ai file e alle cartelle del dispositivo.

• REQUEST_INSTALL_PACKAGES: permette all'editor di installare gli APK del progetto esportato.

• RECORD_AUDIO: Richiesto quando l'impostazione del progetto audio/driver/enable_input è abilitata.

• USE_SCENE (SOLO META): Richiesto per abilitare e accedere alle API di scena durante l'esecuzione di un progetto XR.

Consigli e trucchi

Input

• Per un'esperienza ottimale e un alto livello di produttività, si consiglia di collegare una tastiera e un mouse Bluetooth per interagire con l'editor XR. L'editor XR supporta tutte le scorciatoie e le mappature dei tasti più comuni.

• Quando si interagisce con controller tracciati o mani tracciate, è possibile attivare l'impostazione dell'editor interface/touchscreen/enable_long_press_as_right_click per abilitare il clic destro tramite pressione prolungata.

• Quando si interagisce con controller tracciati o mani tracciate, è possibile aumentare le dimensioni della barra di scorrimento attraverso l'impostazione dell'editor interface/touchscreen/increase_scrollbar_touch_area.

Multi-tasking su Quest

• Theater View si può utilizzare per mostrare a schermo intero la Finestra dell'editor.

• Abilita Seamless Multitasking, disponibile nelle Impostazioni sperimentali di Quest, per abilitare la possibilità di passare rapidamente tra un progetto XR in esecuzione e la Finestra dell'editor.

• Durante lo sviluppo di un progetto non XR, l'icona dell'app dell'editor Godot consentirà di passare dalla Finestra dell'editor alla Finestra di gioco quando quest'ultima è attiva, attraverso la funzionalità App menu di Quest.

• Durante lo sviluppo e l'esecuzione di un progetto XR, è possibile ripristinare la Finestra dell'editor nei seguenti modi:

  • Premendo il pulsante Meta per invocare la barra di menu

  • Cliccando sull'icona dell'app del Godot Editor per invocare l'App menu e selezionare il riquadro Finestra dell'editor.

Sincronizzazione dei progetti

• Per sincronizzare progetti tramite Git, si può scaricare un client Git per Android. Consigliamo il terminal Termux, un emulatore di terminale Android che fornisce accesso a utilità comuni di terminale come Git e SSH.

  • Nota: Per utilizzare Git con il terminale Termux, è necessario concedere il permesso WRITE al terminale. Ciò si può fare eseguendo il seguente comando <https://wiki.termux.com/wiki/Termux-setup-storage>`__ dal terminale: ``termux-setup-storage

Estensioni

• Le estensioni GDExtension funzionano come previsto, ma richiedono che lo sviluppatore dell'estensione fornisca i binari nativi per Android.

Limitazioni e problemi noti

Ecco le limitazioni e i problemi noti dell'editor XR:

• Nessun supporto per C#/Mono.

• Nessun supporto per editor di script esterni.

• Sebbene disponibile, il renderer Vulkan Forward+ non è consigliato a causa di severi problemi di prestazioni.