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.

GDExtensionManager

Успадковує: Object

Забезпечує доступ до функцій GDExtension.

Опис

GDExtensionManager навантажень, ініціалізує та відстежує всі доступні бібліотеки GDExtension.

Примітка: Не хвилюйтеся про GDExtension, якщо ви знаєте, що ви робите.

Посібники

Методи

GDExtension

get_extension(path: String)

PackedStringArray

get_loaded_extensions() const

bool

is_extension_loaded(path: String) const

LoadStatus

load_extension(path: String)

LoadStatus

load_extension_from_function(path: String, init_func: const GDExtensionInitializationFunction*)

LoadStatus

reload_extension(path: String)

LoadStatus

unload_extension(path: String)


Сигнали

extension_loaded(extension: GDExtension) 🔗

Видається після того, як редактор завершив завантаження нового розширення.

Примітка. Цей сигнал видається лише у збірках редактора.


extension_unloading(extension: GDExtension) 🔗

Видається перед тим, як редактор починає вивантажувати розширення.

Примітка. Цей сигнал видається лише у збірках редактора.


extensions_reloaded() 🔗

Після того, як редактор закінчив перевантаження одного або декількох розширень.


Переліки

enum LoadStatus: 🔗

LoadStatus LOAD_STATUS_OK = 0

Подовжувач успішно завантажив.

LoadStatus LOAD_STATUS_FAILED = 1

Подовжувач не вдалося завантажити, можливо, оскільки він не існує або не має ніяких залежностей.

LoadStatus LOAD_STATUS_ALREADY_LOADED = 2

Розширення вже було завантажено.

LoadStatus LOAD_STATUS_NOT_LOADED = 3

Розширення не завантажується.

LoadStatus LOAD_STATUS_NEEDS_RESTART = 4

Подовжувач вимагає застосування для перезавантаження повністю.


Описи методів

GDExtension get_extension(path: String) 🔗

Повертаємо GDExtension на вказаному файлі path, або null, якщо він не був завантажений або не існує.


PackedStringArray get_loaded_extensions() const 🔗

Повертаємо шлях до файлів всіх, які в даний час завантажені розширення.


bool is_extension_loaded(path: String) const 🔗

Повертає true, якщо розширення в даному файлі path уже успішно завантажено. Дивіться також get_loaded_extensions().


LoadStatus load_extension(path: String) 🔗

Завантажує розширення за абсолютним шляхом до файлу. path має вказувати на коректне значення GDExtension. У разі успіху повертає LOAD_STATUS_OK.


LoadStatus load_extension_from_function(path: String, init_func: const GDExtensionInitializationFunction*) 🔗

Завантажує розширення, яке вже знаходиться в адресному просторі, через заданий шлях та функцію ініціалізації. path має бути унікальним та починатися з "libgodot://". Повертає LOAD_STATUS_OK у разі успіху.


LoadStatus reload_extension(path: String) 🔗

Перезавантажує розширення за вказаним шляхом до файлу. path має вказувати на коректне значення GDExtension, інакше цей метод може повернути або LOAD_STATUS_NOT_LOADED, або LOAD_STATUS_FAILED.

Примітка: Ви можете перезавантажувати розширення лише в редакторі. У релізних збірках цей метод завжди завершується невдачею та повертає LOAD_STATUS_FAILED.


LoadStatus unload_extension(path: String) 🔗

Вивантажує розширення за допомогою файлової доріжки. Параметр шляху повинен вказувати на вже завантажені GDExtension, інакше цей метод повертає LOAD_STATUS_NOT_LOADED.