Executar as experiências de realidade aumentada do app no emulador

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Óculos com áudio e
tela

Ao testar o app, use o emulador Android XR para ampliar sua capacidade de teste além dos dispositivos físicos. Use os controles do emulador para testar como o app se comporta em cenários comuns com óculos com áudio e óculos com tela. Consulte as seções a seguir para saber como executar seus dispositivos Android XR virtuais no emulador e os controles do emulador que você pode usar.

Executar o aplicativo no emulador

Para executar o app no emulador, siga estas etapas:

  1. No Gerenciador de dispositivos do Android Studio, encontre o AVD de smartphone que você criou para atuar como um dispositivo host para o AVD de óculos e clique em Iniciar .

    Clique

  2. No Gerenciador de dispositivos do Android Studio, encontre o AVD de óculos que você criou e clique em Iniciar.

    Clique

  3. Para iniciar o app no emulador, selecione o AVD do smartphone no menu suspenso do dispositivo de destino na barra de ferramentas principal do Android Studio e clique em Run.

    Configuração de execução do app no Android Studio

Usar controles do emulador para óculos

Use os controles do emulador para testar como o app se comporta em cenários comuns com óculos com áudio e óculos com tela. Consulte as seções a seguir para mais detalhes sobre cada um dos controles que você pode usar.

Fornecer entrada do touchpad

Como os óculos com áudio e com tela não têm touch screen, as interações usam um touchpad no dispositivo físico. No emulador Android XR, o touchpad fica logo abaixo da área de exibição.

Use o mouse do computador na área do touchpad para simular o toque e ative o modo Two Finger para realizar gestos com dois dedos.

O lado direito da área do touchpad do emulador representa a área em um dispositivo real que fica na frente dos óculos (onde estão as lentes), enquanto o lado esquerdo representa a área em um dispositivo real que fica na parte de trás dos óculos (onde os óculos ficam apoiados nas orelhas). Saber essa orientação é importante ao simular gestos como deslizar para frente ou para trás.

Figura 1. A área do touchpad no emulador Android XR fica logo abaixo da área de exibição.

Fornecer entrada de texto por voz

Para ativar ou desativar o microfone, selecione Microphone nos controles do emulador. Isso conecta e envia entrada ao emulador usando o dispositivo de entrada de microfone padrão do computador. Isso tem o mesmo efeito que usar a opção Virtual microphone uses host audio input nos controles estendidos do emulador.

Enquanto o microfone estiver ligado, fale para usar hotwords e dar comandos.

Figura 2. Ative o microfone para usar o microfone do computador para fornecer entrada de voz.

Simular óculos com áudio

Ao testar seu app para óculos com tela, você precisará simular um par de óculos com áudio para que seu app possa oferecer suporte a ambos os tipos de óculos.

Para ajudar você a testar esses casos de uso, o app Glasses permite ativar o modo somente áudio:

  1. No emulador de smartphone, abra o app Óculos.

    O ícone do app Glasses.

  2. Toque em Configurações do dispositivo e ative o Modo somente áudio.

    Ative ou desative o modo somente áudio pelos óculos .

  3. Pare o emulador de smartphone e o emulador de óculos.

  4. No Gerenciador de dispositivos do Android Studio, encontre o AVD do smartphone e clique em Cold Boot no menu flutuante.

    Clique

  5. Siga as outras etapas para reiniciar o emulador de óculos e executar o app.

Desativar o tempo limite de adiamento da tela

O comportamento de tempo limite da tela é uma consideração importante ao desenvolver as experiências do app para óculos com áudio e com tela. Por esse motivo, recomendamos manter o comportamento padrão ao realizar os testes normais do app. No entanto, se o tempo limite de exibição interferir nos testes, você pode desativar o comportamento padrão usando o seguinte comando do ADB:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout false

Para restaurar o comportamento padrão de tempo limite da tela, execute o seguinte comando do ADB:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout true

Usar o Gemini Live

