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 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
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" 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 o local do emulador como o local que você selecionou 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: Na visualização de mapa, use o campo de texto para pesquisar o primeiro destino no seu trajeto. Selecione o local nos resultados da pesquisa. Selecione o botão Navegar . Selecione o ponto de partida do seu trajeto no mapa. (Opcional) Clique em Add destination para adicionar mais paradas ao trajeto. Salve seu trajeto clicando em Save route na visualização do mapa. 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 Markup Language): Clique em Load GPX/KML. Na caixa de diálogo do arquivo, selecione um arquivo no computador e clique em Open. Opcionalmente, selecione um valor em Speed para a velocidade. 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. Clique em Run .
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: Adicione outra exibição clicando em Add secondary display. No menu em Secondary displays, siga um destes procedimentos: Selecione uma das proporções predefinidas. Selecione custom e defina height (altura), width (largura) e dpi da tela personalizada. (Opcional) Clique em Add secondary display para adicionar uma terceira exibição. 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: High-Speed Downlink Packet Access 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 (em inglês) Pesquisando Negada (somente chamadas de emergência) Unregistered (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 morto Sobrecarga Superaquecido Desconhecido Selecione um valor para Battery status, o status da bateria: Desconhecido Charging (padrão) Descarregando Não está carregando Completo
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.
Smartphone	O emulador permite que você simule o recebimento de chamadas telefônicas e mensagens de texto. Para iniciar uma chamada para o emulador: Selecione ou digite um número de telefone no campo From. Clique em Call Device. Também é possível clicar em Hold Call para colocar a chamada em espera. Para encerrar a chamada, clique em End Call. Para enviar uma mensagem de texto para o emulador: Selecione ou digite um número de telefone no campo From. Digite uma mensagem no campo SMS message. 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:
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: Prepare um app para receber uma impressão digital. Selecione um valor para Fingerprint. 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. When to send crash reports: selecione Always, Never ou Ask. 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.