Отправка команд с консоли эмулятора

Каждое запущенное виртуальное устройство предоставляет консоль, которая позволяет запрашивать и контролировать эмулируемую среду устройства. Например, с помощью консоли можно управлять перенаправлением портов, характеристиками сети и событиями телефонии во время работы приложения в эмуляторе.

Для выполнения следующих команд у вас уже должен быть запущен эмулятор. Подробную информацию о работе с эмулятором можно найти в статьях Запуск приложений в эмуляторе Android и Запуск эмулятора из командной строки.

Как начать и завершить сеанс в консоли

Чтобы получить доступ к консоли и вводить команды из окна терминала, подключитесь к порту консоли по протоколу Telnet и укажите токен аутентификации. Когда в консоли появляется надпись OK, это означает, что она готова к приему команд. Типичного запроса не существует.

Чтобы подключиться к консоли работающего виртуального устройства, выполните следующие действия:

  1. Откройте окно терминала и введите следующую команду:

    telnet localhost console-port
    

    Номер порта консоли указывается в заголовке окна эмулятора, если он запущен в отдельном окне, но не в окне инструмента. Например, заголовок окна для эмулятора, использующего порт консоли 5554, может быть Pixel8_API_34:5554. Кроме того, команда adb devices выводит список запущенных виртуальных устройств и номера их портов консоли. Подробнее о запросах для устройств…

    Примечание. Эмулятор прослушивает подключения на портах с 5554 по 5585 и принимает подключения только от localhost.

  2. Когда в консоли появится сообщение OK, введите команду auth auth_token.

    Прежде чем вводить команды консоли, эмулятор консоли требует аутентификации. auth_token должно совпадать с содержимым файла .emulator_console_auth_token в вашем домашнем каталоге.

    Если такого файла нет, команда telnet localhost console-port создаст его и добавит в него случайно сгенерированный токен аутентификации. Чтобы отключить аутентификацию, удалите токен из файла .emulator_console_auth_token или создайте пустой файл, если он не существует.

  3. После подключения к консоли введите команды консоли.

    Введите help, help command или help-verbose, чтобы посмотреть список команд консоли и узнать о них больше.

  4. Чтобы выйти из сеанса консоли, введите quit или exit.

Вот пример сеанса:

$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
    help|h|?         Prints a list of commands
    help-verbose     Prints a list of commands with descriptions
    ping             Checks if the emulator is alive
    automation       Manages emulator automation
    event            Simulates hardware events
    geo              Geo-location commands
    gsm              GSM related commands
    cdma             CDMA related commands
    crash            Crashes the emulator instance
    crash-on-exit    Simulates crash on exit for the emulator instance
    kill             Terminates the emulator instance
    restart          Restarts the emulator instance
    network          Manages network settings  (ethernet and cellular only)
    power            Power related commands
    quit|exit        Quits control session
    redir            Manages port redirections
    sms              SMS related commands
    avd              Controls virtual device execution
    qemu             QEMU-specific commands
    sensor           Manages emulator sensors
    physics          Manages physical model
    finger           Manages emulator finger print
    debug            Controls the emulator debug output tags
    rotate           Rotates the screen clockwise by 90 degrees
    screenrecord     Records the emulator's display
    fold             Folds the device
    unfold           Unfolds the device
    multidisplay     Configures the multi-display
    nodraw           turn on/off NoDraw mode. (experimental)
    resize-display   resize the display resolution to the preset size
    virtualscene-image  customize virtualscene image for virtulscene camera
    proxy            manage network proxy server settings
    phonenumber      set phone number for the device

try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.

Команды, не требующие ответа

Если вам не нужно, чтобы сеанс оставался открытым, используйте сокращение adb emu, которое выполняет команду и сразу же возвращает управление вызывающей оболочке:

adb emu command commandParameter

Вызов с помощью adb emu подключается к доступному эмулятору. Если у вас одновременно запущено несколько эмуляторов, необходимо передать серийный номер нужного эмулятора:

adb -s emulator-serial emu command commandParameter

Справочник по командам эмулятора

Ниже перечислены команды консоли эмулятора с их параметрами и значениями.

Общие команды

  • avd {stop| start| status| name} Запрашивает, контролирует и управляет виртуальным устройством следующим образом:

    • stop – останавливает выполнение задачи.
    • start – запуск устройства.
    • status – запрашивает статус виртуального устройства (может быть "работает" или "остановлено");
    • name – запрашивает название виртуального устройства.
  • avd snapshot {list| save name| load name| delete name} Сохраняет и восстанавливает состояние устройства в виде снимков следующим образом:

    • list – показывает все сохраненные снимки.
    • save name – сохраняет снимок под указанным именем.
    • load name – загрузить снимок с указанным названием.
    • delete name – удаляет снимок с указанным названием.

    В следующем примере сохраняется снимок с названием firstactivitysnapshot:

    avd snapshot save firstactivitysnapshot
    
  • fold – складывает устройство, чтобы показать его в конфигурации с меньшим экраном, если устройство складное и в данный момент разложено.

  • unfold – разворачивает устройство, чтобы показать его экран в разложенном виде (если устройство складное и в данный момент сложено).

  • kill – завершает работу виртуального устройства.

  • ping – проверяет, работает ли виртуальное устройство.

  • rotate – поворачивает изображение против часовой стрелки с шагом 45 градусов.

Как вызвать сбой эмулятора

  • crash – сбой эмулятора во время работы приложения;

  • crash-on-exit – при выходе из приложения происходит сбой эмулятора.

Отладка тегов

  • debug tags ... – включает или отключает сообщения отладки из определенных частей эмулятора. Параметр tags должен быть значением из списка тегов отладки, который появляется при выполнении emulator -help-debug-tags. Дополнительную информацию о параметре -help-debug-tags можно найти в таблице часто используемых параметров. В примере ниже показано, как включить тег радио.

    debug radio
    

Переадресация портов

  • redir list – показывает текущие перенаправления портов.

  • redir add protocol:host-port:guest-port Добавляет новое перенаправление портов:

    • protocol – tcp или udp.
    • host-port – номер порта, который нужно открыть на хосте.
    • guest-port – номер порта для маршрутизации данных в эмуляторе.
  • redir del protocol:host-port Удаляет перенаправление портов.

    • protocol – tcp или udp.
    • host-port – номер порта, который нужно открыть на хосте.

