Admin
Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉
🥈
🥇
💎
👑
🛠️
🏎️
🗺️
❤️
⚡
🏆
- Рейтинг
- 50730 pts
🖥️ Повний гайд: Створення швидких та адаптивних CEF-інтерфейсів для MTA:SA (HTML5 + Lua Bridge)
1. Створення екземпляра CEF браузера в клієнтському Lua
2. Двосторонній міст даних (Lua <-> JavaScript Bridge)
А. Передача даних з Lua в JavaScript (Оновлення балансу чи швидкості):
Б. Виклик Lua функцій зсередини JavaScript (Клік на кнопку "Купити" або "Використати предмет"):
В. Прийом події у Lua:
3. Фікс найпоширеніших проблем CEF у збірках
Більшість сучасних проектів, включаючи останні версії UKRAINE GTA, практично повністю відмовилися від громіздких стандартних GUI та малювання десятків
Framework) — браузерний рушій, вбудований безпосередньо в MTA.
Це дозволяє використовувати сучасні технології веб-розробки (HTML5, CSS Flexbox/Grid, Vue, React, TailwindCSS), анімації
dxDrawRectangle у нескінченних циклах onClientRender. Замість цього використовується CEF (Chromium Embed
Framework) — браузерний рушій, вбудований безпосередньо в MTA.Це дозволяє використовувати сучасні технології веб-розробки (HTML5, CSS Flexbox/Grid, Vue, React, TailwindCSS), анімації
transform та плавні градієнти, при цьому рендеринг повністю бере на себе відеокарта.1. Створення екземпляра CEF браузера в клієнтському Lua
Для того, щоб інтерфейс не розмивався на моніторах 2K/4K та не просідав FPS на слабких ноутбуках, важливо динамічно вираховувати роздільну здатність екрана гравця:
Код:
-- client/cef_manager.lua
local screenW, screenH = guiGetScreenSize()
local myBrowser = nil
local isBrowserReady = false
addEventHandler("onClientResourceStart", resourceRoot, function()
-- Створюємо браузер на весь екран з підтримкою прозорості (true)
myBrowser = createBrowser(screenW, screenH, true, false)
if myBrowser then
addEventHandler("onClientBrowserCreated", myBrowser, function()
-- Завантажуємо локальний HTML-файл
loadBrowserURL(myBrowser, "http://mta/my_resource/html/index.html")
end)
addEventHandler("onClientBrowserDocumentReady", myBrowser, function()
isBrowserReady = true
outputChatBox("[ZONA MTA] Інтерфейс успішно завантажено!", 0, 255, 100)
end)
end
end)
-- Рендеринг текстури браузера на екрані
addEventHandler("onClientRender", root, function()
if myBrowser and isBrowserReady then
dxDrawImage(0, 0, screenW, screenH, myBrowser, 0, 0, 0, tocolor(255, 255, 255, 255), true)
end
end)
2. Двосторонній міст даних (Lua <-> JavaScript Bridge)
Найголовніше завдання у розробці систем інвентарю, автосалонів чи спідометрів — миттєва передача даних без лагів.
А. Передача даних з Lua в JavaScript (Оновлення балансу чи швидкості):
Код:
function updateSpeedometer(speed, fuel, engineState)
if not isBrowserReady then return end
local jsCode = string.format("window.updateVehicleInfo(%d, %d, %s);",
math.floor(speed),
math.floor(fuel),
tostring(engineState)
)
executeBrowserJavascript(myBrowser, jsCode)
end
Б. Виклик Lua функцій зсередини JavaScript (Клік на кнопку "Купити" або "Використати предмет"):
JavaScript:
// html/app.js
function onBuyItemClick(itemId, amount) {
if (typeof mta !== 'undefined') {
mta.triggerEvent('onClientBuyItemFromCEF', itemId, amount);
}
}
В. Прийом події у Lua:
Код:
addEvent("onClientBuyItemFromCEF", true)
addEventHandler("onClientBuyItemFromCEF", root, function(itemId, amount)
triggerServerEvent("onServerProcessPurchase", resourceRoot, localPlayer, itemId, amount)
end)
3. Фікс найпоширеніших проблем CEF у збірках
- Блокування клавіатури (Неможливо рухатися після закриття вікна): Обов'язково використовуйте
guiSetInputMode("no_binds_when_editing")при відкритті інпутів таguiSetInputMode("allow_binds")при закритті. - Витік пам'яті (Memory Leak): Якщо ховаєте інтерфейс, не перестворюйте
createBrowserщоразу! Просто сховайте рендер або додайте клас.hiddenу CSS. - Білий екран (White screen): Перевірте шлях у
meta.xml— всі файли html, css, js, зображення та шрифти обов'язково повинні мати прапорець<file src="html/..." />.
💡 Маєте запитання по архітектурі CEF? Задавайте питання нижче в темі, розберемо будь-яку проблему чи фрагмент коду!