Controles estendidos, configurações e ajuda

Use os controles estendidos no Android Emulator para enviar dados, mudar propriedades do dispositivo, controlar apps e muito mais. Para abrir a janela Extended controls, clique em More Ícone de controles estendidos do emulador no painel do emulador. Algumas dessas opções de controle estendido só estão disponíveis quando você executa o emulador em uma janela separada fora do Android Studio.

Você pode usar atalhos de teclado para realizar muitas dessas tarefas. Para ver uma lista completa de atalhos no emulador, pressione F1 (Command+/ no macOS) para abrir o painel "Help".

Tabela 1. Detalhes dos controles estendidos.

Recurso Descrição
Telas

O emulador permite implantar seu app em várias telas, o que possibilita o uso de dimensões personalizáveis e pode ajudar você a testar apps com suporte a várias janelas e várias telas. Enquanto um dispositivo virtual está em execução, é possível colocar até duas telas adicionais da seguinte maneira:

  1. Adicione outra exibição clicando em Add secondary display.
  2. No menu em Secundários, siga um destes procedimentos:
    1. Selecione uma das proporções predefinidas.
    2. Selecione custom e defina height (altura), width (largura) e dpi da tela personalizada.
  3. Opcional: clique em Adicionar tela secundária novamente para adicionar uma terceira exibição.
  4. Clique em Apply changes para adicionar as telas especificadas ao dispositivo virtual em execução.
Rede celular

O emulador permite que você simule diversas condições de rede. Você pode aproximar a velocidade de rede de diferentes protocolos ou especificar a opção Full, que transfere dados na velocidade máxima permitida pelo computador. Especificar um protocolo de rede é sempre mais lento do que a opção Full. Também é possível especificar o status de rede de dados e voz, como roaming. Os valores padrão são definidos no AVD.

Selecione uma opção para Network type:

  • GSM: Global System for Mobile Communications
  • HSCSD: High-Speed Circuit-Switched Data
  • GPRS: Generic Packet Radio Service
  • EDGE: Enhanced Data rates for GSM Evolution
  • UMTS: Universal Mobile Telecommunications System
  • HSPDA: acesso de pacotes de downlink de alta velocidade
  • LTE: Long-Term Evolution
  • Full (padrão): usa a rede disponibilizada pelo computador

Selecione uma opção para Signal strength, a intensidade do sinal:

  • Nenhum
  • Ruim
  • Moderate (padrão)
  • Boa
  • Ótimo

Selecione uma opção para Voice status (status de voz), Data status (status dos dados) ou para ambos:

  • Home (padrão)
  • Roaming
  • Pesquisa
  • Negado (somente chamadas de emergência)
  • Não registrado (desativado)
Bateria

Você pode simular as propriedades da bateria de um dispositivo para saber como é o desempenho do app em diferentes condições. Para selecionar um valor para Charge level, o nível de carregamento, use o controle deslizante.

Selecione um valor para Charger connection, o tipo de conexão:

  • None
  • AC charger

Selecione um valor para Battery health, a integridade da bateria:

  • Good (padrão)
  • Com falha
  • morta
  • Sobretensão
  • Superaquecido
  • Desconhecido

Selecione um valor para Battery status, o status da bateria:

  • Desconhecido
  • Charging (padrão)
  • Descarregando
  • Não está carregando
  • Total
Câmera Você pode carregar imagens na cena que é simulada quando você abre a câmera do emulador. Para mais informações, consulte Adicionar imagens aumentadas à cena na documentação do ARCore.
Localização

O emulador permite simular as informações de "Meu local" onde o dispositivo emulado está localizado. Por exemplo, se você clicar em "Meu local" Ícone "Meu local" no Google Maps e enviar uma localização, o mapa vai mostrá-la.

Os controles das informações de local do dispositivo são organizados em duas guias: Single points e Routes.

Pontos únicos

Na guia Single points, você pode usar a visualização da Web do Google Maps para pesquisar pontos de interesse, assim como faria ao usar o Google Maps em um smartphone ou navegador. Ao pesquisar ou clicar em um local no mapa, você pode salvar o local selecionando Save point próximo à parte de baixo do mapa. Todos os seus locais salvos são listados no lado direito da janela Extended controls.

Para definir a localização do emulador como a localização selecionada no mapa, clique no botão Set location perto do canto inferior direito da janela Extended controls.

Rotas

Semelhante à guia Single points, a guia Routes fornece uma visualização da Web do Google Maps que você pode usar para criar um trajeto entre dois ou mais locais. Para criar e salvar uma rota, faça o seguinte:

  1. Na visualização de mapa, use o campo de texto para pesquisar o primeiro destino no seu trajeto.
  2. Selecione o local nos resultados da pesquisa.
  3. Selecione o botão Navegar .
  4. Selecione o ponto de partida do seu trajeto no mapa.
  5. (Opcional) Clique em Add destination para adicionar mais paradas ao trajeto.
  6. Salve seu trajeto clicando em Save route na visualização do mapa.
  7. Especifique um nome para o trajeto e clique em Save.

