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

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.

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.

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:
|   | 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 | 
|   | Movimento de câmera: clique e arraste o mouse para se aproximar ou se afastar dos objetos na tela. | 
|   | Girar: clique e arraste o mouse para girar a visualização nessa direção | 
|   | 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.

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

Outros controles do emulador
|   | Energia: simula ligar ou desligar o dispositivo | 
|     | Volume: simula o controle de volume | 
|   | Captura de tela: faz uma captura de tela do estado atual do dispositivo. | 
|       | 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:
- 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.
 
- Execute o app.
- 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.

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.

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.

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.
