Sobreposição de desempenho do ARCore

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

Ativar a sobreposição de desempenho

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. O 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 estar visíveis no dispositivo tela.

  2. Use o seguinte comando de transmissão do gerenciador de atividades para ativar a sobreposição de desempenho do seu 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ê pode ser direcionado ao menu Settings para conceder o pacote ARCore para desenhar sobreposições. Esta etapa só precisa ser realizada uma vez. Localizar Google Play Services for AR e definir o botão de alternância de permissões como Allowed antes de voltar ao aplicativo.

    Se você ativou a sobreposição de desempenho sem conceder o ARCore permissão para desenhar sobreposições, você será direcionado para o menu "Configurações" hora em que o app inicia uma nova sessão do ARCore. Nesse caso, você deve conceda permissão ao ARCore ou desative 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. O 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 estar visíveis no dispositivo tela.

  2. Use o seguinte comando de transmissão do gerenciador de atividades para desativar a sobreposição de desempenho do seu 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 na limpeza as preferências compartilhadas do Android do seu app. Uma forma de fazer isso é limpar os dados dados.

Como interpretar valores de uso da CPU

O campo Process CPU Usage mostra o tempo de CPU que o processo de inscrição usa atualmente como uma porcentagem do total do dispositivo o tempo de CPU disponível. Esse valor inclui cargas de trabalho de aplicativos, cargas de trabalho do ARCore e das outras bibliotecas usadas pelo app. Por exemplo, o campo exibiria 25% de uso da CPU se o processo do aplicativo satura totalmente um único núcleo da CPU quando em um dispositivo quad-core.

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

A sobreposição não exibe recursos desativados ou que usam menos de 0,1% de tempo de CPU.