Sobreposição de desempenho do ARCore

O ARCore pode exibir um painel de sobreposição com as estatísticas de desempenho de um app, como o uso de CPU e memória, fornecendo uma visão geral em tempo real dos recursos do sistema.

Ativar a sobreposição de performance

Siga estas etapas para ativar a sobreposição de desempenho.

  1. Abra a experiência de RA no seu app para que haja uma sessão ativa do ARCore em execução. Seu app precisa estar no modo RA para receber a transmissão que ativa a sobreposição. As imagens de visualização da câmera de RA precisam aparecer na tela do dispositivo.

  2. Use o comando de transmissão do gerenciador de atividades abaixo para ativar a sobreposição de desempenho do app.

    # Enables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains enabled in
# subsequent ARCore sessions.

# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.ENABLE_PERFORMANCE_OVERLAY

  3. Você será direcionado ao menu Settings para conceder ao pacote ARCore permissão para desenhar sobreposições. Essa etapa só precisa ser realizada uma vez. Encontre Google Play Services for AR e defina o botão de alternância de permissões como Allowed antes de voltar ao app.

    Se tiver ativado a sobreposição de desempenho sem conceder ao ARCore permissão para desenhar sobreposições, você será direcionado para o menu "Configurações" sempre que o app iniciar uma nova sessão do ARCore. Nesse caso, é necessário conceder permissão ao ARCore ou desativar a sobreposição de desempenho.

Desativar a sobreposição de desempenho

Siga estas etapas para desativar a sobreposição de desempenho.

  1. Abra a experiência de RA no seu app para que haja uma sessão ativa do ARCore em execução. Seu app precisa estar no modo RA para receber a transmissão que desativa a sobreposição. As imagens de visualização da câmera de RA precisam aparecer na tela do dispositivo.

  2. Use o comando de transmissão do gerenciador de atividades abaixo para desativar a sobreposição de desempenho do app.

    # Disables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains disabled in
# subsequent ARCore sessions.

# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.DISABLE_PERFORMANCE_OVERLAY

Você também pode desativar a sobreposição de desempenho tocando no botão Fechar na sobreposição e limpando as preferências compartilhadas do Android do seu app. Uma maneira de fazer isso é limpar os dados do app.

Como interpretar valores de uso da CPU

O campo Process CPU Usage exibe a quantidade de tempo de CPU que o processo do aplicativo usa atualmente como porcentagem do tempo de CPU total disponível do dispositivo. Esse valor inclui cargas de trabalho de aplicativo, cargas de trabalho do ARCore e todas as outras bibliotecas usadas pelo app. Por exemplo, o campo mostraria 25% de uso da CPU se o processo do aplicativo saturar totalmente um único núcleo da CPU ao ser executado em um dispositivo quad-core.

A sobreposição de desempenho também fornece um detalhamento do uso da CPU para recursos individuais do ARCore. Esses detalhamentos também são expressos como uma porcentagem do tempo total de CPU disponível do dispositivo. As cargas de trabalho são:

A sobreposição não exibe nenhum recurso que esteja desativado ou que use menos de 0,1% do tempo de CPU.