PHONEFARM LAB

QuickMirror API: подключение и команды

Локальный WebSocket-интерфейс: список устройств, снимки экрана, ввод и работа с буфером обмена.

Редакция PHONE FARM LABОбновлено 1 мин чтения

API работает через WebSocket на компьютере с QuickMirror. Для доступа требуется вход в аккаунт с подходящими условиями лицензии. Адрес подключения: ws://127.0.0.1:33332.

Подключение

Запустите QuickMirror, войдите в аккаунт и подключите телефон. Отправляйте JSON-сообщения на локальный WebSocket-адрес. Поле StatusCode в ответе показывает результат выполнения.

ws://127.0.0.1:33332

Получить список телефонов

Команда list возвращает deviceId, имя и номер устройства. Используйте полученный deviceId для работы с конкретным телефоном.

{
  "action": "list"
}

Сохранить снимок экрана

В comm.deviceIds укажите идентификатор телефона, несколько идентификаторов через запятую или all для всех. savePath — папка на компьютере. onlyDeviceName: 1 оставляет в имени файла только идентификатор; 0 добавляет время.

{
  "action": "screen",
  "comm": {
    "deviceIds": "DEVICE_ID",
    "savePath": "d:/quickmirror",
    "onlyDeviceName": 1
  }
}

Касание и движение

PointerEvent принимает координаты x и y от 0 до 1 относительно ширины и высоты экрана. Для касания отправьте нажатие mask: 0 и отпускание mask: 2 в той же точке. Для движения между ними используется mask: 1. Сначала проверяйте команду на одном устройстве.

{
  "action": "PointerEvent",
  "comm": {
    "deviceIds": "DEVICE_ID",
    "mask": "0",
    "x": "0.5",
    "y": "0.5"
  }
}

Буфер обмена

getclipboard читает буфер одного устройства: несколько идентификаторов здесь не поддерживаются. writeclipboard передаёт текст в поле content и поддерживает несколько устройств.

{
  "action": "writeclipboard",
  "comm": {
    "deviceIds": "DEVICE_ID",
    "content": "Тестовый текст"
  }
}

Команды ADB

Команда adb принимает строку command и список deviceIds. Ответ содержит результат для каждого устройства. Не открывайте локальный управляющий порт в интернет; удалённое управление организуйте через защищённый доступ к компьютеру.

Файлы и программы

О материале и полезные ссылки

Инструкция по документации программы. Названия элементов могут отличаться между версиями и языками интерфейса.

Нужна помощь с вашей фермой?

Напишите модель оборудования и что хотите настроить.

Дальше по теме

QuickMirror: подключение и работа с телефонамиQuickMirror