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.

Використання редактора XR

У 2024 році ми представили «редактор Godot XR <https://godotengine.org/article/godot-editor-horizon-store-early-access-release/>`__, версію редактора Godot, створену для роботи на пристроях XR, що дозволяє створювати, розробляти та експортувати 2D, 3D і XR програми та ігри безпосередньо на пристрій.

Додаток можна завантажити з магазину Google Play <https://play.google.com/store/apps/details?id=org.godotengine.editor.v4>`__, магазину Meta Horizon <https://www.meta.com/experiences/godot-game-engine/7713660705416473/>`__ або зі сторінки завантаження Godot <https://godotengine.org/download/preview/>`__.

Примітка

Редактор XR знаходиться в ранньому доступі, поки ми продовжуємо вдосконалювати його. Див. Обмеження та відомі проблеми нижче.

Підтримка пристроїв XR

Наразі редактор Godot XR доступний лише для пристроїв Android XR та таких пристроїв Meta Quest з Meta Horizon OS v69 або вище:

  • Meta Quest 2

  • Meta Quest 3

  • Meta Quest 3s

  • Meta Quest Pro

Примітка

Ми працюємо над додаванням підтримки для більшої кількості пристроїв XR, включаючи пристрої PCVR.

Дозволи виконання

  • Дозвіл на доступ до всіх файлів: дозволяє редактору створювати, імпортувати та читати файли проекту з будь-якого розташування файлів на пристрої. Без цього дозволу редактор все ще працює, але має обмежений доступ до файлів і каталогів пристрою.

  • REQUEST_INSTALL_PACKAGES: дозволяє редактору встановлювати експортовані APK проекту.

  • RECORD_AUDIO: запит, коли audio/driver/enable_input налаштування проекту ввімкнено.

  • USE_SCENE (ТІЛЬКИ МЕТА): Потрібно для ввімкнення та доступу до API сцен під час запуску XR-проекту.

Поради та підказки

Введення

  • Для найкращого досвіду та високого рівня продуктивності рекомендується підключити клавіатуру та мишу Bluetooth для взаємодії з редактором XR. Редактор XR підтримує всі звичайні комбінації клавіш і зіставлення клавіш.

  • Під час взаємодії з відстеженими контролерами або відстеженими руками ви можете перемкнути редактор interface/touchscreen/enable_long_press_as_right_click налаштування для ввімкнення правої кнопки миші за допомогою тривалого натискання.

  • Під час взаємодії з відстеженими контролерами або відстеженими руками ви можете збільшити розмір смуги прокрутки за допомогою interface/touchscreen/increase_scrollbar_touch_area налаштування редактора.

Багатозадачність увімкнена Quest

  • Theatre View можна використовувати для повноекранного перегляду вікна редактора.

  • Увімкніть Seamless Multitasking, доступний у квесті Experimental Settings, щоб забезпечити можливість швидкого переходу між запущеним проектом XR і вікном редактора.

  • Під час розробки проекту, не пов’язаного з XR, піктограма програми Godot Editor забезпечить можливість перемикатися між вікном редактора та вікном відтворення, коли останнє активне, за допомогою функції меню програми Quest.

  • Під час розробки та запуску проекту XR ви можете повернути вікно редактора, виконавши такі дії:

    • Натисніть кнопку Meta, щоб відкрити панель меню

    • Натисніть піктограму редактора програми Godot, щоб викликати меню програми та виберіть плитку Вікно редактора.

Синхронізація проектів

  • Синхронізувати проекти через Git можна, завантаживши клієнт Git для Android. Ми рекомендуємо Termux terminal, емулятор терміналу Android, який надає доступ до звичайних термінальних утиліт, таких як Git і SSH.

    • Примітка. Щоб використовувати Git із терміналом Termux, вам потрібно буде надати терміналу дозвіл WRITE. Це можна зробити, запустивши таку команду з терміналу: termux-setup-storage

Плагіни

  • Плагіни GDExtension працюють належним чином, але вимагають, щоб розробник плагіна надав власні двійкові файли Android.

Обмеження та відомі проблеми

Ось відомі обмеження та проблеми редактора XR:

  • Не підтримується C#/Mono.

  • Немає підтримки зовнішніх редакторів скриптів.

  • Поки доступний, рендерер Vulkan Forward+ не рекомендується через серйозні проблеми з продуктивністю.