Enviar comandos do console do emulador

Cada dispositivo virtual em execução dispõe de um console que permite consultar e controlar o ambiente do dispositivo emulado. Por exemplo, é possível usar o console para gerenciar redirecionamentos de porta, características de rede e eventos de telefonia enquanto o app é executado no emulador.

Os comandos a seguir exigem que um emulador já esteja em execução. Para mais informações sobre como executar um emulador, consulte Executar apps no Android Emulator e Iniciar o emulador na linha de comando.

Iniciar e parar uma sessão do console

Para acessar o console e inserir comandos em uma janela do terminal, use telnet para se conectar à porta do console e informe o token de autenticação. A mensagem OK no console indica que ele está pronto para aceitar comandos. Não há um prompt típico.

Para conectar-se ao console de um dispositivo virtual em execução:

  1. Abra uma janela do terminal e insira o seguinte comando:

    telnet localhost console-port
    

    O título da janela do emulador lista o número da porta do console quando executado em uma janela separada, mas não em uma janela de ferramentas. Por exemplo, o título da janela de um emulador usando a porta de console 5554 pode ser Pixel8_API_34:5554. Além disso, o comando adb devices mostra uma lista de dispositivos virtuais em execução e os números de porta de console. Para mais informações, leia Consultar dispositivos.

    Observação: o emulador detecta conexões nas portas 5554 a 5585 e aceita conexões apenas do localhost.

  2. Depois que o console exibir OK, insira o comando auth auth_token.

    Para que você insira comandos, o console do emulador requer autenticação. auth_token precisa corresponder ao conteúdo do arquivo .emulator_console_auth_token no seu diretório inicial.

    O comando telnet localhost console-port criará esse arquivo, que contém um token de autenticação gerado aleatoriamente, caso ele não exista. Para desativar a autenticação, exclua o token do arquivo .emulator_console_auth_token ou crie um arquivo vazio se ele não existir.

  3. Depois de se conectar ao console, insira os comandos.

    Digite help, help command ou help-verbose para ver uma lista de comandos de console e aprender mais sobre comandos específicos.

  4. Para sair da sessão de console, insira quit ou exit.

Veja um exemplo de sessão:

$ 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.

Comandos de execução e esquecimento

Se você não precisar que a sessão fique aberta, use o atalho adb emu, que executa o comando e retorna imediatamente o controle ao shell de invocação:

adb emu command commandParameter

A invocação com adb emu se conecta ao emulador disponível. Se você tiver vários emuladores em execução ao mesmo tempo, transmita o número de série do emulador específico que você quer segmentar:

adb -s emulator-serial emu command commandParameter

Referência de comando do emulador

As listas a seguir descrevem os comandos do console do emulador com os parâmetros e valores relacionados:

Comandos gerais

  • avd {stop| start| status| name} Consulta, controla e gerencia o dispositivo virtual da seguinte maneira:

    • stop: interrompe a execução do dispositivo.
    • start: inicia a execução do dispositivo.
    • status: consulta o status do dispositivo virtual, que pode ser em execução ou interrompido.
    • name: consulta o nome do dispositivo virtual.
  • avd snapshot {list| save name| load name| delete name} Salva e restaura o estado do dispositivo em snapshots desta maneira:

    • list: lista todos os snapshots salvos.
    • save name: salva o snapshot como name.
    • load name: carrega o snapshot nomeado.
    • delete name: exclui o snapshot nomeado.

    O exemplo a seguir salva um snapshot com o nome firstactivitysnapshot:

    avd snapshot save firstactivitysnapshot
    
  • fold: dobra o dispositivo para mostrar a menor configuração de tela se ele for dobrável e estiver aberto no momento.

  • unfold: desdobra o dispositivo para mostrar a maior configuração de tela se ele for dobrável e estiver dobrado no momento.

  • kill: encerra o dispositivo virtual.

  • ping: verifica se o dispositivo virtual está sendo executado.

  • rotate: gira o AVD no sentido anti-horário em incrementos de 45 graus.

Falha no emulador

  • crash: causa uma falha no emulador durante a execução do app.

  • crash-on-exit: causa uma falha no emulador quando o app é encerrado.

Tags de depuração

  • tags de depuração ...: ativa ou desativa mensagens de depuração de partes específicas do emulador. O parâmetro de tags precisa ser um valor da lista de tags de depuração que aparece quando você executa emulator -help-debug-tags. Para mais informações sobre a opção -help-debug-tags, consulte a tabela de opções usadas com mais frequência. O exemplo a seguir ativa a tag de rádio:

    debug radio
    

Redirecionamento de porta

  • redir list: lista o redirecionamento de porta atual.

  • redir add protocol:host-port:guest-port Adiciona um novo redirecionamento de porta, da seguinte maneira:

    • protocol: precisa ser tcp ou udp.
    • host-port: número da porta a ser aberta no host.
    • guest-port: o número da porta para a qual rotear dados no emulador.
  • redir del protocol:host-port Exclui um redirecionamento de porta.

    • protocol: precisa ser tcp ou udp.
    • host-port: número da porta a ser aberta no host.

Localização geográfica

Define a localização geográfica relatada para os apps em execução dentro de um emulador, enviando um ponto GPS para o emulador.

