跳到主要内容

XXTLanControl 模块

XXTLanControl.lua 为设备端脚本提供与中控服务器交互的统一接口。当前模块主要分为四块能力：

  • 核心控制：初始化连接、配置重试策略、设置日志别名并向中控发送日志。
  • 共享文件：读写文件管理器里的“资源目录”。
  • KVDB 数据操作：中控侧队列与词典操作，支持原子移动、复制、增删改查等能力。
  • 数据表操作：中控侧结构化数据表，支持创建、查询、编辑结构化数据，并提供原子领取等高级操作。

下载模块​

点击此处下载 XXTLanControl.lua

引入模块​

local LCC = require("XXTLanControl")

开始之前​

  • 请先确认设备上的 XXTouch 版本足够新。
  • 如果脚本不是由中控直接启动，需要先调用 LCC.set_api_url("http://中控地址:46990")。
  • 使用任何接口前都应执行 LCC.connect() 完成初始化。

当设备上的模块版本与当前中控不匹配时，LCC.connect() 会尝试从中控重新下载新版 XXTLanControl.lua，然后自动重连。

常见配合方式​

  • 用 LCC.get_ui_config() 读取平铺脚本 main.json 中配置界面提交的参数。
  • 用 LCC.log() 把日志写回中控的 1-6 号日志列。
  • 用 LCC.kvdb、LCC.db 与界面里的数据功能共享状态或业务数据。