23 посетителя на сайте. Из них:
Пользователи8
Роботы15
Список пользователей
Михаил Tankist Сейчас на сайте
Кен Канеки Сейчас на сайте
Марк Игоревич Сейчас на сайте
ARSKY Сейчас на сайте
ranel Сейчас на сайте
destroy Сейчас на сайте
Bozestvennyy Sportik Сейчас на сайте
Егор Бучин Сейчас на сайте
Danya Shedoy Был(a) в сети 5 минут назад
Demon Был(a) в сети 7 минут назад
Виктор Викторович Был(a) в сети 9 минут назад
Donni Garcia Был(a) в сети 16 минут назад
Fhx Был(a) в сети 17 минут назад
Митя Кулешов Был(a) в сети 18 минут назад
Сеня Был(a) в сети 19 минут назад
Casa De Memuri Был(a) в сети 19 минут назад
HACK HOST Был(a) в сети 19 минут назад
James_ LP Был(a) в сети 26 минут назад
ЛЕГУШКА Был(a) в сети 28 минут назад
Анатолий Бандит Был(a) в сети 28 минут назад
Михаил Калашнеков Был(a) в сети 32 минуты назад
Bakli Был(a) в сети 35 минут назад
Владислав Семиохин Был(a) в сети 37 минут назад
Герман Канаев Был(a) в сети 39 минут назад
Vanek Kurnikov Был(a) в сети 41 минуту назад
Малик Чагиев Был(a) в сети 43 минуты назад
Моноло Монолонский Был(a) в сети 47 минут назад
Илья Дьяков Был(a) в сети 48 минут назад
Дмитрий Праведный Был(a) в сети 53 минуты назад
Sergo MSK Был(a) в сети 58 минут назад
Кирил Был(a) в сети 1 час назад
Ami Standoff Был(a) в сети 1 час назад
Pablo01 Был(a) в сети 1 час назад
Иван Был(a) в сети 1 час назад
НАБЛЮДАТЕЛЬ ВАС Был(a) в сети 1 час назад
Николо Алиев Был(a) в сети 1 час назад
WiseBear Был(a) в сети 2 часа назад
Галина Чупрова Был(a) в сети 2 часа назад
Accidentally Был(a) в сети 2 часа назад
BORZ Был(a) в сети 2 часа назад
موشالوف فاديم Был(a) в сети 2 часа назад
Platon Seven Был(a) в сети 2 часа назад
Штеркель Ростислав Был(a) в сети 2 часа назад
Duma 𖦏 Был(a) в сети 2 часа назад
24kvan Был(a) в сети 2 часа назад
Rob Xachatryan Был(a) в сети 2 часа назад
Крысурсы Был(a) в сети 2 часа назад
db9vol Был(a) в сети 2 часа назад
weaxlez Был(a) в сети 2 часа назад
Matrix Z Был(a) в сети 2 часа назад
Алексей Соколовский Был(a) в сети 3 часа назад
Cody McLaren Был(a) в сети 3 часа назад
Ооо Оооо Был(a) в сети 3 часа назад
Elhan Был(a) в сети 3 часа назад
TOKSYCHNIE Был(a) в сети 3 часа назад
SkeletON a Был(a) в сети 3 часа назад
Hyundai Accent Был(a) в сети 3 часа назад
Слава Асбест Был(a) в сети 3 часа назад
glower01 Был(a) в сети 3 часа назад
NEXTRP MUSIC Был(a) в сети 3 часа назад
Никита Всяченков Был(a) в сети 3 часа назад
Адам Барбанаков Был(a) в сети 3 часа назад
Vladislav Tsepaev Был(a) в сети 4 часа назад
Lyuca Game Был(a) в сети 4 часа назад
Delmaff Official Был(a) в сети 4 часа назад
Олег Тимофеев Был(a) в сети 4 часа назад
Анастасия Матина Был(a) в сети 4 часа назад
Кто я? Был(a) в сети 4 часа назад
Алексей Алексей Был(a) в сети 4 часа назад
Михаил Безроднев Был(a) в сети 4 часа назад
Роллан Суфьянов Был(a) в сети 5 часов назад
Был(a) в сети 5 часов назад
Матвей Топорков Был(a) в сети 5 часов назад
ДЕН ПОП Был(a) в сети 5 часов назад
Сергей Литвинов Был(a) в сети 5 часов назад
Angel Darkneta Был(a) в сети 5 часов назад
TONI OWNPONI Был(a) в сети 5 часов назад
qwe we Был(a) в сети 5 часов назад
Rise Play Был(a) в сети 5 часов назад
Fabio Bruno Был(a) в сети 5 часов назад
Padure 23 Был(a) в сети 5 часов назад
Был(a) в сети 5 часов назад
Наталья Артемова Был(a) в сети 5 часов назад
Divertidos W.l Был(a) в сети 5 часов назад
#HEX Был(a) в сети 6 часов назад
Vvvv Gghh Был(a) в сети 6 часов назад
Edgar1998 Был(a) в сети 6 часов назад
Suleyman Çakir Был(a) в сети 6 часов назад
Bektur Sairamgaliuly Был(a) в сети 6 часов назад
_Mishka _Tsyurniak_ Был(a) в сети 6 часов назад
ilsaf pro 2 hasanov Был(a) в сети 6 часов назад
Егор Лукичев Был(a) в сети 7 часов назад
XoxoL Был(a) в сети 7 часов назад
Артем Швець Был(a) в сети 7 часов назад
@lex Был(a) в сети 7 часов назад
Николай Мат Был(a) в сети 7 часов назад
Ayxan Elesgerov Был(a) в сети 7 часов назад
Руслан Чумаков Был(a) в сети 7 часов назад
денис гаранин Был(a) в сети 7 часов назад
Oleg Okshunavi Был(a) в сети 8 часов назад
NightKill Был(a) в сети 8 часов назад
Ab Antonian Был(a) в сети 8 часов назад
FARGATTOV Был(a) в сети 8 часов назад
Sharing Был(a) в сети 8 часов назад
Роман Был(a) в сети 8 часов назад
Назар Семка Был(a) в сети 8 часов назад
Кирилл Был(a) в сети 9 часов назад
Сергей Шемет Был(a) в сети 9 часов назад
Эрвин Был(a) в сети 10 часов назад
Алексей Был(a) в сети 10 часов назад
0987654321 Был(a) в сети 10 часов назад
Артём Груздов Был(a) в сети 10 часов назад
Nikita Vladimirov Был(a) в сети 10 часов назад
JHjhj Был(a) в сети 11 часов назад
SIDUKOV Был(a) в сети 11 часов назад
Евгений Дарков Был(a) в сети 11 часов назад
Sergiyko Был(a) в сети 12 часов назад
Memphis Memphis Был(a) в сети 12 часов назад
🥷 Был(a) в сети 12 часов назад
Juan Был(a) в сети 12 часов назад
SabirQasim Mahmudzade Был(a) в сети 12 часов назад
Сергей Песков Был(a) в сети 12 часов назад
MAYOROV Был(a) в сети 13 часов назад
HepBHblu Был(a) в сети 13 часов назад
Vlad Был(a) в сети 13 часов назад
Oliver RP Был(a) в сети 13 часов назад
MafiaNawiadyPL Был(a) в сети 14 часов назад
RedSuns Был(a) в сети 14 часов назад
Павел Почекуев Был(a) в сети 15 часов назад
Mr Provaider Был(a) в сети 15 часов назад
nemcovemail Был(a) в сети 15 часов назад
Hamza Kane Был(a) в сети 16 часов назад
Игорь Брянский Был(a) в сети 16 часов назад
Денис Был(a) в сети 17 часов назад
Был(a) в сети 17 часов назад
David Был(a) в сети 17 часов назад
Andruha Soprano Был(a) в сети 18 часов назад
Данила Мурзанаев Был(a) в сети 18 часов назад
Данил Гавриш Был(a) в сети 18 часов назад
ooes Был(a) в сети 18 часов назад
ztka zrei Был(a) в сети 18 часов назад
sadas asdasdsad Был(a) в сети 18 часов назад
Ага Бабаев Был(a) в сети 19 часов назад
Семëн Ханьков Был(a) в сети 19 часов назад
ЦУЦ УЦК Был(a) в сети 19 часов назад
ExE R Был(a) в сети 19 часов назад
Владислав Дронов Был(a) в сети 20 часов назад
Ярослав Кутишевский Был(a) в сети 20 часов назад
Павел Евдокимов Был(a) в сети 20 часов назад
Роман Римар Был(a) в сети 21 час назад
로맨틱 바디크 Был(a) в сети 21 час назад
данил бро Был(a) в сети 21 час назад
Miri Miriyew Был(a) в сети 21 час назад
Makeshov Был(a) в сети 21 час назад
Кирилл Милюхин Был(a) в сети 21 час назад
SHVED Был(a) в сети 21 час назад
Список ботов
rambler (15)

