跳至主要內容

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 與介面中的資料功能共享狀態或業務資料。