Быстрый старт
Главный скрипт
Работа "Редактора скриптов" построена на модели, которая предполагает наличие файла скрипта main.lua и файлов с подключаемыми модулями.
Для создания скрипта нажмите на кнопку ➕ на панели инструментов. Откроется диалоговое окно "Создание файла" и система автоматически предложит создать новый файл с именем main.lua.
Внимание
Изменение имени файла скрипта main.lua не допускается.
При именовании последующих файлов проекта (модулей) необходимо обязательно указывать расширение .lua для каждого.
Файл main.lua является основным. Он предоставляет возможность вызова всех дополнительных модулей.
Компиляция
После создания скрипта необходимо произвести сборку кода с помощью кнопки "Компилировать". В случае успешной компиляции в отладочной консоли появится сообщение "Компиляция выполнена успешно". В противном случае будет представлен список ошибок с указанием строки, позиции и описанием ошибки.
Логические ошибки в скриптах, которые не могут быть обнаружены на этапе компиляции, сохраняются в журнале отладки.
Пользовательская библиотека
Чтобы добавить пользовательскую библиотеку, поместите модуль, написанный на языке Lua, в общий каталог модулей программы: C:\Users\Public\Documents\SimpLight_5.0\scripts\sdk. После этого вызовите соответствующим образом в скрипте. Такой подход рассмотрен в примере "Время наработки тега".
Печать сообщения
Рассмотрим пример вывода строки в журнал сообщений сервера. Для этого будем использовать функцию print. Передайте ей в качестве аргумента любую строку, например "Hello, World!". Затем нажмите кнопку "Компилировать". Если компиляция выполнена успешно, сохраните проект.
Чтобы увидеть данное сообщение в списке служебных, укажите уровень логирования "DEBUG" в настройках. Далее разверните проект на сервере. Как только откроется окно клиента, перейдите в "Панель управления" для доступа к служебным сообщениям. Среди всех сообщений должна появиться строка приветствия, которую сформировал скрипт main.lua на сервере.
Чтобы добавить дополнительный модуль, повторно нажмите ➕ на панели инструментов, укажите имя и активируйте флаг "Добавить вызов модуля в скрипт main.lua". Это позволит автоматически добавить вызов модуля в основной скрипт.
Для загрузки модуля в основном скрипте используется функция require. Система автоматически добавляет вызов этой функции, если выбран соответствующий флаг при создании модуля. Также вызов вы можете указать самостоятельно в основном скрипте в формате require(имя_модуля).
Справка
В "Симплайт 5" реализован механизм горячей перезагрузки скриптов, позволяющий применять изменения в коде модулей без полной перезагрузки ядра системы. После развертывания проекта, на сервере происходит перезагрузка только измененных модулей.
setInterval(function() -- объявление циклически выполняемой функции
print("cyclic message") -- печать сообщения "cyclic message"
end, 1000) -- с интервалом 1000 мс (1 секунда)