Para simular o emulador seguindo o trajeto que você salvou, selecione o trajeto na lista de Saved routes e clique em Play route próximo ao canto direito de baixo da janela Extended controls. Para interromper a simulação, clique em Stop route.

Para simular continuamente o emulador seguindo o trajeto especificado, ative a chave ao lado de Repeat playback. Para mudar a velocidade com que o emulador segue o trajeto especificado, selecione uma opção no menu Playback speed.

Importar dados GPX e KML

Para usar dados geográficos de um arquivo GPX (GPS Exchange) ou KML (Keyhole) Markdown Language (KML):

  1. Clique em Load GPX/KML.
  2. Na caixa de diálogo do arquivo, selecione um arquivo no computador e clique em Open.
  3. Opcionalmente, selecione um valor em Speed para a velocidade.
  4. A velocidade tem o valor padrão Delay (Speed 1X). Você pode aumentar a velocidade em duas vezes (Speed 2X), três vezes (Speed 3X) e assim por diante.

  5. Clique em Run Ícone de "Run".
Smartphone

O emulador permite que você simule o recebimento de chamadas telefônicas e mensagens de texto.

Para iniciar uma chamada para o emulador:

  1. Selecione ou digite um número de telefone no campo From.
  2. Clique em Call Device.
  3. Também é possível clicar em Hold Call para colocar a chamada em espera.
  4. Para encerrar a chamada, clique em End Call.

Para enviar uma mensagem de texto para o emulador:

  1. Selecione ou digite um número de telefone no campo From.
  2. Digite uma mensagem no campo SMS message.
  3. Clique em Send Message.
Botão direcional

Se o AVD tiver o botão direcional ativado no perfil de hardware, você poderá usar os controles desse botão com o emulador. No entanto, nem todos os dispositivos oferecem suporte ao botão direcional, por exemplo, relógios Android. Os botões simulam as seguintes ações:

Controle do botão direcional
Microfone Quando a opção Virtual microphone uses host audio input está ativada, o emulador recebe a entrada de áudio do microfone do host. Caso contrário, o emulador não recebe nenhuma entrada de áudio. As opções Virtual headset plug inserted, Virtual headset has microphone e Voice Assist não estão implementadas no momento.
Impressão digital

Esse controle pode simular até 10 verificações de impressões digitais diferentes. Você pode usá-lo para testar a integração de impressões digitais no seu app. Esse recurso está desativado para Android 5.1 (nível 22 da API) e anteriores e para Wear OS.

Para simular uma verificação de impressão digital no dispositivo virtual:

  1. Prepare um app para receber uma impressão digital.
  2. Selecione um valor para Fingerprint.
  3. Clique em Touch Sensor.
Virtual sensors > Device Pose

Esse controle permite que você teste seu app em relação a mudanças na posição do dispositivo, na orientação dele ou em ambos. Por exemplo, você pode simular gestos, como inclinação e rotação. O acelerômetro não acompanha a posição absoluta do dispositivo, ele apenas detecta quando uma alteração está acontecendo. O controle simula a maneira como os sensores do acelerômetro e do magnetômetro respondem quando você move ou gira um dispositivo real.

Ative o sensor do acelerômetro no AVD para usar esse controle.

O controle informa eventos TYPE_ACCELEROMETER nos eixos x, y e z. Esses valores incluem gravidade. Por exemplo, se o dispositivo estiver suspenso no espaço sideral, a aceleração dele será zero. Ou seja, todos os valores de x, y e z serão 0. Quando o dispositivo está na Terra, posicionado com a tela para cima sobre uma mesa, a aceleração é 0, 0 e 9,8 devido à gravidade.

O controle também informa eventos TYPE_MAGNETIC_FIELD, que medem o campo magnético do ambiente nos eixos x, y e z em microteslas (μT).

Para girar o dispositivo em torno dos eixos x, y e z, selecione Rotate e siga um destes procedimentos:

  • Ajuste os controles deslizantes Yaw, Pitch e Roll e observe a posição no painel de cima.
  • Mova a representação do dispositivo no painel de cima, observe os fatores Yaw, a Pitch e Roll e como os valores resultantes do acelerômetro mudam.

Para mais informações sobre como os fatores Yaw, Pitch e Roll são calculados, consulte Calcular a orientação do dispositivo.

Para mover o dispositivo horizontalmente (x) ou verticalmente (y), selecione Move e siga um destes procedimentos:

  • Ajuste os controles deslizantes X e Y e observe a posição no painel de cima.
  • Mova a representação do dispositivo no painel de cima, observe os valores dos controles deslizantes X e Y e como os valores resultantes do acelerômetro mudam.

Para posicionar o dispositivo em 0, 90, 180 ou 270 graus:

  • Na área Device rotation, selecione um botão para mudar a rotação.

Conforme você ajusta o dispositivo, os campos Resulting values são alterados. Esses são os valores que um app pode acessar.

Para ver mais informações sobre esses sensores, consulte Visão geral dos sensores, Sensores de movimento e Sensores de posição.

Virtual sensors > Additional sensors

