Ir para o conteúdo principal

Assistência humana

LCC.assist permite que scripts no dispositivo iniciem solicitações de assistência humana no controle central. O script pode incluir uma screenshot e instruções, aguardar bloqueado até que uma pessoa envie o resultado e então continuar a execução.

Tipos de solicitação​

TipoAPICenário adequadoComo o script normalmente processa
Resposta de textoLCC.assist.ask_text()CAPTCHA, código SMS, senha e token de uso únicoinsira result.text na caixa de entrada atual
Seleção de coordenadasLCC.assist.pick_point()quando uma pessoa precisa decidir onde tocar, como em um botão gráfico ou botão de uma janela inesperadachame diretamente touch.tap(result.x, result.y)
Controle remoto humanoLCC.assist.request_control()fluxos instáveis como controles deslizantes, verificações antirobô, login, verificações de segurança e janelas de permissãoaguarde a conclusão do controle remoto humano, capture a tela novamente e continue a análise

As instruções para a pessoa que vai operar devem ser concretas e executáveis; não use descrições abstratas como "informações adicionais". Prefira textos como "controle remotamente o dispositivo, conclua a verificação atual e clique em Concluído", "digite o código da screenshot" ou "clique no centro do botão de confirmação".

Fontes de screenshots​

Uma solicitação de assistência pode incluir uma imagem de várias formas:

  • screenshotLocalPath: Caminho de uma imagem local no dispositivo; o SDK a envia como recurso temporário à central.
  • screenshotPath: quando a imagem já está na raiz files do controle central, passe diretamente seu caminho relativo.
  • screenshotImage: ImageObject do XXTouch; o SDK o converte em um data URL, sem exigir que a imagem seja salva antes em um arquivo.
  • screenshotImageData: dados binários de imagem PNG/JPEG; o SDK os converte em um data URL.
  • input.imageSrc: quando o script já tem um endereço de imagem data:image/..., http(s)://... ou /api/..., coloque-o em input para repassá-lo ao front-end.

O SDK não sobrescreve input.imageSrc. Ele só converte screenshotImage ou screenshotImageData em input.imageSrc quando input.imageSrc e uma screenshot por caminho não foram informados.

Ciclo de vida​

Os estados são pending (pendente), active (em atendimento), submitted (resultado enviado), cancelled (cancelada) e expired (expirada). Apenas submitted indica que um resultado humano está disponível.

Se LCC.assist.request() exceder o tempo de espera, tentará cancelar essa solicitação. Ao encerrar o script normalmente, será tentado o cancelamento das solicitações pendentes da instância atual. Tarefas e resultados não são preservados após reiniciar a central; salve separadamente os resultados necessários para uso posterior.

Quando a central recebe o estado de dispositivo parado, cancela as solicitações de assistência lua-script desse dispositivo que estejam em pending / active. Esse cancelamento em lote não afeta outros dispositivos, outras origens nem resultados enviados.

As capturas enviadas automaticamente são removidas quando a central inicia. Salve uma cópia em um caminho de recursos que você gerencie para reutilização duradoura; não trate o screenshotPath gerado como referência permanente.

As imagens em linha não são mantidas após o envio do resultado, o cancelamento ou a expiração da solicitação.

Lista de APIs​