Você poderá emitir um dos seguintes comandos de região geográfica assim que um dispositivo virtual estiver em execução. O emulador define o local que você insere criando um provedor de locais fictícios. Esse provedor responde aos listeners de localização definidos por apps e informa o local para o LocationManager. Qualquer app pode consultar o gerenciador de localização para acessar o ponto GPS atual do dispositivo emulado chamando LocationManager.getLastKnownLocation("gps").

  • geo fix longitude latitude [altitude] [satellites] [velocity]: envia um ponto GPS para o emulador. Especifique a longitude e a latitude em graus decimais. Use um número de 1 a 12 para especificar a quantidade de satélites a ser usada para determinar a posição e especifique a altitude em metros e a velocidade em nós.

  • geo nmea sentence: envia uma sentença NMEA 0183 para o dispositivo emulado, como se ela tivesse sido enviada de um modem GPS emulado. Comece a frase com "$GP". No momento, só há suporte para as sentenças "$GPGGA" e "$GPRCM". O exemplo a seguir é uma sentença de Dados de Posição do Sistema de Posicionamento Global (GPGGA, na sigla em inglês) que recebe o horário, a posição e os dados de localização de um receptor 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
    

Eventos falsos de hardware

O subsistema de eventos de hardware do console do emulador permite simular praticamente qualquer interação física com o dispositivo. Isso inclui botões físicos, toques/gestos na tela, seletores giratórios, entradas de joystick e interruptores de hardware.

  • event types: lista todos os tipos de eventos falsos. Para eventos que têm códigos, o número de códigos é listado entre parênteses à direita. Exemplo de saída:

    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 ...]: envia um ou mais tipos de eventos falsos.

  • event codes type: lista os códigos de evento para o tipo de evento falso especificado.

  • event send type[:code]:[value] [...]: envia um ou mais eventos falsos com códigos opcionais e valores de código.

EV_KEY: referências de código de tecla

O tipo de evento EV_KEY é usado para simular o pressionamento e a liberação de botões. As tabelas a seguir dividem a vasta lista de códigos de tecla compatíveis em categorias lógicas. Para cada código de tecla, o envio de um valor de 1 simula um pressionamento, enquanto um valor de 0 simula uma liberação. Um valor de 2 representa a repetição de tecla.

Subtabela A: chaves do sistema Android
Código Descrição
KEY_HOME Acionador do botão home
KEY_BACK Acionador do botão "Voltar"
KEY_MENU Botão de menu (flutuante)
KEY_POWER Botão liga/desliga (pressionar/tocar e manter pressionado)
KEY_VOLUMEUP Acionador do botão de aumentar volume
KEY_VOLUMEDOWN Acionador do botão de diminuir volume
KEY_CAMERA Botão físico do obturador da câmera
KEY_FOCUS Obturador de foco automático da câmera
KEY_SEARCH Acionador do botão de pesquisa
KEY_SLEEP Acionador do comando de suspensão
KEY_WAKEUP Acionador do comando de ativação
KEY_NOTIFICATION Abrir painel de notificações
KEY_MUTE Desativar a saída de áudio do sistema
KEY_MICMUTE Desativar entrada de microfone
KEY_BRIGHTNESSDOWN Diminuir o brilho da tela
KEY_BRIGHTNESSUP Aumentar o brilho da tela
KEY_PHONE Abrir o app de telefone padrão
KEY_SEND Enviar ou iniciar uma chamada telefônica
KEY_HEADSETHOOK Gancho do fone de ouvido (atender/desligar)
KEY_SCREEN Comando ativo do protetor de tela
KEY_CONFIG Menu do sistema de configuração
KEY_SWITCHVIDEOMODE Mudar o modo de vídeo do sistema
KEY_KBDILLUMTOGGLE Ativar ou desativar a luz de fundo do teclado
Subtabela B: Controles de mídia e reprodução
Código Descrição
KEY_PLAYPAUSE Alternar entre os estados de reprodução e pausa
KEY_PLAY Iniciar a reprodução de mídia
KEY_PAUSECD Pausar reprodução de CD
KEY_STOPCD Parar reprodução de CD
KEY_NEXTSONG Pular para a próxima faixa
KEY_PREVIOUSSONG Pular para a faixa anterior
KEY_REWIND Retroceder a faixa ativa
KEY_FASTFORWARD Avançar faixa ativa
KEY_RECORD Comando de acionador de gravação
KEY_SHUFFLE Ativar/desativar a reprodução aleatória
KEY_REPEAT Ativar/desativar repetição da reprodução
KEY_MEDIA Acionador de tecla de mídia
Subtabela C: Navegação e teclados gerais
Código Descrição
KEY_UP Botão direcional para cima
KEY_DOWN Botão direcional para baixo
KEY_LEFT Botão direcional para a esquerda
KEY_RIGHT Botão direcional para a direita
KEY_PAGEUP Navegação para cima na página
KEY_PAGEDOWN Navegação para baixo na página
KEY_INSERT Inserir acionador de chave
KEY_DELETE Excluir gatilho de chave
KEY_ENTER Acionador da tecla Enter
KEY_ESC Acionador da tecla Esc
KEY_TAB Acionador da tecla Tab
KEY_SPACE Acionador da barra de espaço
KEY_BACKSPACE Acionador da tecla Backspace
KEY_CLEAR Limpar buffer de entrada
KEY_CANCEL Cancelar ação ativa
KEY_OK Confirmar/OK
KEY_SELECT Selecionar acionador de item
KEY_GOTO Ir para o local designado
KEY_HELP Acessar o contexto de ajuda
Subtabela D: caracteres alfanuméricos e símbolos do teclado
  • Letras do alfabeto padrão: de KEY_A a KEY_Z (26 códigos).
  • Teclas do teclado numérico: de KEY_1 a KEY_0 (10 códigos).
