スクリプト管理
スクリプトを集中管理サーバーへインポートする
ファイル管理 → スクリプトディレクトリを開きます。- ローカルのスクリプトファイル、スクリプトフォルダー、またはフラットスクリプトのディレクトリ全体をファイルマネージャーへドラッグします。
- アップロードが完了すると、スクリプトがメイン画面のスクリプトドロップダウンへ自動的に表示され、選択して直接実行できます。
- スクリプトが多い場合は、
スクリプトディレクトリ内にフォルダーを新規作成して分類できます。
フラットスクリプトとは
集中管理サーバーでの管理に最も適しているのは「フラットスクリプト」、つまり lua/scripts/main.lua または lua/scripts/main.xxt を含むディレクトリです。例:
自分のスクリプト/
├── res/
│ ├── icon.png
│ └── sample.png
└── lua/
├── helper.lua
└── scripts/
├── main.lua
└── main.json
この種類のディレクトリをアップロードすると、集中管理サーバーはフォルダー全体を 1 つの実行可能なスクリプト単位として扱います。デバイスへ転送するときはディレクトリ構造のまま展開し、main.lua または main.xxt をエントリーポイントとして使用します。
.xpp スクリプトパッケージもスクリプト単位として管理できます。集中管理用の設定画面ファイルはパッケージルートの main.json に置き、lua/scripts/ 以下には置きません。
.xpa 暗号化パッケージは、ファイルの関連付けからダブルクリックして開くか、ファイル管理 → スクリプトディレクトリ へドラッグしてインストールできます。インストール後は、スクリプトディレクトリ 内の .xpp スクリプトパッケージになります。
スクリプトを開始・停止する
- メイン画面のスクリプトドロップダウンでスクリプトを選択します。
- デバイス一覧で対象デバイスにチェックを入れます。
- アクションバーの「スクリプトを開始」をクリックします。集中管理サーバーがスクリプトをデバイスへ転送してから、デバイス上で起動します。
- 停止するには、同じアクションバーの「スクリプトを停止」をクリックします。
同時にグループへチェックを入れ、そのグループにスクリプトが関連付けられている場合は、アクションバーで現在選択されているスクリプトよりもグループのスクリプトが優先されます。詳しい規則については、デバイスグループを参照してください。
デバイスへスクリプトをアップロードする / デバイス側でスクリプトを選択する
- スクリプトをデバイスへアップロード:集中管理サーバー上の特定のスクリプトまたは「ローカルのすべてのスクリプト」をデバイスへ一括転送しますが、直ちには起動しません。
- デバイス側で指定スクリプトを選択:デバイス側で現在選択されているスクリプトだけを切り替え、後からデバイス上で手動実行する場合に適しています。
スクリプトへ設定画面を追加する
ファイル管理 → スクリプトディレクトリで、フラットスクリプトのディレクトリまたは.xppスクリプトパッケージのディレクトリを右クリックします。スクリプト UI 設定を編集を選択します。- スクリプト UI エディターで
main.jsonを編集します。フラットスクリプトではlua/scripts/main.json、.xppではパッケージルートのmain.jsonを使用します。 - メイン画面へ戻ると、現在のスクリプトに設定画面がある場合は、スクリプトドロップダウンの右側に「設定」ボタンが表示されます。
同じスクリプトで、既定の main.json 引数を使用することも、グループへ専用設定を保存することもできます。
XXTLanControl.lua の更新方法
システム設定 → スクリプト実行設定で、スクリプトの実行前にXXTLanControl.luaを自動転送するかどうかを設定できます。- 同じパネルにある「今すぐ更新」機能では、
スクリプトディレクトリ内の既存のXXTLanControl.luaを、現在のサーバーバージョンへ一括置換できます。