Uma sessão de jogo lenta é aquela em que uma parte significativa dos frames (por exemplo, mais de 25%) não atinge o tempo para a renderização do frame desejado, como 50 ms por frame (equivalente a 20 QPS) ou 34 ms por frame (equivalente a 30 QPS). Monitorar e otimizar o desempenho do frame rate é fundamental porque frames descartados ou atrasados afetam diretamente a fluidez e a responsividade do jogo para os jogadores.
No Android, as taxas de frames da sessão são medidas usando dados do
SurfaceFlinger com base no intervalo de tempo entre os frames
renderizados em plataformas do jogo, incluindo as plataformas do OpenGL, do Vulkan e do kit de ferramentas de interface
do Android. Se o app usa o kit de ferramentas de interface baseado em View, em que a
parte visível do app para o usuário é selecionada do
Canvas ou da hierarquia View,
consulte Renderização lenta.
Como medir QPS e detectar frames lentos
O comando dumpsys surfaceflinger timestats do Android fornece o FPS médio e o histograma de tempo de presente para presente para todas as camadas que estão sendo renderizadas. O tempo de presente para presente de um frame é o intervalo entre
o frame atual e o anterior que está sendo renderizado. Veja as
etapas para usar o comando e coletar os QPS do jogo:
Execute o comando com as flags
enableeclearpara começar a capturar informações:adb shell dumpsys SurfaceFlinger --timestats -clear -enableQuando o jogo tiver sido executado por tempo suficiente, execute o comando novamente com a flag
dumppara despejar informações:adb shell dumpsys SurfaceFlinger --timestats -dumpAs informações despejadas fornecem o total de frames e o histograma presentToPresent para todas as camadas renderizadas pelo SurfaceFlinger. Encontre a seção do jogo filtrando com base em
layerName:layerName = SurfaceView[com.google.test/com.devrel.MainActivity]@0(BLAST)#132833A taxa de frames lenta da sessão pode ser calculada com base nas informações de cada camada.
Por exemplo, a porcentagem de frames lentos de 20 QPS = (soma dos valores de 54 ms a 1.000 ms) / totalFrames x 100
totalFrames = 274 ... presentToPresent histogram is as below: 0ms=0 1ms=0 2ms=0 3ms=0 4ms=0 5ms=0 6ms=0 7ms=0 8ms=0 9ms=0 10ms=0 11ms=0 12ms=0 13ms=0 14ms=0 15ms=0 16ms=1 17ms=0 18ms=0 19ms=0 20ms=0 21ms=0 22ms=0 23ms=0 24ms=0 25ms=0 26ms=0 27ms=0 28ms=0 29ms=0 30ms=0 31ms=0 32ms=0 33ms=269 34ms=0 36ms=0 38ms=0 40ms=0 42ms=0 44ms=0 46ms=0 48ms=0 50ms=1 54ms=0 58ms=0 62ms=0 66ms=0 70ms=1 74ms=0 78ms=0 82ms=0 86ms=0 90ms=0 94ms=0 98ms=0 102ms=0 106ms=0 110ms=0 114ms=0 118ms=0 122ms=0 126ms=0 130ms=0 134ms=0 138ms=0 142ms=0 146ms=0 150ms=0 200ms=0 250ms=0 300ms=0 350ms=0 400ms=0 450ms=0 500ms=0 550ms=0 600ms=0 650ms=0 700ms=0 750ms=0 800ms=0 850ms=0 900ms=0 950ms=0 1000ms=0O FPS médio de cada camada também é mostrado no despejo:
... averageFPS = 30.179 ...Depois de coletar todas as informações, desative as timestats usando a flag
disable:adb shell dumpsys SurfaceFlinger --timestats -disable
Causas e soluções de frames lentos
Há muitos motivos para um frame ser apresentado ou renderizado na tela por mais tempo do que o esperado pelo desenvolvedor. O jogo pode estar limitado pela CPU/GPU. Ou o dispositivo está superaquecendo e ativa um estado térmico limitado. Ou há uma incompatibilidade entre a frame rate do jogo e a taxa de atualização da tela do dispositivo.
Use o Android Frame Pacing (Swappy), o Vulkan e o ADPF para resolver esses problemas e melhorar o desempenho do jogo.
O que é o Swappy?
A biblioteca Frame Pacing do Android, também conhecida como Swappy, faz parte das bibliotecas do AGDK. O Swappy ajuda jogos OpenGL e Vulkan a ter uma renderização uniforme e a corrigir o ritmo de frames no Android.
O ritmo de frames é a sincronização da lógica e do loop de renderização de um jogo com o subsistema de exibição de um SO e o hardware de exibição subjacente. O subsistema de exibição do Android foi projetado para evitar artefatos visuais (conhecidos como tearing) que podem ocorrer quando o hardware de exibição muda para um novo frame durante uma atualização. Para evitar esses artefatos, o subsistema de exibição faz o seguinte:
- Armazena frames anteriores em buffer internamente
- Detecta envios de frames atrasados
- Repete a exibição de frames anteriores quando frames atrasados são detectados
Saiba como o Mir 2 usou o Swappy para reduzir a taxa de sessões lentas de 40% para 10%.
Como usar o Swappy em projetos nativos
Consulte os guias a seguir para integrar a biblioteca Android Frame Pacing ao seu jogo:
- Integrar a Android Frame Pacing ao renderizador OpenGL
- Integrar o Android Frame Pacing ao renderizador Vulkan
Como usar o Swappy no mecanismo de jogo Unity
O Unity integrou o Android Frame Pacing ao mecanismo. Para ativar esse recurso no Unity 2019.2 ou mais recente, marque a caixa de seleção "Optimized Frame Pacing" em Configurações do projeto > Player > Settings para Android > Resolution and Presentation:
Como alternativa, ative de forma programática a opção de ritmo de frames otimizado no código lógico para permitir que o Unity distribua os frames de maneira uniforme, reduzindo a variação no frame rate e criando uma jogabilidade mais fluida.
Como usar o Swappy no mecanismo de jogo Unreal
O Unreal 4.25 e versões mais recentes integram a biblioteca Android Frame Pacing, que faz parte do Android Game Development Kit. O artigo Mobile Frame Pacing (link em inglês) explica como ativar a biblioteca Android Frame Pacing e como controlar a frame pacing usando o código C++.
O que é a Vulkan
Vulkan é uma API moderna de gráficos 3D em várias plataformas projetada para minimizar a abstração entre o hardware gráfico do dispositivo e o seu jogo. O Vulkan é a principal API gráfica de baixo nível no Android, substituindo o OpenGL ES. O OpenGL ES ainda está disponível no Android, mas não está mais em desenvolvimento ativo de recursos.
O Vulkan oferece as seguintes vantagens sobre o OpenGL ES:
- Uma arquitetura mais eficiente com menor overhead de CPU no driver gráfico
- Novas estratégias de otimização para melhorar o desempenho da CPU
- Novos recursos gráficos não disponíveis no OpenGL ES, como APIs sem vínculo e traçado de raio
Como usar o Vulkan em projetos do Android nativos
O codelab Como começar a usar o Vulkan no Android orienta você na configuração do pipeline de renderização do Vulkan e na renderização de um triângulo texturizado girando na tela. Use o codelab para aprender a renderizar os gráficos do seu jogo.
Como usar o Vulkan no mecanismo de jogo Unity
Para ativar a seleção automática de dispositivos no Unity, siga as etapas para configurar a API Auto Graphics.
Como alternativa, é possível ativar o Vulkan manualmente desativando a API Auto Graphics e colocando o Vulkan na prioridade mais alta na lista de APIs Graphics. Se você estiver usando o Unity 2021.1 ou uma versão anterior, essa é a única maneira de usar o Vulkan.
Use o plug-in do mecanismo VkQuality para Unity para fornecer recomendações de tempo de inicialização da API de gráficos para seu jogo usar em dispositivos específicos.
Como usar o Vulkan no mecanismo de jogo Unreal
Para ativar a API de gráficos Vulkan, acesse configurações do projeto > Platforms > Android > Build e selecione Support Vulkan. Quando você seleciona Support Vulkan e Support OpenGL ES3.2, o Unreal usa o Vulkan por padrão. Se o dispositivo não for compatível com a Vulkan, o Unreal vai usar o OpenGL ES 3.2.
Se você estiver usando recursos específicos da Vulkan que não funcionam bem em
determinados dispositivos, personalize o arquivo BaseDeviceProfile.ini para excluir
esses dispositivos. Confira Como personalizar perfis de dispositivos e escalonabilidade
para Android para saber como
personalizar BaseDeviceProfile.ini. Como novos drivers de dispositivo podem corrigir dispositivos
com problemas conhecidos, mantenha o arquivo BaseDeviceProfile.ini atualizado para receber todas
as otimizações.
O que é ADPF
O Framework de Performance Dinâmica do Android (ADPF) otimiza jogos com base nos recursos dinâmicos de gerenciamento de temperatura, CPU e GPU no Android. Os jogos são o foco, mas você também pode usar os recursos para outros apps que exigem alta performance.
O ADPF é um conjunto de APIs que permitem que jogos e apps de alta performance interajam mais diretamente com os sistemas térmicos e de energia de dispositivos Android. Com essas APIs, você pode monitorar o comportamento dinâmico nos sistemas Android e otimizar a performance de jogos em um nível sustentável que não superaqueça os dispositivos.
Estes são os principais recursos do ADPF:
- API Thermal: monitora o estado térmico de um dispositivo para que o aplicativo possa ajustar proativamente a carga de trabalho antes que ela fique insustentável.
- API CPU Performance Hint: dá dicas de desempenho para que o Android escolha as configurações de desempenho certas (por exemplo, ponto de operação ou núcleo da CPU) para a carga de trabalho.
- API Game Mode e API Game State: otimize a jogabilidade priorizando características de desempenho ou duração da bateria, com base nas configurações do usuário e do jogo.
- Modo performance fixa: ativa esse modo performance em um dispositivo durante o benchmark para receber medições que não são alteradas pelo relógio dinâmico da CPU.
- Modo de eficiência de energia: informa à sessão que as linhas de execução na sessão de dica de performance podem ser programadas com segurança para priorizar a eficiência de energia em vez da performance. Disponível no Android 15 (nível 35 da API).
Como usar o ADPF em projetos do Android nativos
O codelab Como integrar recursos de adaptabilidade ao jogo nativo orienta você na integração de recursos do ADPF ao seu jogo com etapas que você pode seguir no seu próprio ritmo. Ao final do codelab, você terá integrado os seguintes recursos:
- API Thermal: detecta a condição térmica do dispositivo e reage antes que ele entre no estado de limitação térmica.
- API Game Mode: entenda as preferências de otimização do jogador (maximizar o desempenho ou preservar a bateria) e faça os ajustes necessários.
- API Game State: informe ao sistema o estado do jogo (carregando, jogando, interface etc.) para que ele ajuste os recursos de acordo (aumente a E/S, a CPU, a GPU etc.).
- API Performance Hint: informe ao sistema o modelo da linha de execução e a carga de trabalho para que ele possa alocar recursos de acordo.
Como usar o ADPF no mecanismo de jogo Unity
O Adaptive Performance do Unity é uma ferramenta para desenvolvedores de jogos que querem otimizar os jogos em dispositivos móveis, especialmente para o ecossistema Android diversificado. O desempenho adaptável permite que o jogo se adapte ao desempenho e às características térmicas do dispositivo em tempo real, garantindo uma experiência de jogo tranquila e eficiente.
O provedor do Android de desempenho adaptativo orienta você nas etapas para implementar o ADPF no Unity.
Como usar o ADPF no mecanismo de jogo Unreal
- Baixe o plug-in.
- Copie o plug-in para a pasta de plug-ins do projeto.
- Ativar o plug-in da ADPF para Unreal Engine no editor do Unreal
- Reiniciar o editor do Unreal
- Criar e preparar o jogo
O plug-in do Android Dynamic Performance Framework (ADPF) para o Unreal Engine oferece uma performance estável e evita a limitação térmica. Baixe o plug-in no GitHub. Esse plug-in muda os recursos definindo valores do console do Unreal.