Географическое местоположение

Задает географическое местоположение, которое передается приложениям, запущенным в эмуляторе, путем отправки в эмулятор GPS-координат.

После запуска виртуального устройства можно выполнить одну из следующих команд: Эмулятор задает указанное вами местоположение, создавая фиктивный поставщик данных о местоположении. Этот поставщик отвечает на запросы слушателей местоположения, заданные приложениями, и передает местоположение в LocationManager. Любое приложение может запросить у менеджера местоположения текущие координаты GPS для эмулируемого устройства, вызвав метод LocationManager.getLastKnownLocation("gps").

  • geo fix longitude latitude [altitude] [satellites] [velocity] – отправляет в эмулятор GPS-координаты. Укажите долготу и широту в десятичных градусах. Укажите число от 1 до 12, чтобы задать количество спутников, которые будут использоваться для определения местоположения, а также высоту в метрах и скорость в узлах.

  • geo nmea sentence – отправляет на эмулируемое устройство строку NMEA 0183, как если бы она была отправлена с эмулируемого GPS-модема. Начните предложение с "$GP". В настоящее время поддерживаются только предложения $GPGGA и $GPRCM. Ниже приведен пример предложения GPGGA (Global Positioning System Fix Data), которое получает время, местоположение и данные о фиксации для GPS-приемника:

    geo nmea $GPGGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx
    

Имитация аппаратных событий

Подсистема аппаратных событий в консоли эмулятора позволяет имитировать практически любое физическое взаимодействие с устройством. К ним относятся физические кнопки, сенсорный экран, жесты, поворотные переключатели, джойстики и аппаратные переключатели.

  • event types: список всех типов фиктивных событий. Если у события есть коды, их количество указано в скобках справа. Пример выходных данных:

    event types
    event <type> can be an integer or one of the following aliases:
        EV_SYN
        EV_KEY    (405 code aliases)
        EV_REL    (2 code aliases)
        EV_ABS    (27 code aliases)
        EV_MSC
        EV_SW     (4 code aliases)
        EV_LED
        EV_SND
        EV_REP
        EV_FF
        EV_PWR
        EV_FF_STATUS
        EV_MAX
    OK
    
  • event send types [types ...] – отправляет один или несколько типов фиктивных событий.

  • event codes type – коды событий для указанного типа фиктивного события.

  • event send type[:code]:[value] [...] – отправляет одно или несколько фиктивных событий с необязательными кодами и значениями кодов.

EV_KEY — Key Code References

Тип события EV_KEY используется для имитации нажатия и отпускания кнопок. В таблицах ниже приведены коды клавиш, разделенные по категориям. Для каждого кода клавиши значение 1 имитирует нажатие, а значение 0 – отпускание. Значение 2 соответствует повторному нажатию клавиши.

Дополнительная таблица А. Ключи системы Android
Код Описание
KEY_HOME Триггер кнопки главного экрана
KEY_BACK Триггер кнопки "Назад"
KEY_MENU Кнопка меню (дополнительное меню)
KEY_POWER Кнопка питания (нажатие/долгое нажатие)
KEY_VOLUMEUP Триггер кнопки увеличения громкости
KEY_VOLUMEDOWN Триггер кнопки уменьшения громкости
KEY_CAMERA Физическая кнопка спуска затвора
KEY_FOCUS Автофокус камеры
KEY_SEARCH Триггер кнопки поиска
KEY_SLEEP Триггер команды перехода в спящий режим
KEY_WAKEUP Триггер команды выхода из спящего режима
KEY_NOTIFICATION Открыть панель уведомлений
KEY_MUTE Отключить вывод системного звука
KEY_MICMUTE Отключить микрофон
KEY_BRIGHTNESSDOWN Уменьшить яркость экрана
KEY_BRIGHTNESSUP Увеличить яркость экрана
KEY_PHONE Открыть приложение для звонков по умолчанию
KEY_SEND Отправка или инициирование телефонного звонка
KEY_HEADSETHOOK Кнопка на гарнитуре (ответить/повесить трубку)
KEY_SCREEN Команда для активации заставки
KEY_CONFIG Меню настроек системы
KEY_SWITCHVIDEOMODE Переключить режим видео в системе
KEY_KBDILLUMTOGGLE Включить или отключить подсветку клавиатуры
Таблица B. Элементы управления воспроизведением медиаконтента
Код Описание
KEY_PLAYPAUSE Переключить воспроизведение и паузу
KEY_PLAY Запустить воспроизведение медиаконтента
KEY_PAUSECD Приостановить воспроизведение CD
KEY_STOPCD Остановить воспроизведение CD
KEY_NEXTSONG Перейти к следующему треку
KEY_PREVIOUSSONG Перейти к предыдущему треку
KEY_REWIND Перемотать активный трек
KEY_FASTFORWARD Перемотать текущий трек вперед
KEY_RECORD Записать команду триггера
KEY_SHUFFLE Включить или отключить перемешивание
KEY_REPEAT Включить или отключить повторное воспроизведение
KEY_MEDIA Триггер мультимедийной клавиши
Подтаблица C. Навигация и общие сочетания клавиш
Код Описание
KEY_UP D-pad — вверх
KEY_DOWN D-pad — вниз
KEY_LEFT D-pad — влево
KEY_RIGHT D-pad: вправо
KEY_PAGEUP Переход на страницу вверх
KEY_PAGEDOWN Переход на страницу вниз
KEY_INSERT Вставить триггер клавиши
KEY_DELETE Удалить триггер клавиши
KEY_ENTER Триггер клавиши Ввод
KEY_ESC Триггер клавиши Escape
KEY_TAB Триггер клавиши Tab
KEY_SPACE Триггер клавиши "Пробел"
KEY_BACKSPACE Триггер клавиши Backspace
KEY_CLEAR Очистить буфер ввода
KEY_CANCEL Отменить активное действие
KEY_OK Подтвердить выбор
KEY_SELECT Триггер выбора объекта
KEY_GOTO Перейти к назначенному месту
KEY_HELP Доступ к контекстной справке
Таблица D. Буквенно-цифровые символы и символы клавиатуры
  • Стандартные буквы алфавита: от KEY_A до KEY_Z (26 кодов).
  • Клавиши цифровой клавиатуры: от KEY_1 до KEY_0 (10 кодов).
