Перейти к основному содержимому

Модуль XXTLanControl

XXTLanControl.lua предоставляет скриптам на устройствах единый интерфейс для работы с сервером центральной консоли. Сейчас модуль включает пять основных возможностей:

  • Управление подключением: инициализация соединения, настройка повторных попыток, захват состояния интерфейса, настройка псевдонимов логов и отправка логов в консоль.
  • Помощь оператора: запрос текстового ответа, выбора координат или удалённого управления на стороне консоли.
  • Общие файлы: чтение и запись в каталоге Ресурсы файлового менеджера.
  • Операции с KVDB: работа с очередями и словарями консоли, включая атомарное перемещение, копирование, создание, изменение, удаление и чтение.
  • Операции с таблицами: структурированные таблицы данных консоли, создание, поиск и редактирование данных, а также атомарное получение строк.

Скачать модуль​

Нажмите здесь, чтобы скачать XXTLanControl.lua

Подключение модуля​

local LCC = require("XXTLanControl")

Перед началом​

  • Сначала убедитесь, что на устройстве установлена достаточно новая версия XXTouch.
  • LCC.capture_ui_state() требует на устройстве ui_element версии 0.6.0 или новее; если модуль недоступен или его версия ниже, обновите XXTouch и затем используйте capture_ui_state.
  • Если скрипт запущен не самой консолью, сначала вызовите LCC.set_api_url("http://中控地址:46990").
  • Перед использованием любого API необходимо выполнить LCC.connect() для инициализации.

Если версия модуля на устройстве не совпадает с версией текущей консоли, LCC.connect() попытается скачать из консоли новую XXTLanControl.lua, а затем автоматически переподключится.

Типовые сочетания​

  • Используйте LCC.get_ui_config(), чтобы прочитать параметры формы из main.json плоского скрипта или пакета XPP.
  • Используйте LCC.log(), чтобы записывать логи в столбцы 1–6 консоли.
  • Используйте LCC.capture_ui_state(), чтобы захватить снимок экрана и дерево текстовых элементов, сохранить их в .xxtuie или загрузить вместе с логом.
  • Используйте LCC.kvdb и LCC.db вместе с функциями работы с данными в интерфейсе для обмена состоянием или бизнес-данными.