본문으로 건너뛰기

스크립트 관리

중앙 제어 서버로 스크립트 가져오기​

  1. 파일 관리 → 스크립트 디렉터리를 엽니다.
  2. 로컬 스크립트 파일, 스크립트 폴더 또는 완전한 평면형 스크립트 디렉터리를 파일 관리자에 끌어다 놓습니다.
  3. 업로드가 끝나면 스크립트가 메인 화면의 스크립트 드롭다운에 자동으로 나타나며 바로 선택하여 실행할 수 있습니다.
  4. 스크립트가 많으면 스크립트 디렉터리 안에 폴더를 만들어 분류할 수 있습니다.

평면형 스크립트란​

중앙 제어 서버에서는 lua/scripts/main.lua 또는 lua/scripts/main.xxt가 들어 있는 “평면형 스크립트” 디렉터리를 관리하기에 가장 적합합니다. 예:

내 스크립트/
├── res/
│ ├── icon.png
│ └── sample.png
└── lua/
├── helper.lua
└── scripts/
├── main.lua
└── main.json

이런 디렉터리를 업로드하면 중앙 제어 서버는 전체 폴더를 하나의 실행 가능한 스크립트 단위로 취급합니다. 기기로 전송할 때 디렉터리 구조대로 펼치고 main.lua 또는 main.xxt를 진입점으로 사용합니다.

.xpp 스크립트 패키지도 스크립트 단위로 관리할 수 있습니다. 중앙 제어 설정 화면 파일은 패키지 루트의 main.json에 두며 lua/scripts/ 아래에 두지 않습니다.

.xpa 암호화 패키지는 파일 연결로 두 번 클릭하여 열거나 파일 관리 → 스크립트 디렉터리로 끌어다 놓아 설치할 수 있습니다. 설치 후에는 스크립트 디렉터리 아래의 .xpp 스크립트 패키지가 됩니다.

스크립트 시작과 중지​

  1. 메인 화면의 스크립트 드롭다운에서 스크립트를 선택합니다.
  2. 기기 목록에서 대상 기기를 선택합니다.
  3. 작업 표시줄에서 “스크립트 실행”을 클릭합니다. 중앙 제어 서버가 먼저 스크립트를 기기로 전송한 다음 기기에서 실행합니다.
  4. 중지하려면 같은 작업 표시줄에서 “스크립트 중지”를 클릭합니다.

그룹도 함께 체크되어 있고 해당 그룹에 스크립트가 연결되어 있다면 그룹 스크립트가 작업 표시줄에서 현재 선택한 스크립트보다 우선합니다. 자세한 규칙은 기기 그룹을 참조하세요.

기기로 스크립트 업로드/기기에서 스크립트 선택​

  • 기기로 스크립트 업로드: 중앙 제어 서버의 특정 스크립트 또는 “모든 로컬 스크립트”를 기기에 일괄 전송하지만 즉시 실행하지는 않습니다.
  • 기기에서 지정한 스크립트 선택: 기기에서 현재 선택된 스크립트만 바꾸며, 이후 기기에서 직접 실행할 때 적합합니다.

스크립트에 설정 화면 추가​

  1. 파일 관리 → 스크립트 디렉터리에서 평면형 스크립트 디렉터리 또는 .xpp 스크립트 패키지 디렉터리를 마우스 오른쪽 버튼으로 클릭합니다.
  2. 스크립트 UI 설정 편집을 선택합니다.
  3. 스크립트 UI 편집기에서 main.json을 관리합니다. 평면형 스크립트는 lua/scripts/main.json, .xpp는 패키지 루트의 main.json을 사용합니다.
  4. 메인 화면으로 돌아오면 현재 스크립트에 설정 화면이 있는 경우 스크립트 드롭다운 오른쪽에 “설정” 버튼이 표시됩니다.

같은 스크립트에서 기본 main.json 매개변수를 사용할 수도 있고, 그룹별 전용 설정을 저장할 수도 있습니다.

XXTLanControl.lua 업데이트 방법​

  • 시스템 설정 → 스크립트 실행 설정에서 스크립트 실행 전에 XXTLanControl.lua를 자동 전송할지 설정할 수 있습니다.
  • 같은 패널의 “지금 업데이트” 기능을 사용하면 스크립트 디렉터리에 있는 기존 XXTLanControl.lua를 현재 서버 버전으로 일괄 교체할 수 있습니다.