Capturar e analisar traces de desempenho no Android XR Engine Hub

Dispositivos XR relevantes

Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.

Saiba mais sobre esses dispositivos →

Saiba mais sobre esses dispositivos →

O Android XR Engine Hub permite capturar traces de desempenho de alta frequência do sistema e do aplicativo diretamente do dispositivo Android XR conectado. Quando uma gravação de trace termina, o Android XR Engine Hub realiza automaticamente as seguintes ações:

• Salva o arquivo de trace .perfetto na estação de trabalho e o abre na interface da Web do Perfetto com parâmetros de janela de visualização pré-configurados (visStart e visEnd).
• Reduz a captura bruta de .perfetto localmente na estação de trabalho para um resumo de texto conciso sobre a utilização de CPU e GPU, estatísticas de tempo para a renderização do frame e frames perdidos.
• Envia o resumo reduzido do trace para o Gemini (quando configurado com sua chave de API) para diagnosticar gargalos de frame rate e fornecer recomendações de otimização acionáveis diretamente no hub.

Configurar a chave de API Gemini

A análise de trace com tecnologia de IA usa um fluxo de trabalho de traga sua própria chave (BYOK, na sigla em inglês) com uma chave de API do Google AI Studio. Se você não configurar uma chave de API, ainda poderá gravar traces e inspecioná-los na interface da Web do Perfetto, mas os diagnósticos automatizados do Gemini não serão executados.

Para configurar sua chave de API Gemini:

1. Receba uma chave de API Gemini no Google AI Studio.
2. Abra o Android XR Engine Hub e selecione Configurações na barra lateral de navegação à esquerda (ou clique em Adicionar chave de API Gemini nas configurações na página Desempenho).
3. No campo Chave de API Gemini, cole sua chave de API.

4. Clique em Salvar.

   É possível atualizar sua chave a qualquer momento ou limpar o campo Chave de API do Gemini e clicar em Salvar para remover a chave salva da estação de trabalho.

Registrar e analisar um trace de desempenho

Siga estas etapas para capturar um rastro de desempenho do dispositivo Android XR conectado e analisar os resultados:

1. Conecte o dispositivo Android XR à estação de trabalho usando um cabo USB-C e selecione-o no menu suspenso de dispositivos na parte de cima do Android XR Engine Hub.

2. Inicie o app ou a cena de XR que você quer analisar no dispositivo.

3. Na barra lateral de navegação à esquerda do Android XR Engine Hub, selecione Performance.

4. No card XR Device Tracing, clique em Start Recording e reproduza o problema de interação ou desempenho no dispositivo.

   

5. Clique em Stop Recording quando terminar ou aguarde o rastreamento parar automaticamente ao atingir o limite de 30 segundos.

Quando a gravação é concluída, o Android XR Engine Hub processa a captura e fornece os resultados de três maneiras:

• Interface da Web do Perfetto: o navegador padrão abre o rastro capturado na interface da Web do Perfetto para que você possa inspecionar faixas detalhadas da linha do tempo, compilação de sombreadores e programação de linhas de execução.
• Resultado da análise de desempenho: se você configurou uma chave de API do Gemini, o painel Resultado da análise de desempenho vai mostrar Analisando o rastro com o Gemini enquanto o resumo do rastro local é avaliado e, em seguida, vai renderizar um relatório estruturado destacando os principais gargalos, frames perdidos e correções sugeridas. Clique no ícone de cópia no canto superior direito do painel para copiar o relatório Markdown para a área de transferência.
• Arquivos de trace locais: clique em Traces no card XR Device Tracing para abrir a pasta de saída local que contém os arquivos .perfetto salvos.