Ferramentas do Android Studio para XR

Esta documentação mostra como usar o emulador do Android XR e o Layout Inspector no Android Studio para criar um app de realidade estendida.

O Android Studio inclui os seguintes novos recursos para XR:

  • Emulador do Android XR
  • Suporte a XR no Layout Inspector

Tela do emulador do Android Studio

Emulador do Android XR

O emulador Android XR oferece um dispositivo XR virtualizado para testar e depurar seus apps XR no Android Studio. Ele emula um dispositivo de RV, permitindo que você use seu app em um ambiente espacial 3D. Isso permite criar apps sem a necessidade de hardware físico durante as primeiras etapas de desenvolvimento, agilizando seu fluxo de trabalho e acelerando a iteração.

Se esta for a primeira vez que você usa um emulador com o Android Studio, consulte a documentação geral do emulador do Android.

Iniciar o emulador do Android XR

Depois de instalar o emulador Android XR, clique no botão Executar no Gerenciador de dispositivos.

Tela do gerenciador de dispositivos do Android Studio

Ativar o mouse e o teclado

No momento, o emulador só aceita entrada de mouse e teclado. Ao usar o emulador, verifique se o ícone de teclado e mouse está selecionado.

Ícone do mouse e do teclado do dispositivo Android Studio

Depois disso, você pode começar a interagir com vários elementos no espaço virtual movendo o mouse sobre a janela do emulador.

Olhar e se movimentar no ambiente virtual

O emulador do Android XR renderiza elementos de aplicativos em um ambiente virtual 3D. Use os seguintes controles para mudar a direção da sua visualização, fazer panorâmica, dolly, girar e redefinir:

Ícone de movimento panorâmico do Android Studio

Panorâmica: clique e arraste o mouse para mover para cima, para baixo e para os lados. Isso permite visualizar o conteúdo do emulador de diferentes ângulos

Ícone de dolly do Android Studio

Movimento de câmera: clique e arraste o mouse para se aproximar ou se afastar dos objetos na tela.

Ícone de rotação do Android Studio

Girar: clique e arraste o mouse para girar a visualização nessa direção

Ícone de redefinição do Android Studio

Redefinir: clique neste botão para retornar o emulador à visualização padrão.

Você também pode usar os seguintes atalhos de teclado para navegar no ambiente virtual. Para usar esses recursos com o mouse e o teclado, mantenha pressionada a tecla Option (macOS) ou Alt (Windows).

  • W (ou tecla de seta para cima): avança na visualização atual.
  • A (ou tecla de seta para a esquerda): passo lateral para a esquerda.
  • S (ou tecla de seta para baixo): move para trás.
  • D (ou tecla de seta para a direita): movimento lateral para a direita.
  • Q: Mova verticalmente para baixo.
  • E: Mova verticalmente para cima.

Ativar o modo de passagem

Use a seguinte opção de menu para ativar ou desativar um ambiente de transferência simulada.

Modo de transferência direta da interface do Android Studio

Quando ativado, o modo de passagem mostra um ambiente interno simulado. Use esse modo para testar aplicativos em realidade mista.

Tela do emulador do Android Studio

Outros controles do emulador

Ícone de energia do Android Studio

Energia: simula ligar ou desligar o dispositivo

Ícone de aumentar volume do Android Studio Ícone de diminuir volume do Android Studio

Volume: simula o controle de volume

Ícone de captura de tela do Android Studio

Captura de tela: faz uma captura de tela do estado atual do dispositivo.

Ícone de voltar do Android Studio Ícone da página inicial do Android Studio Ícone de visão geral do Android Studio

Controle de três botões do Android: simula os botões "Voltar", "Home" e "Visão geral".

Solução de problemas

Consulte as notas da versão para conferir problemas conhecidos e soluções alternativas.

Se você encontrar um problema que não é conhecido, consulte a página de suporte para instruções sobre como receber ajuda e informar problemas.

Incluir um relatório de falha ou de bug vai nos ajudar a entender melhor o problema. Capturas de tela e gravações também fornecem mais detalhes necessários. As instruções nesta seção explicam como fazer upload de um relatório de erros e usar o adb para gerar um relatório de bug.

Usar o Layout Inspector do Android Studio com um app de RV

Depois de começar a criar seus painéis espaciais e orbitadores, inspecione o layout com o Layout Inspector do Android Studio. Se você não conhece o Layout Inspector, consulte nosso guia sobre depuração de layouts.

Siga estas etapas para usar o Layout Inspector com seu app Android XR:

  1. Com o projeto aberto no Android Studio, verifique se o Layout Inspector incorporado está desativado. Para isso, desmarque a opção e reinicie o Android Studio. Página de configurações do Android Studio
  2. Execute o app.
  3. Quando a implantação do aplicativo for concluída, escolha Tools > Layout Inspector.

O Layout Inspector será aberto em uma janela incorporada. Depois de alguns segundos, a prévia aparece à esquerda e a árvore de componentes à direita. Os orbiters e painéis aparecem como objetos separados abaixo do conteúdo principal.

Página do Layout Inspector do Android Studio

Agora você pode interagir com o app no emulador. Para inspecionar qualquer componente, clique nele na prévia ou na árvore de componentes.

Para conferir os atributos do componente, clique na guia "Atributos" no canto direito.

Página do Layout Inspector do Android Studio

Ativar as estatísticas de uso para ajudar a melhorar o Android Studio para XR

Considere ativar as estatísticas de uso e enviar feedback para nos ajudar a melhorar essas ferramentas. Como essa é uma versão canário do Android Studio, muitos desses recursos ainda estão em desenvolvimento.

Clique em Configurações > Aparência e comportamento > Configurações do sistema > Compartilhamento de dados e verifique se a opção Enviar estatísticas de uso ao Google está selecionada.

Página de configurações do Android Studio


OpenXR™ e o logotipo OpenXR são marcas registradas de propriedade da The Khronos Group Inc. e estão registradas como marcas comerciais na China, na União Europeia, no Japão e no Reino Unido.