Siga estas etapas para acionar o Gemini Live no emulador de óculos:

  1. Antes de tentar usar o Gemini Live, atualize o app do Google para a versão mais recente (a versão mínima necessária é 16.46.63) no emulador de smartphone:

    1. No emulador de smartphone, abra o app Google Play Store.
    2. Pesquise "Google" e selecione o app do Google.

      Atualize o app do Google na Google Play Store.

    3. Selecione Update.

  2. Toque e mantenha pressionado o touchpad por cerca de 2 segundos para acionar o Gemini Live no emulador de óculos.

    Na primeira vez, isso vai acionar um conjunto de solicitações de permissão no emulador do smartphone. Conceda todas as permissões necessárias e toque e pressione o touchpad no emulador de óculos por cerca de 2 segundos novamente.

    Aceite todas as permissões necessárias para usar o Gemini Live no emulador de óculos.

    Quando o Gemini Live estiver ativo e ouvindo, você verá o seguinte no emulador de óculos:

    Um indicador visual aparece na tela quando o Gemini Live está ativo.

  3. Verifique se a entrada do microfone do host está ativa no emulador de óculos olhando para o emulador de smartphone. Você vai receber uma notificação como esta:

    Uma notificação no emulador de smartphone indica que a entrada do microfone do host
está ativa.

Usar ambientes personalizados

Você pode testar usando fotos de ambientes reais (incluindo imagens 2D estáticas e imagens panorâmicas em 360 graus) ou entrada de câmera de webcam para avaliar como suas experiências aumentadas seriam renderizadas nesses cenários usando o Jetpack Compose Glimmer.

Embora o tema padrão seja pré-otimizado para ambientes claros e escuros, as personalizações específicas da marca exigem novos testes cuidadosos. Teste com cuidado para que sua interface mantenha alta visibilidade e contraste em telas ópticas transparentes, independentemente do ambiente do usuário.

Para usar uma imagem estática personalizada ou uma entrada de câmera de webcam como plano de fundo no emulador:

  1. Selecione Ambientes nos controles do emulador.
  2. No menu suspenso, selecione Ambiente personalizado para imagens personalizadas enviadas por upload ou Câmera para entrada de câmera de webcam.

    Selecione uma imagem personalizada de ambiente de foto ou uma entrada de câmera de webcam no Android
Studio.

  3. Para ambientes personalizados, escolha uma imagem para usar ou selecione uma imagem usada anteriormente na lista Ambientes recentes.

    Enquanto você visualiza a IU do app, o ambiente personalizado aparece em
segundo plano.

Ambientes de fotos panorâmicas em 360 graus

O emulador é compatível com panoramas equirretangulares padrão nos formatos JPG ou PNG. As fotos em 360 graus permitem testar seus apps para óculos em um cenário mais realista, em que o movimento e a rotação da cabeça desempenham um papel na avaliação de elementos da interface de fácil visualização.

Para girar a visualização no ambiente, mantenha pressionada a tecla Shift enquanto usa o mouse ou as teclas de seta do teclado.

Fazer uma captura de tela

Para capturar a saída visual do app em execução no emulador, faça capturas de tela.

Para fazer isso, clique em Take screenshot nos controles do emulador.

Use os controles do emulador para fazer uma captura de tela do emulador no Android Studio.
 

Isso funciona da mesma forma que fazer capturas de tela para outros dispositivos virtuais no emulador Android XR e salva a captura de tela como um arquivo PNG.

Fazer uma gravação de tela

Para gravar a tela do app em execução no emulador:

  1. Clique em Record Screen nos controles do emulador.

    Use os controles do emulador para fazer uma gravação de tela da tela do emulador
no Android Studio.

  2. Selecione "Mostrar toques" se quiser destacar as interações do usuário.

  3. Depois de capturar o que você precisa, clique em Parar gravação.

    Uma prévia vai aparecer, e você poderá salvar o arquivo no computador.

Capturar fotos ou vídeos

Os recursos de captura de câmera no emulador Android XR ainda não estão disponíveis.

Ativar o tempo limite de adiamento da tela

Por padrão, a tela do emulador não entra em modo de suspensão enquanto você desenvolve e testa o app. No entanto, o comportamento de tempo limite da tela é importante ao projetar experiências para óculos com tela reais. Devido às restrições rígidas de bateria e temperatura dos óculos com tela, otimize o consumo de energia para que os usuários possam interagir com os dispositivos pelo maior tempo possível. Ative o tempo limite de adiamento da tela e teste o app para observar o comportamento real do dispositivo e ajustar o app de acordo.

Para ativar o tempo limite de exibição, execute o seguinte comando ADB:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout true

Para restaurar o comportamento padrão sem tempo limite, execute o seguinte comando ADB:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout false