Перейти к основному содержимому

Запрос удалённого управления оператором (LCC.assist.request_control)

Сигнатура​

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

Параметры​

Возвращаемое значение​

  • result
    Таблица или nil; при успехе возвращает результат оператора. Нажатие «Готово» возвращает { kind = "device-control", completed = true }; отправка допустимого JSON в разделе «Ручная отправка результата» возвращает соответствующую таблицу Lua, а обычный текст — { note = "文本内容" }.
  • err
    Строка или nil; при сбое возвращается описание ошибки.
  • task
    Таблица или nil; последнее состояние задачи.

Описание​

Используется для слайдеров, CAPTCHA, входа, проверок безопасности, диалогов разрешений и сложных взаимодействий, где скрипту не следует угадывать дальнейшее действие.
Оператор удалённо решает проблему на устройстве и нажимает «Готово», после чего скрипт продолжает работу и заново проверяет экран.
В text нужно ясно описать, что должен сделать оператор.

«Готово» и «Ручная отправка результата» — это два разных способа завершить запрос:

  • Нажатие «Готово»: только подтверждает завершение удалённого действия и всегда возвращает { kind = "device-control", completed = true }.
  • Кнопка «Отправить» в разделе «Ручная отправка результата»: возвращает скрипту дополнительные данные. Допустимый JSON возвращается как структурированный результат, обычный текст — как { note = "..." }; пустое содержимое не отправляется.

Пример​

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

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

Передача текущего снимка экрана:

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