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 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 dispositivos XR virtualizados para teste e depuração de apps XR no Android Studio. Ele emula dispositivos XR, 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 do dispositivo correspondente no Gerenciador de dispositivos.

Tela do gerenciador de dispositivos do Android Studio

Controles do emulador de XR

Quando o emulador do Android XR for carregado, observe o menu no canto inferior direito. Esse menu permite selecionar vários controles para interação com o emulador.

Tela do gerenciador de dispositivos do Android Studio

Ativar o mouse e o teclado

O emulador é compatível com a interação por entrada de mouse e teclado. Ao interagir com o sistema ou um aplicativo Android no emulador, verifique se o ícone de interação 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 mover no ambiente virtual

O emulador do Android XR renderiza aplicativos e conteúdo em um ambiente virtual 3D. Use os controles a seguir para mudar a direção da visualização, girar, mover, fazer dolly e redefinir:

Ícone de rotação do Android Studio

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

Ícone de movimento panorâmico do Android Studio

Panorâmica: arraste o mouse para cima, para baixo e de um lado para o outro. Isso permite visualizar o conteúdo do emulador de diferentes ângulos

Ícone de dolly do Android Studio

Movimento de câmera: arraste o mouse para se aproximar ou se afastar dos objetos em exibiçã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): passo lateral para a direita.
  • Q: Mova verticalmente para baixo.
  • E: Mova verticalmente para cima.

Ativar o modo de passagem

O menu na parte de cima do emulador inclui a opção de ativar ou desativar um ambiente de transmissão 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 Ícone de gravação de tela do Android Studio

Captura de tela: faz uma captura de tela ou gravação da 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á ativado.

    Configurações do Layout Inspector 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. Se quiser inspecionar um 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 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 está selecionada.

Configurações de compartilhamento de dados 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.