본문으로 건너뛰기

XXTLanControl 모듈

XXTLanControl.lua는 기기 측 스크립트가 중앙 제어 서버와 상호작용할 수 있도록 통일된 API를 제공합니다. 현재 이 모듈은 주로 다음과 같은 5가지 기능으로 구성되어 있습니다:

  • 핵심 제어: 연결 초기화, 재시도 전략 설정, UI 상태 캡처, 로그의 별명 지정 및 중앙 제어 서버로의 로그 전송.
  • 수동 지원: 중앙 제어 서버 측에 텍스트 답변, 좌표 선택 또는 원격 제어 처리 요청을 전송.
  • 공유 파일: 파일 관리자 내의 “리소스 디렉터리”에 대한 읽기 및 쓰기 작업.
  • KVDB 데이터 조작: 중앙 제어 서버 측의 큐 및 사전 관리 기능으로, 원자적 이동, 복사, 추가, 삭제, 수정 및 조회와 같은 다양한 작업을 지원.
  • 데이터 테이블 조작: 중앙 제어 서버 측의 구조화된 데이터 테이블을 활용하여 구조화된 데이터의 생성, 조회, 편집을 수행하며, 원자적 선점과 같은 고급 기능도 제공.

모듈 다운로드​

여기를 클릭하여 XXTLanControl.lua를 다운로드하세요

모듈 불러오기​

local LCC = require("XXTLanControl")

시작하기 전에​

  • 먼저 기기에 설치된 XXTouch의 버전이 충분히 최신인지 확인하십시오.
  • LCC.capture_ui_state()를 사용하려면 기기 측의 ui_element가 0.6.0 이상의 버전이어야 합니다. 모듈이 사용 불가능하거나 버전이 너무 낮은 경우에는 capture_ui_state 기능을 사용하기 전에 XXTouch를 업데이트하십시오.
  • 스크립트가 중앙 제어 서버에 의해 직접 시작되지 않는 경우에는 먼저 LCC.set_api_url("http://중앙-제어-주소:46990")를 호출해야 합니다.
  • 모든 API를 사용하기 전에 반드시 LCC.connect()를 실행하여 초기화를 완료해야 합니다.

기기에 설치된 모듈의 버전이 현재 사용 중인 중앙 제어 서버의 버전과 일치하지 않을 경우, LCC.connect()가 중앙 제어 서버에서 새 XXTLanControl.lua를 다시 다운로드하려고 시도한 다음 자동으로 다시 연결합니다.

일반적인 연동 방식​

  • LCC.get_ui_config()를 사용하여 플랫 스크립트나 XPP 스크립트 패키지 main.json 내에서 설정 UI를 통해 전달된 파라미터를 읽어옵니다.
  • LCC.log()를 사용하여 로그를 중앙 제어 서버의 1번부터 6번까지의 로그 열에 다시 기록합니다.
  • LCC.capture_ui_state()를 활용하여 스크린샷과 텍스트 요소 트리를 캡처한 뒤, 이를 .xxtuie 형태로 저장하거나 로그와 함께 업로드합니다.
  • LCC.kvdb 및 LCC.db를 사용하여 UI 내의 데이터 관련 기능들과 상태나 비즈니스 데이터를 공유합니다.