メインコンテンツへ移動

XXTLanControl モジュール

XXTLanControl.lua は、デバイス側スクリプトから集中管理サーバーを操作するための統一インターフェースを提供します。現在、このモジュールには主に次の 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") を呼び出してください。
  • いずれかのインターフェースを使用する前に、LCC.connect() を実行して初期化を完了してください。

デバイス上のモジュールのバージョンが現在の集中管理サーバーと一致しない場合、LCC.connect() は集中管理サーバーから新しい XXTLanControl.lua の再ダウンロードを試み、その後自動的に再接続します。

よく使う組み合わせ​

  • LCC.get_ui_config() で、フラットスクリプトまたは XPP スクリプトパッケージの main.json に定義された設定画面から送信されたパラメータを読み取ります。
  • LCC.log() で、ログを集中管理サーバーのログ列 1～6 に書き戻します。
  • LCC.capture_ui_state() でスクリーンショットとテキスト要素ツリーを取得し、.xxtuie として保存するか、ログとともにアップロードします。
  • LCC.kvdb、LCC.db を使用して、管理画面のデータ機能と状態や業務データを共有します。