Следите за нами!

Введение в скриптинг GUI

Описание

Одной из важных особенностей MTA:SA является возможность программирования настраиваемого GUI (Graphic User Interface, графического интерфейса пользователя). GUI состоит из окон, кнопок, редактируемых полей, флажков... Практически всех стандартных компонентов для заполнения форм в графических средах. Они могут отображаться пока пользователь в игре и используются для ввода и вывода вместо привычных команд чата.

Руководство по созданию окна авторизации

В этом руководстве мы сделаем простое окно запроса логина с двумя полями для ввода и одной кнопкой. Окно будет появляться при подключении игрока к серверу, а по нажатии на кнопку он заспавнится. Руководство продолжит мод, созданный нами во введении в скриптинг(Если вы пользовались введением в скриптинг, вам понадобится убрать или закомментировать в коде строчку со spawnPlayer в функции "joinHandler", так как в данном руководстве мы заменим ее альтернативой с gui). Мы также ознакомимся со скриптингом на клиентской стороне.

Отрисовка окна

Все GUI обязательно делаются на клиентской стороне. Это также может являться хорошей практикой хранения всех клиентских скриптов в отдельной папке.

Переместитесь в директорию /ваш MTA Server/mods/deathmatch/resources/myserver/ и создайте папку с названием "client". В директории /client/ создайте текстовый файл и назовите его "gui.lua".

