Chuyển tới nội dung chính

Mô-đun XXTLanControl

XXTLanControl.lua cung cấp API thống nhất để tập lệnh trên thiết bị tương tác với máy chủ trung tâm điều khiển. Mô-đun hiện có năm nhóm chức năng chính:

  • Điều khiển cốt lõi: Khởi tạo kết nối, cấu hình cơ chế thử lại, chụp trạng thái giao diện, đặt bí danh nhật ký và gửi nhật ký tới trung tâm điều khiển.
  • Hỗ trợ thủ công: Gửi tới trung tâm điều khiển các yêu cầu phản hồi văn bản, chọn tọa độ hoặc xử lý bằng điều khiển từ xa.
  • Tệp dùng chung: Đọc và ghi “thư mục tài nguyên” trong trình quản lý tệp.
  • Thao tác dữ liệu KVDB: Thao tác với hàng đợi và từ điển ở trung tâm điều khiển, hỗ trợ di chuyển nguyên tử, sao chép, thêm, xóa, sửa và truy vấn.
  • Thao tác bảng dữ liệu: Làm việc với bảng dữ liệu có cấu trúc ở trung tâm điều khiển, hỗ trợ tạo, truy vấn và chỉnh sửa dữ liệu, đồng thời cung cấp các thao tác nâng cao như nhận bản ghi theo cách nguyên tử.

Tải về mô-đun​

Nhấp vào đây để tải xuống XXTLanControl.lua

Đưa mô-đun vào sử dụng​

local LCC = require("XXTLanControl")

Trước khi bắt đầu​

  • Vui lòng kiểm tra xem phiên bản XXTouch trên thiết bị có đủ mới hay không.
  • LCC.capture_ui_state() yêu cầu phiên bản ui_element 0.6.0 hoặc cao hơn ở phía thiết bị; nếu mô-đun không khả dụng hoặc phiên bản quá thấp, hãy cập nhật XXTouch trước khi sử dụng chức năng capture_ui_state.
  • Nếu script không được khởi động trực tiếp từ máy chủ điều khiển trung tâm, cần gọi hàm LCC.set_api_url("http://dia-chi-may-chu:46990") trước.
  • Trước khi sử dụng bất kỳ API nào, cũng cần thực thi LCC.connect() để hoàn tất việc khởi tạo.

Khi phiên bản mô-đun trên thiết bị không tương thích với máy chủ điều khiển trung tâm hiện tại, LCC.connect() sẽ cố gắng tải xuống phiên bản mới XXTLanControl.lua từ máy chủ điều khiển trung tâm, sau đó tự động kết nối lại.

Các cách kết hợp phổ biến​

  • Dùng LCC.get_ui_config() để đọc các tham số do giao diện cấu hình trong main.json gửi cho tập lệnh dạng phẳng hoặc gói tập lệnh XPP.
  • Dùng LCC.log() để ghi nhật ký trở lại các cột nhật ký số 1 đến 6 của máy chủ điều khiển trung tâm.
  • Sử dụng LCC.capture_ui_state() để chụp ảnh màn hình và lấy thông tin cây các phần tử văn bản, sau đó lưu chúng dưới dạng .xxtuie hoặc gửi kèm theo nhật ký.
  • Dùng LCC.kvdb và LCC.db để chia sẻ trạng thái hoặc dữ liệu nghiệp vụ với các chức năng dữ liệu trên giao diện.