跳至主要內容

腳本管理

匯入腳本到中控​

  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. 在腳本介面編輯器中維護 main.json：平鋪腳本為 lua/scripts/main.json，.xpp 為包根 main.json。
  4. 回到主介面後，如果目前腳本有設定介面，腳本下拉式選單右側會出現“設定”按鈕。

同一個腳本既可以使用預設的 main.json 參數，也可以在群組上儲存專屬設定。

XXTLanControl.lua 的更新方式​

  • 在 系統設定 → 腳本執行設定 中，可以設定執行腳本前是否自動傳輸 XXTLanControl.lua。
  • 同一面板還提供"立即更新"功能，可以把 腳本目錄 中已有的 XXTLanControl.lua 批次替換為目前伺服器版本。