В этом файле мы напишем функцию, которая будет отрисовывать окно. Для создания окна мы воспользуемся guiCreateWindow:

function createLoginWindow()
    -- определяем позиции окна по осям X и Y
    local X = 0.375
    local Y = 0.375
    -- объявляем ширину и высоту окна
    local Width = 0.25
    local Height = 0.25
    -- создаем окно и сохраняем значение его элемента в переменной 'wdwLogin'
    -- кликаем по имени функции, чтобы прочитать ее документацию
    wdwLogin = guiCreateWindow(X, Y, Width, Height, "Пожалуйста, залогиньтесь", true)
end

Относительные и абсолютные

Заметьте, что последний аргумент, передаваемый guiCreateWindow в образце выше, true. Это говорит о том, что координаты и габариты окна - относительны, значит, измеряются в процентах от всего размера экрана. То есть если верхний левый угол экрана - это 0, а верхний правый - это 1, то позиция 0.5 по оси X является центром экрана по горизонтали. Аналогично этому, если вершина экрана - это 0, а низ - это 1, то позиция 0.2 по оси Y будет отступом на 20% всей высоты от верхней границы экрана. Те же принципы применимы к ширине и высоте (при Width, равной 0.5, окно будет шириной с пол-экрана).

Альтернативно использованию относительных значений, можно использовать абсолютные (указав false вместо true в guiCreateWindow). Абсолютные значения вычисляются как конкретное количество пикселей от верхнего левого угла родительского элемента (если родительским не указан никакой gui-элемент, то родителем является экран сам по себе). Если разрешением экрана является, допустим, 1920x1200, то верхняя левая сторона экрана будет 0 пикселями, а верхняя правая - 1920 пикселями, позиция 960 по оси X же будет являться центром экрана по горизонтали. Аналогично этому, если вершина экрана - это 0 пикселей, а низ - 1200, то позиция 20 по оси Y будет отступом на 20 пикселей от верхней границы экрана. Те же принципы применимы к ширине и высоте (при Width, равной 50, окно будет 50 пикселей в ширину). Вы можете пользоваться guiGetScreenSize и путем нехитрых вычислений получать нужные вам абсолютные значения.

