跳到主要内容

# 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")`。
- 使用任何接口前都应执行 `LCC.connect()` 完成初始化。

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

## 常见配合方式​

- 用 `LCC.get_ui_config()` 读取平铺脚本或 XPP 脚本包 `main.json` 中配置界面提交的参数。
- 用 `LCC.log()` 把日志写回中控的 1-6 号日志列。
- 用 `LCC.capture_ui_state()` 抓取截图和文本元素树，并保存为 `.xxtuie` 或随日志上传。
- 用 `LCC.kvdb`、`LCC.db` 与界面里的数据功能共享状态或业务数据。