はじめに

XXTLanControl は、ローカルネットワーク上の XXTouch デバイスを一括管理・制御するための集中管理プラットフォームです。主に次のコンポーネントで構成されています。

• バックエンドサービス：HTTP API を提供し、デバイス通信、ファイル管理、データ保存などの中核処理を担います
• Web フロントエンド：ブラウザベースの管理画面で、デバイス一覧、スクリプト管理、リモート操作、ファイル管理、KVDB、TableDB、サンプルワークベンチなどの機能を利用できます
• トレイアプリ（任意）：Windows / macOS のシステムトレイから、バックエンドの起動・停止やブラウザの起動をすばやく行えます
• Lua モジュール XXTLanControl.lua：デバイス側で動作するスクリプトライブラリで、集中管理サーバーへの接続、ログ送信、KVDB、TableDB、ファイル操作などのインターフェースを提供します

配布パッケージの構成

配布パッケージの名前は OS ごとに多少異なりますが、一般的には次の内容が含まれます。

Windows

パス / ファイル	説明
XXTLanControl-tray-windows-amd64.exe	トレイランチャーです。ダブルクリックするとバックエンドを起動し、トレイに常駐します。
bin/XXTLanControl-backend-windows-amd64.exe	集中管理バックエンドサービスです。
bin/xxtlancontrol-mcpserver.exe	MCP サービスプログラムです。
dist/	実行時リソースのルートです。web/ には Web コンソール画面があり、その他はパッケージ付属のリソースです。
start-backend.cmd	コマンドラインモードの起動スクリプトです。問題を調査するときに適しています。
XXTLanControl.lua	デバイス側から集中管理機能を呼び出すための Lua モジュールです。

macOS

パス / ファイル	説明
XXTLanControl.app	メインアプリケーションです。ダブルクリックするとトレイアプリとバックエンドが起動します。
XXTLanControl.app/Contents/MacOS/xxtlancontrol-mcpserver	MCP サービスプログラムです。
XXTLanControl.app/Contents/Resources/dist/	実行時リソースのルートです。web/ には Web コンソール画面があり、その他はパッケージ付属のリソースです。
start-backend.command	ターミナルモードの起動スクリプトです。問題を調査するときに適しています。
XXTLanControl.lua	デバイス側から集中管理機能を呼び出すための Lua モジュールです。

Linux

パス / ファイル	説明
XXTLanControl-backend-linux-amd64 / XXTLanControl-backend-linux-arm64	アーキテクチャ別に提供されるバックエンドバイナリです。
xxtlancontrol-mcpserver	アーキテクチャに対応する MCP バイナリを自動選択する起動スクリプトです。
xxtlancontrol-mcpserver-linux-amd64 / xxtlancontrol-mcpserver-linux-arm64	アーキテクチャ別に提供される MCP バイナリです。
dist/	実行時リソースのルートです。web/ には Web コンソール画面があり、その他はパッケージ付属のリソースです。
start-backend.sh	コマンドラインモードの起動スクリプトです。
XXTLanControl.lua	デバイス側から集中管理機能を呼び出すための Lua モジュールです。

主な機能

• デバイス管理：ローカルネットワーク上の XXTouch デバイスを検出してインポートし、グループ単位で一括管理できます
• スクリプト実行：スクリプトをデバイスへアップロードし、いつでも開始、停止、一時停止できます
• リモート操作：デバイス画面をリアルタイムで確認し、タッチ操作やキー操作を行えます。複数デバイスの同時リモート操作にも対応しています
• ファイル管理：集中管理サーバー上のスクリプト、リソース、レポートなどを管理し、アップロード、ダウンロード、オンライン編集を行えます
• データ管理：KVDB（キュー + 辞書）と TableDB（構造化テーブル）を内蔵し、スクリプト間での状態共有や業務データの保存に利用できます
• スケジュールタスク：時刻指定、間隔指定、1 回限り、ユーザー起動、KVDB キュー消費など複数のトリガー方式に対応し、ステップ編成とビジュアルワークフローを提供します
• サンプルワークベンチ：スクリーンショットからの色取得、範囲の切り抜き、ドットマトリクスフォント、テキスト要素の取得など、スクリプト開発を支援するツールです
• 一括操作：一括認証、新版 XXTouch の一括インストール、一括名前変更、一括スクリーンショット、一括ロック / ロック解除などを行えます

利用要件

• デバイス側に XXTouch をインストールし、リモートアクセス を有効にしておく必要があります
• デバイスと集中管理サーバーが同じローカルネットワークにあり、集中管理サーバーのファイアウォールで HTTP ポート（既定値は 46990）が許可されている必要があります

初回起動

• Windows：XXTLanControl-tray-windows-amd64.exe をダブルクリックします。通常はブラウザが自動的に開き、コンソールが表示されます
• macOS：XXTLanControl.app を開きます。通常はブラウザが自動的に開き、コンソールが表示されます
• Linux：start-backend.sh を実行してから、http://127.0.0.1:46990/ に手動でアクセスします

詳しい使い方は、以降の章を参照してください。