Ir para o conteúdo principal

Módulo XXTLanControl

XXTLanControl.lua fornece aos scripts no dispositivo uma interface unificada para interagir com o servidor de controle central. Atualmente, o módulo é dividido em cinco áreas principais:

  • Controle central: inicializa conexões, configura a política de novas tentativas, captura o estado da interface, define aliases de log e envia logs ao controle central.
  • Assistência humana: inicia solicitações de resposta de texto, seleção de coordenadas ou controle remoto no controle central.
  • Arquivos compartilhados: lê e grava no diretório de recursos do gerenciador de arquivos.
  • Operações de dados KVDB: opera filas e dicionários no controle central, com suporte a movimentação atômica, cópia, criação, leitura, atualização e exclusão.
  • Operações de tabelas de dados: trabalha com tabelas estruturadas no controle central, permitindo criar, consultar e editar dados estruturados e oferecendo recursos avançados como obtenção atômica de linhas.

Baixar o módulo​

Clique aqui para baixar XXTLanControl.lua

Importar o módulo​

local LCC = require("XXTLanControl")

Antes de começar​

  • Confirme primeiro se a versão do XXTouch no dispositivo é suficientemente recente.
  • LCC.capture_ui_state() exige ui_element 0.6.0 ou posterior no dispositivo; se o módulo não estiver disponível ou a versão for muito antiga, atualize o XXTouch antes de usar capture_ui_state.
  • Se o script não for iniciado diretamente pelo controle central, chame primeiro LCC.set_api_url("http://中控地址:46990").
  • Execute LCC.connect() para concluir a inicialização antes de usar qualquer interface.

Quando a versão do módulo no dispositivo não corresponder à do controle central atual, LCC.connect() tentará baixar novamente a versão mais recente de XXTLanControl.lua pelo controle central e se reconectará automaticamente.

Formas comuns de uso conjunto​

  • Use LCC.get_ui_config() para ler os parâmetros enviados pela interface de configuração em main.json de um script plano ou pacote de scripts XPP.
  • Use LCC.log() para gravar logs de volta nas colunas de log 1 a 6 do controle central.
  • Use LCC.capture_ui_state() para capturar uma screenshot e a árvore de elementos de texto e salvá-las como .xxtuie ou enviá-las junto com o log.
  • Use LCC.kvdb, LCC.db e os recursos de dados da interface para compartilhar estados ou dados de negócio.