Разница между использованием относительных и абсолютных значений очевидна: gui, созданное с использованием абсолютных значений, всегда будет появляться с точь-в-точь одинаковыми габаритами и позицией, в то время как gui, созданное с использованием относительных значений, всегда будет связано процентным соотношением с размерами своего родителя.

Абсолютные значения в целом легче поддерживать при ручной правке кода, но выбор типа используемых значений варьируется от ситуации к ситуации.

Для разрешения целей из данного руководства мы будет пользоваться относительными значениями.

Добавление компонентов

Теперь мы добавим текстовые метки (называющиеся "логин:" и "пароль:"), редактируемые поля (для ввода информации) и кнопку для непосредственного залогинивания.

Для создания кнопок воспользуемся guiCreateButton, а для создания редактируемых полей - guiCreateEdit:

Примите во внимание, что сейчас мы просто дописываем уже существующую функцию 'createLoginWindow'. Функция ниже не является новой, а предназначена заменить то, что мы уже имеем.

function createLoginWindow()
    local X = 0.375
    local Y = 0.375
    local Width = 0.25
    local Height = 0.25
    wdwLogin = guiCreateWindow(X, Y, Width, Height, "Пожалуйста, залогиньтесь", true)
    
    -- объявляем новые позиции для первой метки по осям X и Y
    X = 0.0825
    Y = 0.2
    -- объявляем новые значения ширины и высоты для первой метки
    Width = 0.25
    Height = 0.25
    -- создаем первую метку, заметьте, что последний указанный аргумент - 'wdwLogin', значит окно,
    -- созданное выше, является родителем этой метки (так что значения ее позиции и габариты теперь связаны с позицией того окна)
    guiCreateLabel(X, Y, Width, Height, "Имя", true, wdwLogin)
    -- изменяем позицию по оси Y, чтобы вторая метка была чуть ниже первой
    Y = 0.5
    guiCreateLabel(X, Y, Width, Height, "Пароль", true, wdwLogin)
    

    X = 0.415
    Y = 0.2
    Width = 0.5
    Height = 0.15
    edtUser = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
    Y = 0.5
    edtPass = guiCreateEdit(X, Y, Width, Height, "", true, wdwLogin)
    -- для логина и пароля устанавливаем ограничение на максимальное количество введенных символов 50
    guiEditSetMaxLength(edtUser, 50)
    guiEditSetMaxLength(edtPass, 50)
    
    X = 0.415
    Y = 0.7
    Width = 0.25
    Height = 0.2
    btnLogin = guiCreateButton(X, Y, Width, Height, "Логин", true, wdwLogin)
    
    -- делаем окно невидимым
    guiSetVisible(wdwLogin, false)
end

Заметьте, что каждый созданный компонент GUI является дочерним по отношению к окну, это сделано благодаря указанию родительского элемента (в данном случае, wdwLogin) при создании компонента.

Это очень полезно не только потому что все компоненты прикреплены к окну и будут двигаться вместе с ним, но и так как любые изменения с "родительским" окном будут применены дальше вниз по дереву к этим дочерним компонентам. Например, мы теперь можем спрятать весь только что созданный GUI просто спрятав окно:

guiSetVisible(wdwLogin, false) --прячет весь сделанный нами GUI, чтобы мы могли показать его игроку в соответствующий момент. 

Для редактироования GUI вы также можете воспользоваться GUI редактором.

Использование написанной функции

Теперь функция createLoginWindow доделана, но пока мы ее не вызовем, она сама по себе ничего не будет делать. Рекомендуется создавать весь GUI при старте клиентского ресурса, прятать его, а затем показывать игроку, когда понадобится. Следовательно, для создания окна мы напишем обработчик события "onClientResourceStart":

-- прикрепляем обработчик события в корневому (root) элементу ресурса
-- это значит, что он сработает только при старте этого ресурса
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), 
    function ()
        createLoginWindow()
    end
)    

Так как это - окно входа пользователя, теперь нам надо показывать его при подключении игроков к серверу. Это можно сделать, используя все то же событие, "onClientResourceStart", мы можем изменить код выше, включив показ окна:

