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...
JavaScriptBridge
Успадковує: Object
Однотон, який з'єднує двигун з JavaScript-інтерфейсом браузера в Інтернеті.
Опис
Сінглтон JavaScriptBridge реалізований тільки в експорті Web. Він використовується для доступу до контексту JavaScript браузера. Це дозволяє взаємодіяти з вбудованими сторінками або викликати сторонні API JavaScript.
Примітка: Цей синглтон можна вимкнути під час компіляції для підвищення безпеки. За замовчуванням синглтон JavaScriptBridge увімкнено. В офіційних шаблонах експорту також увімкнено синглтон JavaScriptBridge. Докладнішу інформацію див. у розділі Компіляція для веб-сайтів документації.
Посібники
Методи
create_callback(callable: Callable) |
|
Variant |
create_object(object: String, ...) vararg |
void |
download_buffer(buffer: PackedByteArray, name: String, mime: String = "application/octet-stream") |
Variant |
eval(code: String, use_global_execution_context: bool = false) |
void |
|
get_interface(interface: String) |
|
is_js_buffer(javascript_object: JavaScriptObject) |
|
PackedByteArray |
js_buffer_to_packed_byte_array(javascript_buffer: JavaScriptObject) |
pwa_needs_update() const |
|
Сигнали
pwa_update_available() 🔗
Увімкнено, коли було виявлено оновлення цього прогресивного веб-застосунку, але очікується, що попередній варіант активний. Див. pwa_update(), щоб змусити оновлення відбуватися негайно.
Описи методів
JavaScriptObject create_callback(callable: Callable) 🔗
Створює посилання на Callable, який може використовуватися як зворотний виклик JavaScript. Посилання має зберігатися, доки не відбудеться зворотний виклик, інакше воно не буде викликано взагалі. Перегляньте JavaScriptObject для використання.
Примітка. Функція зворотного виклику має приймати рівно один аргумент Array, який буде об’єктом аргументів JavaScript, перетвореним на масив.
Variant create_object(object: String, ...) vararg 🔗
Створення нового об'єкту JavaScript за допомогою конструктора `` i . ``window. Див. JavaScriptObject для використання.
void download_buffer(buffer: PackedByteArray, name: String, mime: String = "application/octet-stream") 🔗
Проконсультує користувача для завантаження файлу, що містить зазначений buffer. Файл буде надана name і mime тип.
Примітка: Веб-сайт: http://en.wikipedia.org/wiki/Media_type]MIME type/url надана на основі файлу name.
Примітка: Браузери можуть блокувати завантаження, якщо download_buffer() не називаються з взаємодії користувача (наприклад, кнопка натисніть кнопку).
Примітка: Браузери можуть попросити користувача дозвіл або заблокувати завантаження, якщо кілька запитів для завантаження зроблені в швидкому успіху.
Variant eval(code: String, use_global_execution_context: bool = false) 🔗
Виконувати рядок code як JavaScript-код у вікні браузера. Зателефонуйте до реальної глобальної функції JavaScript eval().
Якщо use_global_execution_context є true, код буде оцінювати в умовах глобального виконання. В іншому випадку він оцінюється в контексті виконання функції в умовах пускового середовища двигуна.
void force_fs_sync() 🔗
Синхронізація стійкості файлової системи (при включенні).
Примітка: Це тільки корисний для модулів або розширення, які не можуть використовуватися FileAccess для запису файлів.
JavaScriptObject get_interface(interface: String) 🔗
Повертаємо інтерфейс на об'єкт JavaScript, який можна використовувати за допомогою скриптів. window. Зворотній зв'язок повинен прийняти один аргумент Array, який міститиме JavaScript arguments. Див. JavaScriptObject для використання.
bool is_js_buffer(javascript_object: JavaScriptObject) 🔗
Returns true if the given javascript_object is of type ArrayBuffer, DataView, or one of the many typed array objects.
PackedByteArray js_buffer_to_packed_byte_array(javascript_buffer: JavaScriptObject) 🔗
Повертає копію вмісту javascript_buffer як PackedByteArray. Дивіться також is_js_buffer().
bool pwa_needs_update() const 🔗
Повернення true, якщо активується нова версія прогресивного веб-застосунку.
Примітка: Тільки актуальні при експорті як прогресивний веб-додаток.
Виконує оновлення веб-застосунку. Здійснення нової версії, яка буде встановлена, і сторінка буде перевантажена.
Примітка: Ваше додаток буде **завантажено в усіх браузерах **.
Примітка: Тільки актуально при експорті як прогресивний веб-додаток і pwa_needs_update() повертає true.