Код Символ персонажа
KEY_COMMA ,
KEY_DOT .
KEY_SLASH /
KEY_SEMICOLON ;
KEY_APOSTROPHE '
KEY_GRAVE \`
KEY_MINUS -
KEY_EQUAL =
KEY_LEFTBRACE [
KEY_RIGHTBRACE ]
KEY_BACKSLASH \
KEY_KPASTERISK * (цифровая клавиатура)
KEY_KPPLUS + (цифровая клавиатура)
KEY_KPMINUS - (цифровая клавиатура)
KEY_KPDOT . (цифровая клавиатура)
KEY_KPSLASH / (цифровая клавиатура)
KEY_KPENTER Ввод (цифровая клавиатура)
KEY_KPEQUAL = (цифровая клавиатура)
KEY_KPCOMMA , (цифровая клавиатура)
KEY_KPJPCOMMA , (японская раскладка)
KEY_KPLEFTPAREN ( (цифровая клавиатура)
KEY_KPRIGHTPAREN ) (цифровая клавиатура)
KEY_KPPLUSMINUS ± (цифровая клавиатура)
Подтаблица E: клавиши-модификаторы и функциональные клавиши
  • Стандартные функциональные клавиши: от KEY_F1 до KEY_F24 (24 кода).
Код Описание
KEY_LEFTSHIFT Модификатор клавиатуры Left Shift
KEY_RIGHTSHIFT Правая клавиша Shift
KEY_LEFTCTRL Левая клавиша Ctrl
KEY_RIGHTCTRL Правая клавиша-модификатор Ctrl
KEY_LEFTALT Левая клавиша-модификатор Alt
KEY_RIGHTALT Правая клавиша Alt
KEY_LEFTMETA Левая клавиша Meta/Command
KEY_RIGHTMETA Правая клавиша Meta/Command
KEY_CAPSLOCK Переключатель Caps Lock на клавиатуре
KEY_NUMLOCK Переключатель Num Lock
KEY_SCROLLLOCK Переключатель Scroll Lock на клавиатуре
KEY_COMPOSE Помощник по созданию персонажей
KEY_FN Клавиша Fn на физической клавиатуре
KEY_FN_ESC Сочетания функциональных клавиш
KEY_FN_1 Быстрая клавиша для специальной функции 1
KEY_FN_2 Специальная функция 2
KEY_FN_D Сочетание клавиш для специальной функции D
KEY_FN_E Специальная функция E
KEY_FN_F Специальная функция F
KEY_FN_S Быстрая клавиша S для специальной функции
KEY_FN_B Специальная функция 2
Дополнительная таблица F. Геймпады и джойстики
Код Описание
BTN_A/BTN_B/BTN_C Кнопки A, B и C на контроллере
BTN_X/BTN_Y/BTN_Z Кнопки X, Y и Z на лицевой стороне контроллера
BTN_START Кнопка меню "Пуск" на геймпаде
BTN_SELECT Кнопка Select на геймпаде
BTN_MODE Переключатель режима контроллера
BTN_TL/BTN_TR Левый и правый бамперы
BTN_TL2/BTN_TR2 Левый и правый аналоговые триггеры
BTN_THUMBL/BTN_THUMBR Нажатие левого/правого стика
BTN_DPAD_UP Триггер "Кнопка "Вверх" на d-pad геймпада"
BTN_DPAD_DOWN Триггер "Кнопка "Вниз" на d-pad геймпада"
BTN_DPAD_LEFT Левый триггер D-pad на геймпаде
BTN_DPAD_RIGHT Правый триггер на d-pad геймпада
BTN_THUMB Основной триггер джойстика
BTN_TOP/BTN_TOP2 Верхние кнопки джойстика
BTN_PINKIE Триггеры кнопки джойстика для мизинца
BTN_BASE – _BASE6 Кнопки на основании платформы джойстика
BTN_DEAD Флаг неактивной мертвой зоны геймпада
BTN_TRIGGER Физический триггер на джойстике
BTN_JOYSTICK Общий код ввода джойстика
Дополнительная таблица G. Ввод с помощью мыши, сенсорного экрана и стилуса
Код Описание
BTN_MOUSE Общее событие указателя мыши
BTN_LEFT Нажатие левой кнопки мыши
BTN_RIGHT Нажатие правой кнопки мыши
BTN_MIDDLE Нажатие на колесо прокрутки
BTN_SIDE Триггер боковой клавиши навигации
BTN_EXTRA Триггер дополнительной кнопки мыши
BTN_FORWARD нажатие кнопки "Вперед" в браузере;
BTN_BACK нажать кнопку "Назад" в браузере
BTN_TASK Клавиша переключения задач
BTN_TOUCH Обнаружен физический контакт с экраном
BTN_STYLUS Близость активного стилуса
BTN_STYLUS2 Дополнительная кнопка на стилусе
BTN_TOOL_PEN Идентификатор инструмента стилуса
BTN_TOOL_RUBBER Идентификатор ластика стилуса
BTN_TOOL_BRUSH Идентификатор инструмента "Кисть"
BTN_TOOL_PENCIL Идентификатор инструмента "Карандаш для черчения"
BTN_TOOL_AIRBRUSH Идентификатор инструмента "Аэрограф"
BTN_TOOL_FINGER Касание сенсорного экрана пальцем
BTN_TOOL_MOUSE Идентификатор внешней мыши
BTN_TOOL_LENS Инструмент "Оптическая лупа"
BTN_TOOL_DOUBLETAP Параметр скорости двойного нажатия для жестов
BTN_TOOL_TRIPLETAP Параметр скорости тройного нажатия
Подтаблица H. Ярлыки приложений
Код Целевое действие
KEY_WWW Запускает браузер по умолчанию.
KEY_MAIL Открывает почтовый клиент по умолчанию
KEY_BOOKMARKS Открыть список закладок браузера
KEY_CALC Открыть калькулятор
KEY_FILE Открывает проводник по локальным файлам
KEY_EDIT Триггер редактирования документа
KEY_NEW Триггер создания документа
KEY_OPEN Триггер открытия документа
KEY_SAVE Триггер задачи сохранения файла
KEY_CLOSE Триггер задачи закрытия файла
KEY_PRINT Триггер задачи печати файла
KEY_COPY Копирование в буфер обмена
KEY_PASTE Действие по вставке из буфера обмена
KEY_CUT Действие по вырезанию в буфер обмена
KEY_UNDO Отмена действия с буфером обмена
KEY_REDO Повторить действие с буфером обмена
KEY_CANCEL Триггер отмены процесса буферизации
KEY_FIND Утилита для поиска документов
KEY_REFRESH Утилита обновления документов
KEY_EXIT Утилита для закрытия документов
KEY_DOCUMENTS Запускает портал системных документов
KEY_HOMEPAGE Запускает браузер на главной странице
KEY_FAVORITES Открывает портал избранного в браузере
KEY_CHAT Запускает мессенджер
KEY_EMAIL Триггер запуска дополнительного адреса электронной почты
KEY_FINANCE Открыть утилиту для работы с акциями и финансами
KEY_SPORT Открыть утилиту для отслеживания спортивных событий
KEY_SHOP Открыть портал цифровых покупок
KEY_PLAYER Открыть основной медиапроигрыватель
KEY_MP3 Открыть основной MP3-плеер
KEY_TEXT Открыть текстовый редактор по умолчанию
KEY_LIST Открыть контрольный список
KEY_MEMO Открыть блокнот или заметки
KEY_CALENDAR Открывает календарь или повестку дня
KEY_DIRECTORY Открывает системный каталог адресов
KEY_COMPUTER Открыть спецификации
KEY_TV/KEY_TV2 Запуск телевизионного портала
KEY_RADIO Запускает радио.
KEY_CD/KEY_DVD Активирует оптический привод
KEY_AUDIO/KEY_VIDEO Доступ к спецификациям медиаконтента
KEY_TUNER Настройка ресиверов и тюнеров
KEY_SAT/KEY_SAT2 Настройка спутниковых фидов
KEY_TAPE Включить кассетную деку
KEY_VCR Воспроизвести фид проигрывателя VCR
KEY_VCR2 Воспроизвести фид проигрывателя VCR 2
KEY_AUX Входы вспомогательных портов для носителей
KEY_SETUP Меню настройки конфигурации
KEY_PROG1 – _PROG4 Пользовательские ключи программ
KEY_ZOOM Переключатель масштаба области просмотра
KEY_MODE Выбор режима области просмотра
KEY_KEYBOARD Показать/скрыть виртуальную клавиатуру
KEY_LANGUAGE Как изменить язык аудиодорожки
KEY_TITLE Открыть меню названия медиафайла
KEY_SUBTITLE Открыть или закрыть интерфейс субтитров
KEY_ANGLE Как изменить ракурс камеры
KEY_EPG Открыть телегид
KEY_PVR Открыть персональный видеорекордер
KEY_MHP Открытая мультимедийная платформа для дома
KEY_CHANNEL Открыть каналы ТВ-тюнера
KEY_CHANNELUP Переключить на следующий телеканал
KEY_CHANNELDOWN Переключить на предыдущий телеканал
KEY_RED Красная интерактивная кнопка
KEY_GREEN Интерактивная кнопка зеленого цвета.
KEY_YELLOW Желтая интерактивная кнопка
KEY_BLUE Синяя интерактивная кнопка
KEY_FIRST Выберите первый вариант товара
KEY_LAST Выбрать последний вариант
KEY_NEXT Выбрать следующий вариант звуковой дорожки
KEY_PREVIOUS Выбрать предыдущую звуковую дорожку
KEY_RESTART Перезапустить цикл медиатрека
KEY_SLOW Замедленное воспроизведение
KEY_AB Повтор фрагмента от точки А до точки Б
KEY_PLAYCD Команда воспроизведения CD-деки
KEY_PAUSECD Команда приостановки воспроизведения на CD-деке
KEY_STOPCD Команда остановки CD-деки
KEY_DIGITS Команда ввода с цифровой клавиатуры
KEY_TEEN Вариант "Значения для подростков" на клавиатуре
KEY_TWEN Вариант значений клавиатуры twen
KEY_DEL_EOL Удалить до конца буфера строки
KEY_DEL_EOS Удалить до конца буфера экрана
KEY_INS_LINE Вставить буфер новой строки
KEY_BRL_DOT1 – _DOT8 Ввод с помощью кнопок дисплея Брайля
KEY_VOICECOMMAND Запускает приложение голосового помощника.
KEY_SELECTIVE_SCREEN Запускает создание скриншота области экрана
KEY_BATTERY Запрашивает уведомления о состоянии батареи.
KEY_STAR/KEY_SHARP Символы на клавиатуре телефона
KEY_PLUS Символ плюса на клавиатуре телефона
KEY_INFO Показать оверлей информационной панели
KEY_TIME Показывать текущее время
KEY_VENDOR Запрашивает спецификации поставщиков
KEY_ARCHIVE Открывает локальный архиватор
KEY_PROGRAM Настраивает параметры программы
KEY_POWER2 Включает резервное питание

EV_ABS – события абсолютного движения.

Тип события EV_ABS необходим для точной симуляции касаний, перетаскивания, жестов сведения и разведения пальцев, а также управления джойстиком. Абсолютные координаты, указанные ниже, напрямую соответствуют физическому разрешению экрана.

Код Диапазон координат Описание
ABS_MT_TRACKING_ID -1 или ≥0 Идентификатор отслеживания; -1 завершает касание
ABS_MT_POSITION_X 0 – 1767 Координата X (Pixel Fold)
ABS_MT_POSITION_Y 0 – 2207 Координата Y (Pixel Fold)
ABS_MT_TOUCH_MAJOR пиксели Ширина главной оси области касания
ABS_MT_TOUCH_MINOR пиксели Ширина малой оси области касания
ABS_MT_WIDTH_MAJOR пиксели Ширина большой оси инструмента
ABS_MT_WIDTH_MINOR пиксели Ширина малой оси инструмента
ABS_MT_ORIENTATION 0 – 255 Угол ориентации контакта
ABS_MT_PRESSURE 0 – 255 Величина силы контакта
ABS_MT_DISTANCE mm Расстояние от экрана
ABS_MT_TOOL_TYPE 0 – 2 0 – палец, 1 – ручка, 2 – карандаш
ABS_MT_BLOB_ID Целое число Идентификатор объекта blob контакта
ABS_MT_TOOL_X пиксели Координата X инструмента
ABS_MT_TOOL_Y пиксели Координата Y инструмента
ABS_MT_SLOT 0 – N Активный слот (протокол B)
ABS_X/_Y/_Z аналоговый Оси координат джойстика
ABS_RX/_RY/_RZ аналоговый Оси вращения джойстика
ABS_THROTTLE/_BRAKE аналоговый Педали и рулевое управление
ABS_HAT0X/_HAT0Y -1/0/1 Кнопки D-pad и переключатели POV
ABS_PRESSURE 0 – 255 Сила нажатия стилуса или указателя
ABS_DISTANCE mm Расстояние наведения (стилус)
ABS_TILT_X/_TILT_Y градусы Углы наклона стилуса
ABS_VOLUME аналоговый Уровни громкости контроллера

Сенсорное взаимодействие в Android основано на протоколах мультисенсорного ввода. Современные эмуляторы реализуют как протокол A (без отслеживания состояния, отправка пакетов контактов, разделенных метками синхронизации), так и протокол B (с отслеживанием состояния, назначение контактов выделенным слотам отслеживания). Протокол B позволяет эффективно отслеживать несколько одновременных касаний для таких жестов, как масштабирование.

EV_REL и EV_SW – движение и аппаратные переключатели

Категория событий EV_REL управляет относительными изменениями указателя или координат, что в основном используется для эмуляции движений внешней мыши или колесика прокрутки. Категория событий EV_SW управляет переключателями физических устройств, например определяет, сложен ли раскладной телефон или планшет, или подключено ли внешнее аудиооборудование.

Код Значения Описание
REL_X Delta Горизонтальное движение курсора
REL_Y Delta Вертикальное движение курсора
SW_LID 0/1 Статус крышки ноутбука (0 – открыта, 1 – закрыта)
SW_TABLET_MODE 0/1 Статус режима планшета (0 – отключен, 1 – активен).
SW_HEADPHONE_INSERT 0/1 Статус гнезда для наушников (0 – не подключено, 1 – подключено)
SW_MICROPHONE_INSERT 0/1 Статус разъема для микрофона (0 – не подключен, 1 – подключен)
Синтаксис отправки команд

Чтобы отправить эти коды, отформатируйте команду консоли, указав типы, коды и значения, разделенные двоеточиями. В одной строке можно указать несколько изменений координат. Важно всегда добавлять в конце метку синхронизации (EV_SYN:0:0), чтобы фреймворк эмулятора объединял и обрабатывал эти входные данные вместе.

Примеры скриптов событий и жестов

Поскольку Telnet позволяет отправлять составные параметры, вы можете имитировать реалистичные последовательности физических жестов. Ниже приведены структуры скриптов необработанных событий для автоматизации жестов из консоли хоста.

Имитация нажатия на экран

Чтобы выполнить нажатие на экран по целевым координатам, назначьте идентификатор отслеживания, укажите координаты X и Y на экране, сымитируйте касание, синхронизируйте и отпустите.

# Press down at coordinate (400, 800) and sync
event send EV_ABS:ABS_MT_TRACKING_ID:1
OK
event send EV_ABS:ABS_MT_POSITION_X:400
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Lift finger up and sync
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
Как имитировать вертикальную прокрутку (пролистывание)

Чтобы выполнить прокрутку, удерживайте палец на начальной координате, отправьте промежуточные кадры координат движения и отпустите палец в конце.

# Finger touch down at start coordinate (500, 1600)
event send EV_ABS:ABS_MT_TRACKING_ID:2
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1600
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Move coordinates upward dynamically
event send EV_ABS:ABS_MT_POSITION_Y:1200
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:400
OK
event send EV_SYN:0:0
OK
# Finger release at coordinate (500, 400)
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
Имитация жеста сведения пальцев

Чтобы активировать масштабирование двумя пальцами, используйте активные слоты MT (0 и 1) для отслеживания и координации двух одновременных координат касания, удаляющихся друг от друга.

# Finger 1 down at (500, 1000) using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:10
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Finger 2 down at (600, 1000) using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:11
OK
event send EV_ABS:ABS_MT_POSITION_X:600
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_SYN:0:0
OK
# Fingers slide apart from each other
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_POSITION_X:300
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_POSITION_X:800
OK
event send EV_SYN:0:0
OK
# Lift Finger 1 using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_SYN:0:0
OK
# Lift Finger 2 using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK
Как имитировать переключение наушников

Имитирует подключение и отключение гнезда для наушников, чтобы проверить переключение маршрутизации аудио. Значение 1 означает, что наушники подключены, а 0 – что они отключены.

# Simulate headphones plugged in
event send EV_SW:SW_HEADPHONE_INSERT:1 EV_SYN:0:0
OK
# Simulate headphones unplugged
event send EV_SW:SW_HEADPHONE_INSERT:0 EV_SYN:0:0
OK
Как найти коды событий консоли на реальном устройстве

Чтобы узнать точную последовательность синтаксиса событий для любого настраиваемого действия или жеста кнопки, подключитесь с помощью adb shell и запустите утилиту диагностики getevent. При взаимодействии с графическим интерфейсом эмулятора в консоли будут выводиться точные коды, типы и позиции событий.

# Run getevent to monitor input events dynamically
adb shell getevent -lt
/dev/input/event12: EV_KEY       KEY_POWER            DOWN
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
/dev/input/event12: EV_KEY       KEY_POWER            UP
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
  • event text message – отправляет строку символов, имитирующих нажатия клавиш. Сообщение должно быть строкой в кодировке UTF-8. Записи Unicode сопоставляются в обратном порядке в соответствии с текущей клавиатурой устройства, а неподдерживаемые символы удаляются без уведомления.

Управление питанием

  • power display – показывает состояние батареи и зарядного устройства.

  • power ac {on| off} – включает или отключает зарядку от сети переменного тока.

  • power status {unknown| charging| discharging| not-charging| full} – изменяет статус батареи на указанный.

  • power present {true| false} – задает состояние наличия батареи.

  • power health {unknown| good| overheat| dead| overvoltage| failure} – задает состояние батареи.

  • power capacity percent – устанавливает состояние оставшейся емкости батареи в процентах от 0 до 100.

Статус сетевого подключения (только Ethernet и мобильная сеть).

  • network status – проверяет статус сети, текущую задержку и скорость.

  • network delay latency Изменяет эмулируемую задержку сети.

    Эмулятор позволяет имитировать различные уровни задержки сети, чтобы вы могли протестировать приложение в условиях, приближенных к реальным. Вы можете задать уровень или диапазон задержки при запуске эмулятора или изменить задержку в консоли во время работы приложения в эмуляторе.

    Формат задержки сети может быть одним из следующих (числа указаны в миллисекундах):

    Формат задержки в сети:

  • gprs – GPRS, диапазон задержки от 150 до 550.

  • edge – EDGE/EGPRS, задержка от 80 до 400.

  • umts – UMTS/3G, диапазон задержки от 35 до 200.

  • none – задержка отсутствует.

  • num – эмулирует указанную задержку в миллисекундах.

  • min:max – эмулирует указанный диапазон задержки.

    Чтобы задать задержку при запуске эмулятора, используйте параметр -netdelay с поддерживаемым значением задержки. Примеры:

    emulator -netdelay gprs
    emulator -netdelay 40,100
    

    Чтобы изменить задержку сети во время работы эмулятора, подключитесь к консоли и используйте команду network delay:

    network delay gprs
    network delay 40 100
    
  • network speed speed Эмулятор позволяет имитировать различные скорости передачи данных по сети. Вы можете задать скорость передачи данных или диапазон при запуске эмулятора или использовать консоль, чтобы изменить скорость во время работы приложения в эмуляторе.

    Формат скорости сети может быть одним из следующих (числа указаны в килобитах в секунду):

    Формат скорости сети:

  • gsm – GSM/CSD со скоростью 14, 4 Мбит/с в обоих направлениях.

  • hscsd – HSCSD со скоростью 14,4 Мбит/с для исходящего трафика и 43,2 Мбит/с для входящего.

  • gprs – GPRS со скоростью 40,0 Кбит/с для исходящего трафика и 80,0 Кбит/с для входящего.

  • edge – EDGE/EGPRS со скоростью 118,4 Кбит/с для исходящего трафика и 236,8 Кбит/с для входящего.

  • umts – UMTS/3G со скоростью 128, 0 Кбит/с для исходящего трафика и 1920 Кбит/с для входящего.

  • hsdpa: HSDPA, скорость передачи данных – 348,0 Кбит/с, скорость скачивания – 14 400,0 Кбит/с.

  • lte – LTE со скоростью 58 000 Кбит/с для загрузки и 173 000 Кбит/с для скачивания.

  • evdo – EVDO со скоростью 75 000 бит/с для исходящего трафика и 280 000 бит/с для входящего.

  • full – неограниченная скорость, которая зависит от скорости подключения компьютера к интернету.

  • num – точная скорость в килобитах в секунду, которая используется как для загрузки, так и для скачивания.

  • up:down – задает точные значения скорости загрузки и скачивания в килобитах в секунду.

    Чтобы задать скорость сети при запуске эмулятора, используйте параметр -netspeed. Примеры:

    emulator -netspeed gsm @Pixel_API_26
    emulator -netspeed 14.4,80 @Pixel_API_26
    

    Чтобы изменить скорость сети во время работы эмулятора, подключитесь к консоли и используйте команду network speed:

    network speed 14.4 80
    
  • network capture {start| stop} file Отправляет пакеты в файл. Ниже приведены параметры и их значения.

    Примечание. Начиная с эмулятора Android 36.5 и более поздних версий, трафик Wi-Fi-подключения по умолчанию обрабатывается netsim. Команда консоли для записи сетевого трафика записывает только устаревший трафик сотовой сети/WAN, маршрутизируемый через стек slirp QEMU. Чтобы записать пакеты Wi-Fi, Bluetooth или расширенной сети в современных версиях эмулятора, ознакомьтесь с разделом Запись сетевого трафика в руководстве по расширенным сетевым возможностям эмулятора.

  • start file – начать перехват сетевых пакетов. В целях безопасности название файла не должно содержать разделителей пути, таких как /, и символов ... Файл с данными о перехвате пакетов будет сохранен в папке console_out/ в каталоге контента AVD (например, ~/.android/avd/avd_name.avd/console_out/file).

  • stop file – прекратить отправку пакетов в указанный файл.

Эмуляция телефонии

Эмулятор Android включает собственные эмулируемые модемы GSM и CDMA, которые позволяют имитировать функции телефонии в эмуляторе. Например, с помощью GSM можно имитировать входящие телефонные звонки, а также устанавливать и разрывать подключения для передачи данных. Для CDMA нужно указать источник подписки и предпочтительный список роуминга. Система Android обрабатывает смоделированные вызовы точно так же, как и реальные. Эмулятор не поддерживает аудиовызовы.

  • gsm {call| accept| cancel| busy} phonenumber Параметры gsm:

    • call – имитирует входящий звонок с указанного номера.
    • accept – принимает входящий вызов с номера phonenumber и меняет статус вызова на active. Вы можете изменить статус вызова на активный, только если текущий статус – "Ожидание" или "Удержание".
    • cancel – завершает входящий или исходящий звонок на номер phonenumber.
    • busy – завершает исходящий вызов на номер телефона и меняет статус вызова на "Занято". Изменить статус вызова на "Занято" можно, только если текущий статус – "Ожидание".
  • gsm {data| voice} state Команда data state изменяет состояние подключения для передачи данных GPRS, а команда voice state – состояние подключения для передачи голоса GPRS.

    • unregistered – сеть недоступна.
    • home – устройство находится в домашней сети, роуминг не используется.
    • roaming – роуминг.
    • searching – поиск сетей.
    • denied – только экстренные вызовы.
    • off – то же, что и unregistered.
    • on – то же, что и home.
  • gsm hold – переводит вызов в режим удержания. Перевести вызов в режим удержания можно, только если он активен или находится в режиме ожидания.

  • gsm list – список всех входящих и исходящих вызовов и их статусов.

  • gsm status – сообщает текущий статус голосовой связи и передачи данных GSM. Значения соответствуют описанным для команд передачи голоса и данных.

  • gsm signal {rssi| ber} Изменяет уровень сигнала (rssi) и частоту появления ошибочных битов (ber) в течение следующих 15 секунд. Ниже приведены параметры и их значения.

    • rssi: диапазон от 0 до 31, а также 99 для неизвестного значения.
    • ber – коэффициент битовых ошибок. Диапазон значений: от 0 до 7. Значение 99 означает, что коэффициент неизвестен.
  • gsm signal-profile num – задает профиль уровня сигнала. num – число от 0 до 4.

  • cdma ssource source Задает текущий источник подписки CDMA, где источник – это сетевой белый список, содержащий абонентов оператора CDMA и их значения, как указано ниже.

    • nv – считывает подписку из энергонезависимой памяти.
    • ruim – считывает подписку со съемного модуля идентификации пользователя (RUIM).
  • cdma prl_version version – выводит текущую версию списка предпочтительных сетей роуминга (PRL). Номер версии базы данных PRL, которая содержит информацию, используемую при выборе и получении системы.

Управление датчиками в эмуляторе

Эти команды связаны с датчиками, доступными в AVD. Помимо использования команды sensor, вы можете просматривать и изменять настройки в эмуляторе на экране Virtual sensors (Виртуальные датчики) на вкладках Accelerometer (Акселерометр) и Additional sensors (Дополнительные датчики).

  • Статус датчиков. Список всех датчиков и их статусов.

  • sensor get sensor-name – получить настройки для датчика с указанным названием. В следующем примере показано, как получить значение для датчика ускорения:

    sensor get acceleration
    acceleration = 2.23517e-07:9.77631:0.812348
    

    Значения ускорения, разделенные двоеточиями (:), относятся к координатам x, y и z виртуальных датчиков.

  • sensor set sensor-name value-x:value-y:value-z – задает значения для sensor-name. В следующем примере для датчика ускорения задаются значения x, y и z, разделенные двоеточиями.

    sensor set acceleration 2.23517e-07:9.77631:0.812348
    

Эмуляция SMS

  • sms send sender-phone-number textmessage Генерирует эмулированное входящее SMS-сообщение. Ниже приведен список параметров и их значений.

    • sender-phone-number – содержит произвольную строку цифр.
    • textmessage – SMS.

    В следующем примере сообщение "Привет" отправляется на номер 4085555555:

    sms send 4085555555 hi there
    

Консоль перенаправляет SMS-сообщение в платформу Android, которая передает его мессенджеру в эмуляторе, например приложению "Сообщения". Если вы передаете 10 цифр, приложение форматирует их как номер телефона. Более длинные или короткие числовые строки отображаются в том виде, в котором вы их отправили.

Симуляция отпечатка пальца

  • finger touch fingerprint-id – имитирует прикосновение пальца к сканеру.

  • finger remove – имитирует убирание пальца.

Инструкции по использованию этих команд приведены в разделе Симуляция и проверка цифровых отпечатков.

Запись экрана

Команда screen record позволяет записывать видео высокого качества с физического экрана эмулятора прямо из хост-системы. Это очень полезно для конвейеров непрерывной интеграции и автоматических отчетов об ошибках.

  • screenrecord {start| stop} file Запускает или останавливает запись экрана.
    • start file – начать запись видео. Файл должен иметь расширение .webm. Записанное видео сохраняется в каталоге вывода консоли виртуального устройства Android: ~/.android/avd/avd_name.avd/console_out/file.
    • stop file – останавливает активный процесс записи экрана.

Автоматизация и макросы

Подсистема автоматизации позволяет разработчикам записывать переходы между состояниями макросов на работающем виртуальном устройстве и воспроизводить их для выполнения автоматизированных тестовых потоков.

  • automation {record| stop-record| play| stop-play} Управляет автоматическими записями макросов.
    • record – начать запись изменений состояния устройства и входных данных.
    • stop-record – останавливает текущий сеанс записи макроса.
    • play – воспроизведение записанной последовательности макроса.
    • stop-play – останавливает активную последовательность воспроизведения макроса.

Физика (6DoF)

Физические команды управляют регистрацией фундаментальной истины пространственных поз для моделей физического движения с шестью степенями свободы (6DoF), которые используются для симуляции расширенного отслеживания движения.

  • physics {record-gt| stop} Управляет записями физических моделей поз.
    • record-gt – начать запись фундаментальной истины о перемещении с шестью степенями свободы.
    • stop – останавливает текущий процесс записи фундаментальной истины.

Расширенные настройки управления устройствами

В этом разделе собраны узкоспециализированные конечные точки команд консоли для расширенных конфигураций эмуляции, включая сетевые прокси-серверы, конфигурации с несколькими дисплеями, переопределения рендеринга и прямую отладку гипервизора.

  • multidisplay {add| del} Добавляет или удаляет дополнительные виртуальные мониторы для тестирования конфигураций с несколькими экранами. Примечание. Дополнительные мониторы не поддерживаются в профилях складных устройств, таких как Pixel Fold, и в эмуляторе Resizable.

  • proxy {set| clear} Программная настройка переадресации прокси-сервера из консоли.

    • set host port – задает настройки прокси-сервера.
    • clear – сброс настроек прокси-сервера до значений по умолчанию. Примечание. Операции с наборами прокси-серверов не выполняются в средах выполнения без графического интерфейса.
  • virtualscene-image {wall| table} image_path Позволяет настроить фон или горизонтальные столы, которые показываются на видеопотоке с камеры виртуальной сцены, с помощью пользовательского графического файла.

  • resize-display scale Динамически настраивает разрешение экрана между заданными масштабами. Примечание. Настройка разрешения не поддерживается в конфигурациях без монитора.

  • nodraw {on| off} Отключает отрисовку физического графического интерфейса пользователя на экране хоста, чтобы снизить нагрузку на системную память и графический процессор во время выполнения большого количества фоновых автоматических действий без графического интерфейса.

  • grpc port Настраивает расширенное программное управление устройствами через конечные точки настраиваемых портов gRPC.

  • qemu monitor Предоставляет прямой интерактивный доступ к терминалу консоли базового гипервизора. Эту команду можно ввести только в активных сеансах консоли Telnet.

  • icebox track pid Позволяет автоматически создавать снимки системы, когда в указанном процессе приложения возникает необработанное исключение или сбой.

  • phonenumber number Задает виртуальный местный номер телефона целевого устройства.

Программный интерфейс gRPC

Современные версии эмулятора поддерживают мощный программный интерфейс gRPC наряду с устаревшей консолью Telnet. Консоль Telnet отлично подходит для быстрых интерактивных сеансов или базовых скриптов, а интерфейс gRPC разработан для высокопроизводительного, безопасного и надежного автоматизированного управления в средах непрерывной интеграции (CI) и безголовых средах. Благодаря конечным точкам прямого обслуживания gRPC устраняет необходимость анализировать текстовые потоки, управлять подтверждениями сеансов терминала или открывать незашифрованные порты локального хоста.

Чтобы выбрать между устаревшей консолью Telnet и современным программным интерфейсом gRPC, ознакомьтесь со следующим сравнением производительности, безопасности и функциональных возможностей:

Функция Консоль Telnet Интерфейс gRPC
Для чего подходит Ручная отладка, интерактивные сеансы. CI/CD без графического интерфейса, тяжелые автоматизированные тестовые стенды.
Скорость Медленнее. Текстовые заголовки, задержка подключения. Оптимизированный; мультиплексированный HTTP/2, быстрый протокол.
Безопасность Без шифрования; локальные порты (5554–5585). Может быть защищен TLS, работает по сети.
Streams Не поддерживается. Доступны только запросы и ответы. Потоки для logcat, запись аудио гостя.
Медиафайлы Записывает выходные файлы на диск хоста или гостя. Прямые двоичные буферы, передаваемые по сети.
Гостевая ОС Доступны только фиксированные команды эмулятора. Выполняет нативные команды оболочки bash гостевой ОС.

Запуск и вызов gRPC

Чтобы использовать конечные точки gRPC, запустите эмулятор Android из командной строки и добавьте флаг -grpc, указав целевой порт обратной связи.

# Start the emulator with the gRPC service enabled on port 8556
emulator -grpc localhost:8556 @Pixel_Fold

После запуска эмулятора с включенным сервисом gRPC вы можете выполнять программные вызовы RPC. Для тестирования в командной строке используйте утилиту grpcurl, чтобы взаимодействовать с сервисами эмулятора. Все запросы форматируются в JSON и отправляются в виде обычного текста.

# Query the status of the virtual device using grpcurl
grpcurl -plaintext -d '{}' localhost:8556 \
  android.emulation.control.EmulatorController/getStatus

# Simulate an incoming phone call
grpcurl -plaintext -d '{"operation": "InitCall", "number": "1234567890"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendPhone

# Simulate typing text into the guest OS
grpcurl -plaintext -d '{"text": "Hello"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendKey

Сопоставление консоли Telnet с сервисом gRPC

В таблице ниже показано, как устаревшие команды консоли Telnet сопоставляются с соответствующими сервисами и методами gRPC. Это поможет вам понять, как автоматизировать распространенные взаимодействия с виртуальными устройствами.

Категория Устаревшая команда Telnet Сервис/метод gRPC
Статус ping EmulatorController/getStatus
Статус avd name incubating.AvdService/getAvdInfo
Статус kill EmulatorController/setVmState
Статус restart EmulatorController/setVmState
Власть power display EmulatorController/getBattery
Власть power capacity EmulatorController/setBattery
Геотаргетинг geo fix EmulatorController/setGps
Датчики sensor set incubating.SensorService/setSensor
Биометрия. finger touch EmulatorController/sendFingerprint
Осанка posture EmulatorController/setPosture
Осанка physics/fold EmulatorController/setPhysicalModel
SMS sms send EmulatorController/sendSms
GSM Call gsm call EmulatorController/sendPhone
GSM Call phonenumber EmulatorController/setPhoneNumber
Переадресация redir add Waterfall/ForwardPort
Ввод данных event send EV_KEY EmulatorController/sendKey
Ввод данных event send EV_ABS EmulatorController/sendTouch
Медиафайлы screenrecord incubating.ScreenRecording
Отрисовка nodraw EmulatorController/setDisplayMode
Снимки avd snapshot list SnapshotService/ListSnapshots
Снимки avd snapshot load/save SnapshotService/LoadSnapshot

Программные команды, уникальные для gRPC

Интерфейс gRPC предоставляет несколько передовых возможностей, которые физически невозможно реализовать через устаревшие консольные подключения Telnet. К ним относятся прямая потоковая передача logcat, двунаправленная запись или вставка аудио, изменение графического интерфейса хоста и прямой доступ к оболочке.

Сервис/метод gRPC Параметр Возможности
streamLogcat {"maxLines": 100} Передает выходные данные logcat гостевой системы.
streamAudio {} Передает звук из динамика по проводу.
injectAudio {"audio": "..."} Внедряет аудиопотоки микрофона.
UiController {"theme": "DARK"} Изменение тем окон хоста
Waterfall/Exec {"cmd": "ls"} Выполняет команды оболочки гостевой ОС.

Симуляция и проверка отпечатка пальца

Рисунок 1. Экран аутентификации по отпечатку пальца.

Используйте команду finger, чтобы смоделировать и проверить аутентификацию по отпечатку пальца в приложении. Вам потребуется SDK Tools 24.3 или более поздней версии и Android 6.0 (уровень API 23) или более поздней версии.

Чтобы смоделировать и проверить аутентификацию по отпечатку пальца, выполните следующие действия:

  1. Если у вас ещё нет идентификатора отпечатка пальца, зарегистрируйте новый отпечаток в эмуляторе, выбрав Настройки > Безопасность > Отпечаток пальца и следуя инструкциям по регистрации.

  2. Настройте в приложении аутентификацию по отпечатку пальца. После этого на устройстве появится экран аутентификации по отпечатку пальца.

  3. Когда в приложении появится экран аутентификации по отпечатку пальца, перейдите в консоль и введите команду finger touch и созданный идентификатор отпечатка пальца. Это имитирует касание пальцем.

  4. Затем введите команду finger remove, чтобы симулировать поднятие пальца. Приложение должно реагировать так, как если бы пользователь коснулся сканера отпечатков пальцев, а затем убрал палец.