Помощь оператора
LCC.assist позволяет скрипту устройства отправить в центральную консоль запрос о помощи оператора. Скрипт может приложить снимок экрана и пояснение, дождаться ответа оператора и продолжить выполнение.
Типы запросов
| Тип | API | Подходящие сценарии | Типичная обработка в скрипте |
|---|---|---|---|
| Текстовый ответ | LCC.assist.ask_text() | Коды CAPTCHA и SMS, пароли, одноразовые токены | Ввести result.text в текущее поле |
| Выбор координат | LCC.assist.pick_point() | Нужно определить, куда нажать, например на графическую кнопку или кнопку аварийного диалога | Сразу вызвать touch.tap(result.x, result.y) |
| Удалённое управление оператором | LCC.assist.request_control() | Нестабильные сценарии: слайдеры, CAPTCHA, вход, проверки безопасности, диалоги разрешений | После удалённого управления снова захватить экран и продолжить проверку |
Инструкция для оператора должна быть конкретной и выполнимой. Не пишите абстрактное «дополнительная информация»; лучше указать: «Завершите текущую проверку удалённо и нажмите “Готово”», «Введите код с изображения» или «Нажмите в центр кнопки подтверждения».
Источники снимка экрана
К запросу помощи можно приложить изображение одним из следующих способов:
screenshotLocalPath: Путь к локальному изображению на устройстве; SDK загружает его как временный ресурс в центр управления.screenshotPath: относительный путь, если изображение уже находится в корнеfilesцентральной консоли.screenshotImage: объектImageObjectиз XXTouch; SDK преобразует его в data URL, предварительно сохранять файл не нужно.screenshotImageData: двоичные данные изображения PNG/JPEG; SDK преобразует их в data URL.input.imageSrc: если скрипт уже располагает адресом изображенияdata:image/...,http(s)://...или/api/..., его можно передать вinputдля отображения во фронтенде.
SDK не перезаписывает input.imageSrc. Только если input.imageSrc и путь к снимку не переданы, SDK преобразует screenshotImage или screenshotImageData в input.imageSrc.
Жизненный цикл
Состояния запроса: pending (ожидание), active (обработка), submitted (результат отправлен), cancelled (отменён) и expired (срок истёк). Только submitted означает, что результат помощи доступен.
При истечении времени ожидания LCC.assist.request() пытается отменить запрос. При штатном завершении скрипта выполняется попытка отмены незавершённых запросов текущего экземпляра. После перезапуска центра управления задачи и результаты не сохраняются; сохраните нужные результаты отдельно.
Получив состояние остановки устройства, центр управления отменяет его запросы помощи с источником lua-script, находящиеся в pending / active. Эта пакетная отмена не затрагивает другие устройства, другие источники и уже отправленные результаты.
Автоматически загруженные снимки удаляются при запуске центра управления. Для длительного использования сохраните копию по управляемому вами пути ресурса; не используйте созданный screenshotPath как постоянную ссылку на файл.
Встроенные изображения не сохраняются после отправки результата, отмены или истечения срока запроса.
Список API
- Общие параметры и объекты результата
- Создание запроса помощи
LCC.assist.create() - Ожидание результата помощи
LCC.assist.wait() - Создание запроса и ожидание
LCC.assist.request() - Запрос текстового ответа
LCC.assist.ask_text() - Запрос выбора координат
LCC.assist.pick_point() - Запрос удалённого управления
LCC.assist.request_control() - Отмена указанного запроса
LCC.assist.cancel() - Отмена запросов текущего скрипта
LCC.assist.cancel_all()