Giới thiệu
XXTLanControl là nền tảng điều khiển tập trung trong mạng LAN, dùng để quản lý và điều khiển hàng loạt thiết bị XXTouch. Nền tảng chủ yếu gồm các thành phần sau:
- Dịch vụ backend: cung cấp HTTP API và đảm nhiệm các chức năng cốt lõi như giao tiếp với thiết bị, quản lý tệp và lưu trữ dữ liệu
- Frontend Web: giao diện quản lý trên trình duyệt, bao gồm danh sách thiết bị, quản lý script, điều khiển từ xa, quản lý tệp, KVDB, TableDB, bàn làm việc mẫu và các chức năng khác
- Ứng dụng khay hệ thống (tùy chọn): chạy trong khay hệ thống trên Windows / macOS, giúp nhanh chóng khởi động hoặc dừng backend và mở trình duyệt
- Mô-đun Lua
XXTLanControl.lua: thư viện script chạy trên thiết bị, cung cấp các API để kết nối với hệ thống điều khiển tập trung, gửi nhật ký, thao tác với KVDB, TableDB và tệp
Cấu trúc gói phát hành
Tên gói phát hành trên mỗi hệ điều hành có thể khác nhau đôi chút, nhưng thường gồm các nội dung sau:
Windows
| Đường dẫn / Tệp | Mô tả |
|---|---|
XXTLanControl-tray-windows-amd64.exe | Trình khởi chạy ở khay hệ thống. Nhấp đúp để khởi động backend và duy trì ứng dụng trong khay hệ thống. |
bin/XXTLanControl-backend-windows-amd64.exe | Dịch vụ backend điều khiển tập trung. |
bin/xxtlancontrol-mcpserver.exe | Chương trình dịch vụ MCP. |
dist/ | Thư mục gốc của tài nguyên chạy chương trình; web/ chứa giao diện bảng điều khiển Web, các mục còn lại là tài nguyên đi kèm gói. |
start-backend.cmd | Script khởi động ở chế độ dòng lệnh, phù hợp để chẩn đoán sự cố. |
XXTLanControl.lua | Mô-đun Lua dùng để gọi các chức năng điều khiển tập trung từ thiết bị. |
macOS
| Đường dẫn / Tệp | Mô tả |
|---|---|
XXTLanControl.app | Gói ứng dụng chính. Nhấp đúp để khởi động ứng dụng khay hệ thống và backend. |
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver | Chương trình dịch vụ MCP. |
XXTLanControl.app/Contents/Resources/dist/ | Thư mục gốc của tài nguyên chạy chương trình; web/ chứa giao diện bảng điều khiển Web, các mục còn lại là tài nguyên đi kèm gói. |
start-backend.command | Script khởi động ở chế độ terminal, phù hợp để chẩn đoán sự cố. |
XXTLanControl.lua | Mô-đun Lua dùng để gọi các chức năng điều khiển tập trung từ thiết bị. |
Linux
| Đường dẫn / Tệp | Mô tả |
|---|---|
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64 | Tệp nhị phân backend dành cho từng kiến trúc. |
xxtlancontrol-mcpserver | Script khởi động MCP, tự động chọn tệp nhị phân MCP phù hợp với kiến trúc. |
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64 | Tệp nhị phân MCP dành cho từng kiến trúc. |
dist/ | Thư mục gốc của tài nguyên chạy chương trình; web/ chứa giao diện bảng điều khiển Web, các mục còn lại là tài nguyên đi kèm gói. |
start-backend.sh | Script khởi động ở chế độ dòng lệnh. |
XXTLanControl.lua | Mô-đun Lua dùng để gọi các chức năng điều khiển tập trung từ thiết bị. |
Chức năng chính
- Quản lý thiết bị: quét và nhập các thiết bị XXTouch trong mạng LAN, hỗ trợ quản lý tập trung theo nhóm
- Chạy script: tải script lên thiết bị rồi khởi động, dừng hoặc tạm dừng bất cứ lúc nào
- Điều khiển từ xa: xem màn hình thiết bị theo thời gian thực, thực hiện thao tác chạm và phím, đồng thời có thể điều khiển từ xa nhiều thiết bị
- Quản lý tệp: quản lý script, tài nguyên, báo cáo và các tệp khác trên máy chủ điều khiển tập trung; hỗ trợ tải lên, tải xuống và chỉnh sửa trực tuyến
- Quản lý dữ liệu: tích hợp KVDB (hàng đợi + từ điển) và TableDB (bảng có cấu trúc), thuận tiện cho việc chia sẻ trạng thái giữa các script hoặc lưu trữ dữ liệu nghiệp vụ
- Tác vụ theo lịch: hỗ trợ nhiều kiểu kích hoạt như theo thời điểm, theo khoảng thời gian, một lần, do người dùng kích hoạt và tiêu thụ hàng đợi KVDB; đồng thời cung cấp khả năng sắp xếp các bước và quy trình làm việc trực quan
- Bàn làm việc mẫu: các công cụ hỗ trợ phát triển script như lấy màu từ ảnh chụp màn hình, cắt vùng chọn, phông chữ ma trận điểm và thu thập phần tử văn bản
- Thao tác hàng loạt: cấp phép hàng loạt, cài đặt hàng loạt phiên bản XXTouch mới, đổi tên hàng loạt, chụp màn hình hàng loạt, khóa / mở khóa hàng loạt và các thao tác khác
Điều kiện sử dụng
- Thiết bị phải cài đặt XXTouch và bật
Truy cập từ xa - Thiết bị và máy chủ điều khiển tập trung phải nằm trong cùng một mạng LAN, đồng thời tường lửa trên máy chủ phải cho phép cổng HTTP (mặc định là
46990)
Khởi động lần đầu
- Windows: nhấp đúp vào
XXTLanControl-tray-windows-amd64.exe; thông thường trình duyệt sẽ tự động mở bảng điều khiển - macOS: mở
XXTLanControl.app; thông thường trình duyệt sẽ tự động mở bảng điều khiển - Linux: chạy
start-backend.sh, sau đó truy cập thủ công vàohttp://127.0.0.1:46990/
Xem các chương tiếp theo để biết thêm cách sử dụng.