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
| Tipo | API | Cenário adequado | Como o script normalmente processa |
|---|---|---|---|
| Resposta de texto | LCC.assist.ask_text() | CAPTCHA, código SMS, senha e token de uso único | insira result.text na caixa de entrada atual |
| Seleção de coordenadas | LCC.assist.pick_point() | quando uma pessoa precisa decidir onde tocar, como em um botão gráfico ou botão de uma janela inesperada | chame diretamente touch.tap(result.x, result.y) |
| Controle remoto humano | LCC.assist.request_control() | fluxos instáveis como controles deslizantes, verificações antirobô, login, verificações de segurança e janelas de permissão | aguarde 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 raizfilesdo controle central, passe diretamente seu caminho relativo.screenshotImage:ImageObjectdo 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 imagemdata:image/...,http(s)://...ou/api/..., coloque-o eminputpara 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
- Parâmetros comuns e objetos de retorno
- Criar uma solicitação de assistência humana
LCC.assist.create() - Aguardar um resultado de assistência humana
LCC.assist.wait() - Criar e aguardar uma solicitação
LCC.assist.request() - Solicitar uma resposta de texto
LCC.assist.ask_text() - Solicitar a seleção de coordenadas
LCC.assist.pick_point() - Solicitar controle remoto humano
LCC.assist.request_control() - Revogar uma solicitação específica
LCC.assist.cancel() - Revogar as solicitações do script atual
LCC.assist.cancel_all()