Ir para o conteúdo principal

Solicitar controle remoto humano (LCC.assist.request_control)

Declaração​

result, err, task = LCC.assist.request_control(options)

Parâmetros​

  • options
    Tipo table; configuração da solicitação de assistência humana. Consulte os campos em parâmetros comuns e objetos de retorno. Esta função define automaticamente type = "control".

Valor de retorno​

  • result
    Tipo table ou nil; quando tem sucesso, retorna o resultado enviado pelo usuário. Clicar em "Concluído" retorna { kind = "device-control", completed = true }; expandir "Enviar resultado manualmente" e enviar um JSON válido retorna a table Lua correspondente, enquanto enviar texto comum retorna { note = "文本内容" }.
  • err
    Tipo string ou nil; em caso de falha, retorna a descrição do erro.
  • task
    Tipo table ou nil; último status da tarefa.

Descrição​

Use em cenários como controles deslizantes, verificações antirobô, login, verificações de segurança, janelas de permissão e interações complexas nas quais o script não deve continuar tentando adivinhar.
Depois de controlar o dispositivo remotamente e resolver o problema, o usuário clica em "Concluir"; o script continua e analisa a tela novamente.
Descreva claramente em text o que o usuário precisa fazer.

"Concluído" e "Enviar resultado manualmente" são duas entradas diferentes:

  • Clicar em "Concluído": adequado apenas para indicar que a operação remota terminou; retorna sempre { kind = "device-control", completed = true }.
  • Clicar em "Enviar" dentro de "Enviar resultado manualmente": adequado para devolver informações adicionais ao script. JSON válido é retornado como resultado estruturado; texto que não seja JSON é retornado como { note = "..." }; conteúdo vazio não é enviado.

Exemplo​

local result, err = LCC.assist.request_control({
    title = "人工处理验证",
    text = "请远控设备完成验证后点击已完成",
    timeout = 300,
})

if not result then
    nLog("远控未完成", err)
end

Passar a screenshot atual diretamente:

local img = screen.image()

local result, err = LCC.assist.request_control({
    title = "需要人工处理",
    text = "请远控完成当前验证后点击完成",
    screenshotImage = img,
    screenshotImageQuality = 0.6,
    timeout = 300,
})

if img.destroy then
    img:destroy()
end