Заметьте, что сейчас мы допишем код для уже существующего обработчика 'onClientResourceStart'. Это не новый обработчик события, код предназначен заменить то, что мы уже имеем.

addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), 
    function ()
        -- создаем окно входа и его компоненты
        createLoginWindow()

        -- выводим игроку краткое приветствие
                outputChatBox("Добро пожаловать на мой MTA:SA сервер, пожалуйста, залогиньтесь.")

        -- если GUI был создан успешно, показать его игроку
            if (wdwLogin ~= nil) then
            guiSetVisible(wdwLogin, true)
        else
            -- если GUI не был создан успешно, сообщаем игроку об этом
            outputChatBox("Возникла непредвиденная ошибка и GUI входа не был создан.")
            end 

        -- активируем курсор игрока (чтобы он мог выбирать компонентф и кликать по ним)
            showCursor(true)
        -- отдаем контроль над клавиатурой GUI, позволяя игрокам (например) нажимать 'T', не открывая при этом одновременно чат
            guiSetInputEnabled(true)
    end
)    

Заметьте, что перед тем, как сделать окно видимым, имеет место простая проверка, так что даже при маловероятном случае, когда окно не будет создано в силу того, что wdwLogin - недействительный элемент, мы не получим ошибку и проинформируем игрока о произошедшем. Следующий шаг - создание кнопочного функционала для кнопки логина.

Программирование кнопки

Теперь мы создали GUI и явили его игроку, сейчас же надо сделать его рабочим.

Обнаружение клика

Когда игрок кликает по какому-либо компоненту GUI, по отношении к этому компоненту срабатывает событие "onClientGUIClick". Это позволяет нам с легкостью отслеживать различные клики по тем элементам GUI, которые мы желаем использовать. Например, мы можем прикрепить событие ко кнопке btnLogin для отслеживания кликов по ней:

-- прикрепляем событие onClientGUIClick к btnLogin и с него переключение на функцию 'clientSubmitLogin'
addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)

Заметьте, что последний аргумент - "false". Это говорит о том, что срабатывание события произойдет только именно от btnLogin, но не в результате его распространения вверх или вниз по дереву. Использование "true" при прикреплении к элементам gui повлечет за собой срабатывание события при клике по любому из элементов одной ветви.

Теперь эта строка кода может быть добавлена внутрь функции createLoginWindow. Распространенной ошибкой является пробовать и прикреплять события к несуществующим элементам GUI, так что всегда проверяйте, прикрепили ли вы свои события уже после создания элемента gui (в данном случае, кнопки):

Обратите внимание, что сейчас мы допишем код для уже существующей функции 'createLoginWindow'.

function createLoginWindow()
    -- создаем все наши элементы GUI
    ...

    -- теперь добавим событие onClientGUIClick к свежесозданной кнопке
    addEventHandler("onClientGUIClick", btnLogin, clientSubmitLogin, false)

Управление кликом

Теперь мы можем обнаружить клик игрока по кнопке, и нам нужно написать код, отвечающий за происходящее после него. В нашем обработчике события onClientGUIClick мы распорядились переключаться на функцию clientSubmitLogin при клике по btnLogin. Следовательно, теперь мы можем воспользоваться функцией clientSubmitLogin для контроля над происходящим после клика по кнопке:

-- создаем функцию и определяем параметры 'button' и 'state'
-- (которые автоматически передаются событием onClientGUIClick)
function clientSubmitLogin(button,state)
    -- если клик по кнопке был произведен левой кнопкой мыши, и положение кнопки мыши - "вверху" (отпущена)
    if button == "left" and state == "up" then
        -- отдаем контроль над клавиатурой обратно игре (позволяя игрокам передвигаться, писать в чат и т.д.)
        guiSetInputEnabled(false)
        -- прячем окно и все его компоненты
        guiSetVisible(wdwLogin, false)
        -- прячем курсор мыши
        showCursor(false)
    end
end

Теперь, когда по кнопке кликнули, окно будет спрятано и все управление будет передано обратно в руки игрока. Затем, мы скажем серверу, что игрокам можно спавниться.

Вызов сервера