O emulador pode simular vários sensores de posição e de ambiente. Ele permite ajustar os seguintes sensores, para que você possa testá-los com seu app:

  • Ambient temperature: esse sensor ambiental mede a temperatura do ar ambiente.
  • Magnetic field: esse sensor de posição mede o campo magnético do ambiente nos eixos X, Y e Z, respectivamente. Os valores são dados em microteslas (μT).
  • Proximity: esse sensor de posição mede a distância de um objeto. Por exemplo, ele pode notificar um telefone de que um rosto está perto dele para fazer uma ligação. O sensor de proximidade precisa estar ativado no AVD para usar esse controle.
  • Light: esse sensor ambiental mede a iluminância. Os valores são dados em unidades de lux.
  • Pressure: esse sensor ambiental mede a pressão do ar ambiente. Os valores são dados em unidades de milibar (hPa).
  • Relative Humidity: esse sensor ambiental mede a umidade relativa do ambiente.

Para mais informações sobre esses sensores, consulte Visão geral dos sensores, Sensores de posição e Sensores de ambiente .

Relatório do bug Se você tiver problemas com o emulador, prepare e envie um relatório do bug. O emulador coleta automaticamente capturas de tela, registros e outros dados do relatório do bug.
Gravação e reprodução Consulte Gravação de tela.
Google Play Quando a imagem do sistema do AVD inclui o app Play Store, são mostradas as informações da versão do Google Play Services.
Settings > General
  • Emulator window theme: selecione Light ou Dark.
  • Send keyboard shortcuts to: por padrão, algumas combinações de teclado acionam atalhos de controle do emulador. Se você estiver desenvolvendo um app que inclui atalhos de teclado, como um app direcionado a dispositivos com teclados Bluetooth, poderá mudar essa configuração para enviar todas as entradas do teclado para o dispositivo virtual, inclusive aquelas que seriam um atalho no emulador.
  • Screenshot save location: clique no ícone de pasta para especificar um local onde as capturas da tela do emulador serão salvas.
  • Use detected ADB location: se você está executando o emulador no Android Studio, selecione essa configuração (padrão). Se você executar o emulador fora do Android Studio e quiser que ele use um executável específico do adb, desmarque essa opção e especifique o local das Ferramentas do SDK. Se essa configuração estiver incorreta, alguns recursos como a captura de tela e a instalação de app "arraste e solte" não vão funcionar.
  • Quando enviar relatórios de falhas: selecione Sempre, Nunca ou Perguntar.
  • Show window frame around device: por padrão, os emuladores com arquivos de skin de dispositivo são mostrados sem moldura de janela.
Settings > Proxy

Por padrão, o emulador usa as configurações de proxy HTTP do Android Studio. Essa tela permite definir manualmente uma configuração de proxy HTTP para o emulador. Para mais informações, consulte Usar o emulador com um proxy.

Settings > Advanced
  • OpenGL ES renderer: selecione o tipo de aceleração gráfica. Isso equivale à opção de linha de comando -gpu.
    • Autodetect based on host: permite que o emulador escolha entre aceleração gráfica de hardware ou de software com base na configuração do computador. Ele verifica se o driver da GPU corresponde ou não a uma lista de drivers de GPU defeituosos conhecidos e, em caso afirmativo, o emulador desativa a emulação de hardware gráfico e usa a CPU.
    • ANGLE (apenas para Windows): Use o ANGLE Direct3D (link em inglês) para renderizar elementos gráficos no software.
    • SwiftShader: use o SwiftShader (link em inglês) para renderizar elementos gráficos no software.
    • Desktop native OpenGL: use a GPU no computador host. Essa opção normalmente é a mais rápida. No entanto, alguns drivers apresentam problemas na renderização de elementos gráficos OpenGL. Sendo assim, essa pode não ser uma escolha confiável.
  • OpenGL ES API level: seleciona a versão máxima do OpenGL ES para usar no emulador.
    • Autoselect: permite que o emulador escolha a versão do OpenGL ES com base no suporte a hosts e convidados.
    • Renderer maximum (up to OpenGL ES 3.1): tenta usar a versão máxima do OpenGL ES.
    • Compatibility (OpenGL ES 1.1/2.0): usa a versão do OpenGL ES compatível com a maioria dos ambientes.
Help > Keyboard Shortcuts

Esse painel mostra uma lista completa de atalhos de teclado do emulador. Para abrir esse painel enquanto trabalha no emulador, pressione F1 (no MacOS, Command+/).

Para que os atalhos funcionem, a opção Send keyboard shortcuts no painel de configurações General precisa ser definida como Emulator controls (default).

Help > Emulator Help

Para acessar a documentação on-line do emulador, clique em Documentation.

Para informar um bug no emulador, clique em Send feedback. Para mais informações, aprenda a informar bugs do emulador.

Help > About

Veja que porta do adb é usada pelo emulador, além dos números de versão do Android e do emulador. Compare a versão mais recente disponível do emulador com a sua para determinar se você tem o software mais recente instalado.

O número de série do emulador é emulator-adb_port, que você pode especificar como uma opção de linha de comando do adb, por exemplo.