Código Símbolo de personagem
KEY_COMMA ,
KEY_DOT .
KEY_SLASH /
KEY_SEMICOLON ;
KEY_APOSTROPHE '
KEY_GRAVE \`
KEY_MINUS -
KEY_EQUAL =
KEY_LEFTBRACE [
KEY_RIGHTBRACE ]
KEY_BACKSLASH \
KEY_KPASTERISK * (teclado numérico)
KEY_KPPLUS + (teclado numérico)
KEY_KPMINUS - (teclado numérico)
KEY_KPDOT . (teclado numérico)
KEY_KPSLASH / (teclado numérico)
KEY_KPENTER Enter (teclado numérico)
KEY_KPEQUAL = (teclado numérico)
KEY_KPCOMMA , (teclado numérico)
KEY_KPJPCOMMA , (layout japonês)
KEY_KPLEFTPAREN ( (teclado numérico)
KEY_KPRIGHTPAREN ) (teclado numérico)
KEY_KPPLUSMINUS ± (teclado numérico)
Subtabela E: teclas modificadoras e de função
  • Teclas de função padrão: de KEY_F1 a KEY_F24 (24 códigos).
Código Descrição
KEY_LEFTSHIFT Modificador de teclado Shift esquerdo
KEY_RIGHTSHIFT Modificador de teclado Shift direito
KEY_LEFTCTRL Modificador de teclado Control esquerdo
KEY_RIGHTCTRL Modificador de teclado Control direito
KEY_LEFTALT Modificador de teclado Alt esquerdo
KEY_RIGHTALT Modificador de teclado Alt direito
KEY_LEFTMETA Tecla Meta/Command esquerda
KEY_RIGHTMETA Tecla Meta/Command direita
KEY_CAPSLOCK Alternar Caps Lock no teclado
KEY_NUMLOCK Alternar teclado Num Lock
KEY_SCROLLLOCK Alternar o Scroll Lock do teclado
KEY_COMPOSE Assistente de caracteres do Compose
KEY_FN Tecla FN do teclado físico
KEY_FN_ESC Combinações de teclas de função
KEY_FN_1 Atalho de função especial 1
KEY_FN_2 Atalho de função especial 2
KEY_FN_D Atalho de função especial D
KEY_FN_E Atalho de função especial E
KEY_FN_F Atalho de função especial F
KEY_FN_S Atalho de função especial S
KEY_FN_B Atalho de função especial B
Subtabela F: gamepads e joysticks
Código Descrição
BTN_A / BTN_B / BTN_C Botões frontais do controle A/B/C
BTN_X / BTN_Y / BTN_Z Botões frontais do controle X/Y/Z
BTN_START Botão do menu "Iniciar" do gamepad
BTN_SELECT Botão "Selecionar" do gamepad
BTN_MODE Alternar para o modo de controle
BTN_TL / BTN_TR Botões superiores esquerdo / direito
BTN_TL2 / BTN_TR2 Gatilhos analógicos esquerdo / direito
BTN_THUMBL / BTN_THUMBR Botões analógicos esquerdo / direito
BTN_DPAD_UP Botão direcional para cima do gamepad
BTN_DPAD_DOWN Gatilho do botão direcional para baixo do gamepad
BTN_DPAD_LEFT Botão direcional do gamepad: gatilho esquerdo
BTN_DPAD_RIGHT Botão direcional do gamepad: gatilho direito
BTN_THUMB Gatilho principal do joystick
BTN_TOP / BTN_TOP2 Botões superiores do joystick
BTN_PINKIE Acionadores do botão mindinho do joystick
BTN_BASE a _BASE6 Botões da base da plataforma do joystick
BTN_DEAD Sinalização de zona morta do gamepad inativo
BTN_TRIGGER Gatilho manual do joystick físico
BTN_JOYSTICK Código de entrada genérico do joystick
Subtabela G: entradas de mouse, toque e stylus
Código Descrição
BTN_MOUSE Evento genérico do ponteiro do mouse
BTN_LEFT Clicar com o botão esquerdo do mouse
BTN_RIGHT Clicar com o botão direito do mouse
BTN_MIDDLE Clique com o botão do meio da roda de rolagem
BTN_SIDE Acionador da tecla lateral de navegação
BTN_EXTRA Acionador de botão extra do mouse
BTN_FORWARD Clique de navegação para frente no navegador
BTN_BACK Clique de navegação para voltar no navegador
BTN_TASK Tecla de alternância de tarefas do sistema
BTN_TOUCH Contato físico com a tela detectado
BTN_STYLUS Proximidade da stylus ativa
BTN_STYLUS2 Botão secundário na stylus
BTN_TOOL_PEN Identificador da ferramenta de caneta stylus
BTN_TOOL_RUBBER Identificador da ferramenta de borracha da stylus
BTN_TOOL_BRUSH Identificador da ferramenta de pincel de pintura
BTN_TOOL_PENCIL Identificador da ferramenta de lápis de desenho
BTN_TOOL_AIRBRUSH Identificador da ferramenta de pintura com aerógrafo
BTN_TOOL_FINGER Contato do dedo com a tela touch screen
BTN_TOOL_MOUSE Identificador de ferramenta de mouse externa
BTN_TOOL_LENS Ferramenta de lente de aumento óptica
BTN_TOOL_DOUBLETAP Sinalização de velocidade do gesto de tocar duas vezes
BTN_TOOL_TRIPLETAP Sinalização de velocidade do gesto de toque triplo
Subtabela H: Atalhos de aplicativos
Código Ação de destino
KEY_WWW Inicia o navegador da Web padrão
KEY_MAIL Abre o cliente de e-mail padrão
KEY_BOOKMARKS Abre a lista de favoritos do navegador
KEY_CALC Abre o utilitário da calculadora
KEY_FILE Abre o explorador de arquivos locais
KEY_EDIT Gatilho de edição de documento
KEY_NEW Documento: criar novo gatilho
KEY_OPEN Gatilho de abertura de documento
KEY_SAVE Acionador de tarefa para salvar arquivo
KEY_CLOSE Acionador de tarefa de fechamento de arquivo
KEY_PRINT Acionador de tarefa de impressão de arquivo
KEY_COPY Ação de cópia do buffer da área de transferência
KEY_PASTE Ação de inserção do buffer da área de transferência
KEY_CUT Ação de recorte do buffer da área de transferência
KEY_UNDO Ação de desfazer do buffer da área de transferência
KEY_REDO Ação de refazer do buffer da área de transferência
KEY_CANCEL Gatilho de processo de cancelamento de buffer
KEY_FIND Utilitário de pesquisa de documentos
KEY_REFRESH Utilitário de atualização de documentos
KEY_EXIT Utilitário de fechamento de documentos
KEY_DOCUMENTS Abre o portal de documentos do sistema
KEY_HOMEPAGE Abre o navegador da página inicial
KEY_FAVORITES Abre o portal de favoritos do navegador
KEY_CHAT Inicia o mensageiro instantâneo
KEY_EMAIL Gatilho de lançamento de e-mail alternativo
KEY_FINANCE Abrir utilitário de ações/finanças
KEY_SPORT Abrir utilitário de monitoramento de esportes
KEY_SHOP Abrir portal de compras digitais
KEY_PLAYER Abrir o player de mídia principal
KEY_MP3 Abrir o MP3 player principal
KEY_TEXT Abrir o editor de texto padrão
KEY_LIST Abrir utilitário de checklist
KEY_MEMO Abrir o bloco de notas / utilitário de memorando
KEY_CALENDAR Abre o portal da agenda
KEY_DIRECTORY Abre o diretório de endereços do sistema
KEY_COMPUTER Abre o explorador de especificações
KEY_TV / KEY_TV2 Abre o portal de televisão
KEY_RADIO Inicia o utilitário de rádio
KEY_CD / KEY_DVD Ativa o leitor de unidade óptica
KEY_AUDIO / KEY_VIDEO Acessa especificações de mídia
KEY_TUNER Configura receptores/sintonizadores
KEY_SAT / KEY_SAT2 Configura feeds de satélite
KEY_TAPE Tocar fita cassete
KEY_VCR Reproduzir feed do player de VCR
KEY_VCR2 Reproduzir feed do player VCR 2
KEY_AUX Entradas de porta de mídia auxiliar
KEY_SETUP Menu de configuração
KEY_PROG1 a _PROG4 Chaves de programa definidas pelo usuário
KEY_ZOOM Alternar zoom da janela de visualização
KEY_MODE Seleção do modo de janela de visualização
KEY_KEYBOARD Mostrar/ocultar teclado virtual
KEY_LANGUAGE Mudar o idioma da faixa de áudio
KEY_TITLE Abrir opções de título de mídia
KEY_SUBTITLE Ativar/desativar interface de legendas
KEY_ANGLE Mudar os ângulos da câmera de vídeo
KEY_EPG Abrir o guia de programação eletrônica
KEY_PVR Abrir gravador de vídeo pessoal
KEY_MHP Plataforma aberta de multimídia para casa
KEY_CHANNEL Abrir canais do sintonizador de TV
KEY_CHANNELUP Mudar para o próximo canal de TV
KEY_CHANNELDOWN Sintonizar canal de TV anterior
KEY_RED Botão interativo vermelho
KEY_GREEN Botão interativo verde
KEY_YELLOW Botão interativo amarelo
KEY_BLUE Botão interativo azul
KEY_FIRST Selecionar a opção do primeiro item
KEY_LAST Selecionar a opção do último item
KEY_NEXT Selecionar a opção de próxima faixa
KEY_PREVIOUS Selecionar opção de faixa anterior
KEY_RESTART Reiniciar o loop da faixa de mídia
KEY_SLOW Opção de reprodução em câmera lenta
KEY_AB Loop de repetição de sequência A-B
KEY_PLAYCD Comando de reprodução do CD player
KEY_PAUSECD Comando de pausa do CD player
KEY_STOPCD Comando de parada do CD player
KEY_DIGITS Comando de entrada do teclado digital
KEY_TEEN Opção de valores para adolescentes no teclado numérico
KEY_TWEN Opção de valores de teclado numérico de 20
KEY_DEL_EOL Excluir até o fim do buffer de linha
KEY_DEL_EOS Excluir até o fim do buffer de tela
KEY_INS_LINE Inserir buffer de nova linha
KEY_BRL_DOT1 a _DOT8 Entradas de botão da linha braille
KEY_VOICECOMMAND Inicia o app assistente por voz
KEY_SELECTIVE_SCREEN Aciona a captura de tela regional
KEY_BATTERY Consulta notificações de bateria
KEY_STAR / KEY_SHARP Símbolos do teclado do telefone
KEY_PLUS Símbolo de adição do teclado do telefone
KEY_INFO Mostrar sobreposição do painel de informações
KEY_TIME Mostrar o horário atual do relógio
KEY_VENDOR Consulta as especificações do fornecedor
KEY_ARCHIVE Abre o utilitário de arquivo local
KEY_PROGRAM Configura os parâmetros do programa
KEY_POWER2 Aciona a energia de reserva alternativa

EV_ABS: eventos de movimento absoluto

O tipo de evento EV_ABS é crucial para simular toques precisos, gestos de arrastar e soltar, ações de pinça multitoque e ajustes de joystick. As coordenadas absolutas abaixo são mapeadas diretamente para a resolução da tela física.

Código Intervalo de coordenadas Descrição
ABS_MT_TRACKING_ID -1 ou ≥0 ID de rastreamento; -1 encerra o toque
ABS_MT_POSITION_X 0 a 1767 Coordenada X (Pixel Fold)
ABS_MT_POSITION_Y 0 a 2207 Coordenada Y (Pixel Fold)
ABS_MT_TOUCH_MAJOR pixels Largura do eixo principal da área de toque
ABS_MT_TOUCH_MINOR pixels Largura do eixo menor da área de toque
ABS_MT_WIDTH_MAJOR pixels Largura do eixo principal da ferramenta
ABS_MT_WIDTH_MINOR pixels Largura do eixo menor da ferramenta
ABS_MT_ORIENTATION 0 a 255 Ângulo de orientação do contato
ABS_MT_PRESSURE 0 a 255 Magnitude da força de contato
ABS_MT_DISTANCE mm Distância de flutuação da tela
ABS_MT_TOOL_TYPE 0 a 2 0=dedo, 1=caneta, 2=lápis
ABS_MT_BLOB_ID integer Identificador de blob de contato
ABS_MT_TOOL_X pixels Coordenada da posição X da ferramenta
ABS_MT_TOOL_Y pixels Coordenada da posição Y da ferramenta
ABS_MT_SLOT 0 a N Slot ativo (Protocolo B)
ABS_X / _Y / _Z analógico Eixos de coordenadas do joystick
ABS_RX / _RY / _RZ analógico Eixos de rotação do joystick
ABS_THROTTLE / _BRAKE analógico Pedais e controles de direção
ABS_HAT0X / _HAT0Y -1 / 0 / 1 Botão direcional e interruptores de ponto de vista
ABS_PRESSURE 0 a 255 Nível de força da stylus / do ponteiro
ABS_DISTANCE mm Distância de flutuação (caneta stylus)
ABS_TILT_X / _TILT_Y graus Ângulos de inclinação da stylus
ABS_VOLUME analógico Níveis de volume do controle

A interação por toque do Android é impulsionada por protocolos multitoque (MT). Os emuladores modernos implementam o Protocolo A (sem estado, que envia pacotes de contato separados por marcas de sincronização) e o Protocolo B (com estado, que atribui contatos a slots de rastreamento dedicados). O protocolo B permite o rastreamento eficiente de vários toques simultâneos para gestos como pinça para zoom.

EV_REL e EV_SW: interruptores de movimento e hardware

A categoria de evento EV_REL gerencia mudanças relativas de ponteiro ou coordenadas, que são usadas principalmente para emular movimentos de mouse externo ou rodas de rolagem. A categoria de evento EV_SW gerencia interruptores de dispositivos físicos, como se um smartphone dobrável ou tablet está dobrado ou se um hardware de áudio externo está inserido.

Código Valores Descrição
REL_X Delta Movimento horizontal do cursor
REL_Y Delta Movimento vertical do cursor
SW_LID 0/1 Status da tampa do laptop (0=aberta, 1=fechada)
SW_TABLET_MODE 0/1 Status do modo tablet (0=desativado, 1=ativo)
SW_HEADPHONE_INSERT 0/1 Status da entrada para fone de ouvido (0=desconectado, 1=conectado)
SW_MICROPHONE_INSERT 0/1 Status da entrada de microfone (0=desconectado, 1=conectado)
Sintaxe de envio de comandos

Para enviar esses códigos, formate o comando do console com tipos, códigos e valores separados por dois-pontos. É possível colocar várias mudanças de coordenadas em uma única string. É fundamental sempre anexar uma marca de sincronização final (EV_SYN:0:0) para indicar que o framework do emulador precisa agrupar e processar essas entradas juntas.

Exemplos de scripts de eventos e gestos

Como o Telnet permite o envio de parâmetros de várias partes, é possível simular sequências realistas de gestos físicos. Confira abaixo as estruturas de script de evento bruto para automatizar gestos no console do host.

Simular um toque na tela

Para realizar um toque limpo na tela em uma coordenada de destino, atribua um ID de rastreamento, especifique as coordenadas X e Y na tela, simule o toque de contato, sincronize e solte.

# 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
Simular uma rolagem vertical (deslizar)

Para executar um gesto de deslizar para rolar, mantenha o contato pressionado na coordenada inicial, envie frames de coordenadas de movimento intermediários e solte no final.

# 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
Simular um gesto de pinça para aplicar zoom

Para acionar um zoom com dois dedos, use slots de MT ativos (0 e 1) para rastrear e coordenar duas coordenadas de toque simultâneas que se afastam uma da outra.

# 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
Simular uma troca de conexão de fone de ouvido

Simule inserções ou remoções de entrada para fone de ouvido para testar as mudanças de roteamento de áudio. Um valor de 1 representa a inserção do conector, e 0 é a remoção do fone de ouvido.

# 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
Como descobrir códigos de evento do console em um dispositivo real

Para descobrir a sequência exata de sintaxe de eventos para qualquer ação personalizada ou gesto de botão, conecte-se usando adb shell e execute o utilitário de diagnóstico getevent. Conforme você interage com a GUI do emulador, o console mostra os códigos, tipos e posições exatos do evento.

# 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
  • mensagem de texto de evento: envia uma string de caracteres que simulam pressionamentos de tecla. A mensagem precisa ser uma string UTF-8. As postagens Unicode são mapeadas de maneira reversa de acordo com o teclado do dispositivo atual, e os caracteres sem suporte são descartados silenciosamente.

Controles de estado de energia

  • power display: mostra o estado da bateria e do carregador.

  • power ac {on| off}: define o estado de carregamento CA como ativado ou desativado.

  • power status {unknown| charging| discharging| not-charging| full}: muda o status da bateria conforme especificado.

  • power present {true| false}: define o estado de presença da bateria.

  • power health {unknown| good| overheat| dead| overvoltage| failure}: define o estado de integridade da bateria.

  • power capacity percent: define o estado da capacidade restante da bateria como uma porcentagem de 0 a 100.

Status da conexão de rede (somente Ethernet e celular)

  • status da rede: verifica o status da rede e as características atuais de atraso e velocidade.

  • network delay latency Modifica a latência da rede emulada.

    O emulador permite simular vários níveis de latência de rede para que você possa testar o app em um ambiente mais próximo de condições reais de execução. Você pode definir um nível de latência ou um intervalo na inicialização do emulador ou usar o console para mudar a latência enquanto o app está sendo executado no emulador.

    O formato de latência de rede é um dos seguintes (os números estão em milissegundos):

    Formatos de latência de rede:

  • gprs: GPRS, que usa um intervalo de latência de no mínimo 150 e no máximo 550.

  • edge: EDGE/EGPRS, que usa um intervalo de latência de no mínimo 80 e no máximo 400.

  • umts: UMTS/3G, que usa um intervalo de latência de no mínimo 35 e no máximo 200.

  • none: sem latência.

  • num: emula a latência especificada em milissegundos.

  • min:max: emula o intervalo de latência especificado.

    Para definir a latência na inicialização, use a opção de emulador -netdelay com um valor de latência compatível. Exemplos:

    emulator -netdelay gprs
    emulator -netdelay 40,100
    

    Para fazer mudanças no atraso da rede enquanto o emulador está em execução, conecte-se ao console e use o comando network delay:

    network delay gprs
    network delay 40 100
    
  • network speed speed O emulador permite simular várias taxas de transferência de rede. Você pode definir uma taxa de transferência ou um intervalo na inicialização do emulador ou usar o console para mudar a taxa enquanto o app está sendo executado no emulador.

    O formato da velocidade da rede é um dos seguintes (os números estão em kilobits por segundo):

    Formato de velocidade da rede:

  • gsm: GSM/CSD, que usa uma velocidade de 14,4 de upload e 14,4 de download.

  • hscsd: HSCSD, que usa uma velocidade de 14,4 de upload e 43,2 de download.

  • gprs: GPRS, que usa uma velocidade de 40,0 de upload e 80,0 de download.

  • edge: EDGE/EGPRS, que usa uma velocidade de 118,4 de upload e 236,8 de download.

  • umts: UMTS/3G, que usa uma velocidade de 128,0 de upload e 1.920 de download.

  • hsdpa: HSDPA, que usa uma velocidade de 348 de upload e 14.400 de download.

  • lte: LTE, que usa uma velocidade de 58.000 de upload e 173.000 de download.

  • evdo: EVDO, que usa uma velocidade de 75.000 de upload e 280.000 de download.

  • full: velocidade ilimitada, mas depende da velocidade de conexão do seu computador.

  • num: define uma taxa exata em kilobits por segundo usada para upload e download.

  • up:down: define taxas exatas em kilobits por segundo para upload e download separadamente.

    Para definir a velocidade da rede na inicialização, use a opção de emulador -netspeed. Exemplos:

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

    Para fazer mudanças na velocidade da rede enquanto o emulador está em execução, conecte-se ao console e use o comando network speed:

    network speed 14.4 80
    
  • network capture {start| stop} file Envia pacotes para um arquivo. A lista a seguir descreve os parâmetros e valores de parâmetro:

    Observação: a partir do Android Emulator 36.5, o tráfego de conexão Wi-Fi é processado pelo netsim por padrão. O comando do console de captura de rede captura apenas o tráfego legado de celular/WAN roteado pela pilha slirp do QEMU. Para capturar pacotes de Wi-Fi, Bluetooth ou de rede avançada em versões modernas do emulador, consulte Capturar tráfego de rede no guia de rede avançada do emulador.

  • start file: inicia a captura de pacotes de rede. Por segurança, o arquivo precisa ser um nome de arquivo simples (sem separadores de caminho, como /, e sem ..). O arquivo de captura de pacotes será salvo no diretório de conteúdo do AVD na pasta console_out/ (por exemplo, ~/.android/avd/avd_name.avd/console_out/file).

  • stop file: para de enviar pacotes para o arquivo especificado.

Emulação de telefonia

O Android Emulator inclui os próprios modems emulados GSM e CDMA, que permitem simular funções de telefonia no emulador. Por exemplo, com o GSM, é possível simular ligações recebidas, além de estabelecer e encerrar conexões de dados. Com o CDMA, você informa uma fonte de assinatura e a lista de roaming preferencial. O sistema Android processa ligações simuladas exatamente como faria com as reais. O emulador não tem suporte a áudio de ligações.

  • gsm {call| accept| cancel| busy} phonenumber Os parâmetros gsm são os seguintes:

    • call: simula uma ligação recebida de phonenumber.
    • accept: aceita uma ligação recebida de phonenumber e muda o estado dela para ativo. Só é possível mudar um estado de ligação para ativo quando o estado atual é em espera ou retido.
    • cancel: encerra uma ligação recebida de ou realizada para o número de telefone.
    • busy: encerra uma ligação realizada para o número de telefone e muda o estado dela para ocupado. Só é possível mudar um estado de ligação para ocupado quando o atual é em espera.
  • gsm {data| voice} state O comando de estado de dados muda o estado da conexão de dados GPRS, e o comando de estado de voz muda o estado da conexão de voz GPRS, da seguinte maneira:

    • unregistered: nenhuma rede disponível
    • home: em rede local, sem roaming
    • roaming: em rede com roaming
    • searching: pesquisando redes
    • denied: somente chamadas de emergência
    • off: igual a "unregistered".
    • on: igual a "home".
  • gsm hold: muda o estado de uma ligação para "em espera". Só é possível mudar um estado de ligação para em espera quando o estado atual é ativo ou em espera.

  • gsm list: lista todas as ligações recebidas ou feitas, assim como os estados delas.

  • gsm status: informa o estado atual de voz e dados GSM. Os valores são aqueles descritos para os comandos de voz e dados.

  • gsm signal {rssi| ber} Muda a intensidade do sinal relatado (rssi) e a taxa de erros de bit (ber) nos 15 segundos seguintes de atualização. A lista a seguir descreve os parâmetros e valores relacionados:

    • rssi: o intervalo é de 0 a 31, e 99 para desconhecido.
    • ber: o intervalo é de 0 a 7, e 99 para desconhecido.
  • gsm signal-profile num: define o perfil da intensidade do sinal. num é um número de 0 a 4.

  • cdma ssource source Define a origem da assinatura CDMA atual, em que a origem é uma lista de permissões baseada em rede que contém os assinantes da operadora CDMA e os valores correspondentes, da seguinte maneira:

    • nv: lê a assinatura da RAM não volátil.
    • ruim: lê a assinatura do Removable User Identity Module (R-UIM).
  • cdma prl_version version: despeja a versão atual da lista de roaming preferencial (PRL, na sigla em inglês). O número da versão se destina ao banco de dados da PRL que contém informações usadas durante o processo de seleção e aquisição do sistema.

Gerenciar sensores no emulador

Esses comandos se referem aos sensores que estão disponíveis no AVD. Além de usar o comando sensor, você pode consultar e ajustar as configurações no emulador na tela Virtual sensors, nas guias Accelerometer e Additional sensors.

  • sensor status: lista todos os sensores e os status deles.

  • sensor get sensor-name: recebe as configurações de sensor-name. O exemplo a seguir acessa o valor do sensor de aceleração:

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

    Os valores de aceleração separados por dois-pontos (:) se referem às coordenadas x, y e z dos sensores virtuais.

  • sensor set sensor-name value-x:value-y:value-z: define os valores para sensor-name. O exemplo a seguir define o sensor de aceleração com os seguintes valores de x, y e z separados por dois pontos.

    sensor set acceleration 2.23517e-07:9.77631:0.812348
    

Emulação de SMS

  • sms send sender-phone-number textmessage Gera um SMS recebido emulado. A lista a seguir descreve os parâmetros e valores relacionados:

    • sender-phone-number: contém uma string numérica arbitrária.
    • textmessage: é a mensagem SMS.

    O exemplo a seguir envia a mensagem "hi there" para o número de telefone 4085555555:

    sms send 4085555555 hi there
    

O console encaminha a mensagem SMS para o framework do Android, que a transmite para um app no emulador que processa SMS, como o app Mensagens. Se você transmitir 10 números, eles vão ser formatados pelo app como um número de telefone. As strings numéricas mais longas ou mais curtas são exibidas da forma como foram enviadas.

Simulação de impressão digital

  • finger touch fingerprint-id: simula um dedo tocando o sensor.

  • finger remove: simula um dedo deixando o sensor.

Para instruções sobre como usar esses comandos, consulte a seção a seguir sobre simulação e validação de impressão digital.

Gravador de tela

O comando de gravação de tela permite capturar arquivos de vídeo de alta qualidade da tela física do emulador diretamente do sistema host. Isso é muito útil para pipelines de integração contínua e relatórios de bugs automatizados.

  • screenrecord {start| stop} file Inicia ou interrompe o processo de gravação da tela.
    • start file: inicia a gravação de vídeo. O arquivo de saída precisa terminar com a extensão obrigatória .webm. O vídeo capturado é salvo diretamente no diretório de saída do console do AVD: ~/.android/avd/avd_name.avd/console_out/file.
    • stop file: interrompe o processo de gravação da tela ativa.

Automação e macro

O subsistema de automação permite que os desenvolvedores gravem transições de estado de macro no dispositivo virtual em execução e as reproduzam para executar fluxos de teste automatizados.

  • automation {record| stop-record| play| stop-play} Gerencia gravações de macro automatizadas.
    • record: inicia a gravação de mudanças de estado e entradas do dispositivo.
    • stop-record: interrompe a sessão de gravação de macro atual.
    • play: inicia a reprodução de uma sequência de macro gravada.
    • stop-play: interrompe a sequência de reprodução da macro ativa.

Física (6DoF)

Os comandos de física gerenciam o registro de poses espaciais de informações empíricas para modelos de movimento físico de seis graus de liberdade (6DoF), que são usados para simular o rastreamento de movimento avançado.

  • physics {record-gt| stop} Gerencia as gravações do modelo de pose física.
    • record-gt: começa a gravar dados de movimento 6DoF de informações empíricas.
    • stop: interrompe o processo de gravação de informações empíricas atual.

Controles de dispositivo avançados

Esta seção agrega endpoints de comando de console altamente especializados para configurações de emulação avançadas, incluindo proxies de rede, configurações de várias telas, substituições de renderização e depuração direta do hipervisor.

  • multidisplay {add| del} Adiciona ou exclui monitores virtuais secundários para testar configurações multitelas. Observação: os monitores secundários não são compatíveis com perfis dobráveis, como o Pixel Fold ou o emulador redimensionável.

  • proxy {set| clear} Configura o encaminhamento de proxy de rede de maneira programática no console.

    • set host port: define as configurações de proxy de destino.
    • clear: redefine as configurações de proxy para o padrão. Observação: as operações de definição de proxy falham em ambientes de execução headless.
  • virtualscene-image {wall| table} image_path Personaliza as paredes de fundo ou as mesas horizontais mostradas na transmissão da câmera de cena virtual com um arquivo de imagem personalizado do usuário.

  • resize-display scale Ajusta dinamicamente a resolução da tela entre escalas predefinidas. Observação: os ajustes de resolução não são compatíveis com configurações headless.

  • nodraw {on| off} Desativa a renderização física da GUI na tela do host para reduzir a memória do sistema e a carga da GPU durante execuções de automação headless em segundo plano de alto volume.

  • grpc port Configura o controle programático avançado de dispositivos em endpoints de porta gRPC personalizados.

  • qemu monitor Fornece acesso direto ao terminal interativo do console do hipervisor subjacente. Esse comando só pode ser inserido em sessões ativas do console Telnet.

  • icebox track pid Ativa snapshots automatizados do sistema quando o processo do app especificado encontra uma exceção ou falha não processada.

  • phonenumber number Define o número de telefone local virtual do dispositivo de destino.

Interface programática do gRPC

As versões modernas do emulador oferecem suporte a uma poderosa interface programática gRPC, além do console Telnet legado. Embora o console do Telnet seja ótimo para sessões interativas rápidas ou scripts básicos, a interface gRPC foi projetada para controle automatizado de alto desempenho, seguro e robusto em ambientes de integração contínua (CI) e headless. Ao oferecer endpoints de serviço direto, o gRPC elimina a necessidade de analisar streams de texto, gerenciar handshakes de sessão de terminal ou expor portas de localhost não criptografadas.

Para ajudar a escolher entre o console Telnet legado e a interface programática gRPC moderna, confira a seguinte comparação de recursos de desempenho, segurança e recursos:

Recurso Console do Telnet Interface gRPC
Ideal para Depuração manual, sessões interativas. CI/CD headless, plataformas de teste automatizadas pesadas.
Velocidade Mais lento; sobrecarga de texto, latência de conexão. Otimizado; HTTP/2 multiplexado, proto rápido.
Segurança Não criptografado; portas locais (5554–5585). Pode ser protegido por TLS, funciona em redes.
Streams Não compatível. Somente solicitação-resposta. Streams para logcat, captura de áudio de convidado.
Mídia Grava arquivos de saída no disco do host/convidado. Buffers binários diretos por cabo.
SO convidado Restrito a comandos fixos do emulador. Executa comandos nativos do shell bash convidado.

Como iniciar e chamar o gRPC

Para usar os endpoints gRPC, inicie o Android Emulator na linha de comando e inclua a flag -grpc, especificando a porta de loopback de destino.

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

Depois que o emulador estiver em execução com o serviço gRPC ativado, será possível fazer chamadas RPC programáticas. Para testes de linha de comando, use o utilitário grpcurl para se comunicar com os serviços do emulador. Todas as solicitações são formatadas em JSON e enviadas em texto simples.

# 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

Console do Telnet para mapeamento de serviço gRPC

A tabela de referência a seguir mapeia os comandos legados do console Telnet para os serviços e métodos gRPC correspondentes, indicando como automatizar interações comuns de dispositivos virtuais de forma programática:

Categoria Comando Telnet legado Serviço / método gRPC
Status ping EmulatorController/getStatus
Status avd name incubating.AvdService/getAvdInfo
Status kill EmulatorController/setVmState
Status restart EmulatorController/setVmState
Alimentação power display EmulatorController/getBattery
Alimentação power capacity EmulatorController/setBattery
Localização geográfica geo fix EmulatorController/setGps
Sensores sensor set incubating.SensorService/setSensor
Biometria finger touch EmulatorController/sendFingerprint
Postura posture EmulatorController/setPosture
Postura physics / fold EmulatorController/setPhysicalModel
SMS sms send EmulatorController/sendSms
Chamada GSM gsm call EmulatorController/sendPhone
Chamada GSM phonenumber EmulatorController/setPhoneNumber
Redirecionamento redir add Waterfall/ForwardPort
Entrada event send EV_KEY EmulatorController/sendKey
Entrada event send EV_ABS EmulatorController/sendTouch
Mídia screenrecord incubating.ScreenRecording
Renderização nodraw EmulatorController/setDisplayMode
Snapshots avd snapshot list SnapshotService/ListSnapshots
Snapshots avd snapshot load/save SnapshotService/LoadSnapshot

Comandos programáticos exclusivos do gRPC

A interface gRPC oferece vários recursos de ponta que são fisicamente impossíveis de executar em conexões de console Telnet legadas. Isso inclui streaming direto do logcat, captura ou injeção de áudio bidirecional, modificações na GUI do host e acesso direto ao shell.

Serviço / método gRPC Parâmetro Capacidade
streamLogcat {"maxLines": 100} Transmite as saídas do logcat do sistema convidado.
streamAudio {} Transmite o áudio do alto-falante por cabo
injectAudio {"audio": "..."} Injeta streams de áudio do microfone
UiController {"theme": "DARK"} Modifica os temas da janela do host
Waterfall/Exec {"cmd": "ls"} Executa comandos nativos do shell do SO convidado

Simulação e validação de impressão digital

Figura 1. Tela de autenticação de impressão digital.

Use o comando finger para simular e validar a autenticação de impressão digital para seu app. Você vai precisar das Ferramentas do SDK 24.3 ou versão mais recente e do Android 6.0 (nível 23 da API) ou mais recente.

Para simular e validar a autenticação de impressão digital, siga estas etapas:

  1. Se você ainda não tiver um ID de impressão digital, registre uma nova impressão digital no emulador selecionando Configurações > Segurança > Impressão digital e seguindo as instruções de registro.

  2. Configure o app para aceitar a autenticação por impressão digital. Depois de realizar essa configuração, o dispositivo vai mostrar a tela de autenticação por impressão digital.

  3. Enquanto o app mostra a tela de autenticação de impressão digital, acesse o console e digite o comando finger touch e o ID da impressão digital que você criou. Isso simula o toque de um dedo.

  4. Em seguida, digite o comando finger remove para simular a remoção do dedo. O app precisa responder como se um usuário tivesse tocado e removido o dedo do sensor de impressão digital.