Вызов сервера производится с помощью triggerServerEvent. Это позволяет вам вызывать указанное серверное событие из клиента. С помощью triggerClientEvent можно сделать и наоборот. В данном случае мы будем использовать функцию triggerServerEvent для вызова созданного нами сами серверного события, названного "submitLogin", которое затем проконтроллирует респавн игрока на серверной стороне.

Примите во внимание, что сейчас мы просто дописываем код для уже существующей функции 'clientSubmitLogin'. Функция ниже не является новой, а предназначена заменить то, что мы уже имеем.

function clientSubmitLogin(button,state)
    if button == "left" and state == "up" then
        -- получаем текст, введенный в поле 'username'
        local username = guiGetText(edtUser)
        -- получаем текст, введенный в поле 'password'
        local password = guiGetText(edtPass)

        -- если и username, и password существуют
        if username ~= "" and password ~= "" then
            -- вызвать серверное событие 'submitLogin', передав ему username и password
            triggerServerEvent("submitLogin", getRootElement(), username, password)

            -- прячем gui, курсор и возвращаем управление игроку
            guiSetInputEnabled(false)
            guiSetVisible(wdwLogin, false)
            showCursor(false)
        else
            -- иначе выводим игроку сообщение, но не отсылаем информацию на сервер
            -- и не прячем gui
            outputChatBox("Пожалуйста, введите логин и пароль.")
        end
    end
end

Создание серверного события

На данный момент мы имеем весь нужный код для клиентской стороны, так что откройте ваш серверный файл 'script.lua' (из введения в скриптинг), либо любой другой подходящий для работы серверный файл.

На стороне сервера надо сделать так, чтобы игрок спавнился, как только залогинится. Итак, для начала нам понадобится объявить свое событие, которым мы ранее пользовались на клиенте. Это можно сделать с помощью связки addEvent и addEventHandler.

-- создаем функцию loginHandler с параметрами username и password (переданные от gui на клиенте)
function loginHandler(username,password)

end

-- объявляем свое событие и позволяем ему быть вызванным из клиента ('true')
addEvent("submitLogin",true)
-- добавляем обработчик события, чтобы при вызове submitLogin происходило переключение на функцию loginHandler
addEventHandler("submitLogin",root,loginHandler)

Залогинивание

Теперь у нас есть функция, которая вызывается через наше собственное событие 'submitLogin', теперь можно начать работать над процессом залогинивания и респавна игрока, задействовав функцию 'loginHandler':

function loginHandler(username,password)
    -- проверяем username и password на правильность
    if username == "user" and password == "apple" then
        -- игрок успешно залогинился, так что спавним его
        if (client) then
            spawnPlayer(client, 1959.55, -1714.46, 10)
            fadeCamera(client, true)
                        setCameraTarget(client, client)
            outputChatBox("Добро пожаловать на мой сервер.", client)
        end
    else
        -- если username или password неправильны, выводим игроку соответствующее сообщение
        outputChatBox("Неправильные логин и пароль. Пожалуйста, переподсоединитесь и попробуйте еще раз.",client)
        end            
end

addEvent("submitLogin",true)
addEventHandler("submitLogin",root,loginHandler)

Для целей данного руководства была использована очень простая система хранения логинов/паролей. Более вменяемыми альтернативами являются встроенная система аккаунтов и база данных MySQL.

Также заметьте, что была задействована переменная "client", это - внутренняя перменная, используемая MTA для идентификации игрока, вызвавшего срабатывание события.


Наконец, не забудьте включить новый файл gui.lua в meta.xml главного ресурса и отметить его как клиентский скрипт:

<script src="client/gui.lua" type="client" />





Автор публикации:

WiseBear WiseBear

Скачать:

Скачать

Дата:
Автор ресурса:

Автор не указан

Введение в скриптинг 2
Введение в скриптинг 2
24.12.2020, Клиенты MTA
Введение в скриптинг
Введение в скриптинг
12.02.2021, Статьи
Урок как сделать красивое окно в виде функции.
Урок как сделать красивое окно в виде функции.
04.06.2021, FAQ ПО МТА
Как начать игру MTA SA. Как играть в gta san andreas по сети
Как начать игру MTA SA. Как играть в gta san
21.11.2020, Статьи / FAQ ПО МТА

Нет комментариев.Оставишь комментарий?