Este guia descreve como usar um plug-in do Unity para registrar e fazer upload de dados de tempo para a renderização do frame do Unity 2017.4 ou versão mais recente.
Para mecanismos de jogos que usam C ou C++, consulte o guia de mecanismos de jogos nativos.
Contexto
Um componente essencial da experiência do jogo é o desempenho de renderização. O desempenho de renderização é um resultado das duas seguintes entradas:
- Frame rate: a frequência com que um frame é desenhado.
- Configurações de qualidade gráfica: nível de fidelidade com que um frame é apresentado, incluindo fidelidade de simulação e gráficos.
Para jogos, um bom desempenho de renderização é definido da seguinte forma:
- Apresentação de um frame rate consistente e estável (ou seja, o percentual de frames renderizados na frequência esperada).
- Renderização de frames com a maior frequência possível, mantendo a estabilidade, normalmente de 30 ou 60 QPS, dependendo do tipo de jogo.
- Maximização do nível de detalhes para um usuário de acordo com o tamanho e a densidade da tela, sem deixar de alcançar um frame rate esperado e estável.
A biblioteca Android Frame Pacing limita grande parte da variação nos tempos para a renderização de frames, proporcionando um frame rate estável para os jogos. O restante da variação nos tempos para a renderização se deve ao nível de detalhes exibido em algumas cenas do jogo e aos recursos gráficos do dispositivo. Com o Android Performance Tuner, é possível identificar os momentos do jogo em que o tempo para a renderização do frame fica mais lento ou mais rápido que o pretendido e relacionar esses problemas e oportunidades a:
- Determinadas configurações de qualidade
- Cenas específica no jogo
- Determinados modelos ou especificações de dispositivo
Registrar e fazer upload de dados
A biblioteca Tuning Fork usa uma das funções de marcação chamadas para cada frame pela biblioteca Android Frame Pacing (ou pelo mecanismo Unity para versões anteriores do Unity em que a biblioteca Frame Pacing não está presente). Dentro da biblioteca, essas informações de marcação são agregadas a histogramas, que são periodicamente carregados no Google Play por um endpoint HTTP. Cada marcação é registrada como associada a uma chave de instrumento e uma anotação. As anotações são definidas com o plug-in do Unity.
Chaves de instrumento
Uma chave de instrumento indica o local do frame de onde a marcação é originada. A chave é um número inteiro que precisa ser transmitido para cada chamada de função da marcação. Isso é feito de forma automática pelo plug-in do Unity. Se a opção "Optimized Frame Pacing" estiver ativada nas configurações do Unity para seu jogo (disponível na versão 2019.3.14 ou mais recente do Unity), o Android Performance Tuner vai usar informações da biblioteca do Android Frame Pacing para informar métricas ajustadas.
Anotações
As anotações oferecem informações contextuais sobre o que o jogo está fazendo no momento que uma marcação é registrada. Por exemplo, uma anotação pode identificar qualquer um dos seguintes elementos:
- O nível atual do jogo
- Uma cena específica que está sendo carregada
- Um "chefão" na tela
- Outras informações relevantes sobre o estado do jogo
As anotações são definidas em uma caixa de diálogo apresentada pelo plug-in do Unity.
Internamente, a biblioteca Tuning Fork usa o formato de buffer de protocolo do Google para armazenar anotações e parâmetros de fidelidade. Esse é um protocolo bem definido e em vários idiomas para dados estruturados e extensíveis. Para mais informações, consulte a documentação de buffers de protocolo.
Parâmetros de fidelidade
Os parâmetros de fidelidade influenciam o desempenho e a fidelidade gráfica do jogo, como nível de detalhe da malha, resolução da textura e método anti-aliasing. Assim como as anotações, os parâmetros de fidelidade são definidos em uma caixa de diálogo apresentada pelo plug-in do Unity.
Sobrecarga de memória e CPU
Toda a memória usada pela biblioteca Tuning Fork é alocada na inicialização para evitar surpresas durante o jogo. O tamanho dos dados depende do número de chaves de instrumento, do número de possíveis anotações e do número de buckets em cada histograma. O tamanho resulta da multiplicação de todos esses elementos vezes quatro bytes para cada bucket. Existem também duas cópias de todos os histogramas para permitir o envio em buffer duplo.
O envio ocorre em outra linha de execução e não bloqueia as chamadas de marcação. Se não houver uma conexão de upload disponível, o envio será colocado na fila para upload posterior.
Há pouca sobrecarga de processamento para chamar uma função de marcação: o sistema simplesmente calcula um índice na matriz de buckets de histograma e incrementa uma contagem de números inteiros.
Solicitações da Web
A biblioteca faz dois tipos de solicitação ao endpoint do servidor:
- Uma solicitação
generateTuningParametersna inicialização - Uma solicitação
uploadTelemetrypara enviar dados ao servidor, feita de forma periódica durante o jogo
Jogadores off-line
Caso não haja uma conexão disponível na inicialização, a solicitação é repetida várias vezes, com um tempo de espera crescente. Caso não haja conexão durante o upload, ele é armazenado em cache. Os uploads são armazenados como arquivos em um armazenamento temporário.
Requisitos
Para usar o plug-in no seu jogo, use uma versão compatível do Unity:
- Versão 2017.4 ou mais recente do Unity e versão 4.6 do .NET (link em inglês)
- O Unity 2018.2 é necessário para usar arquivos de expansão do APK
- Para melhorar o ritmo de frames e as medidas da GPU, é necessário usar a versão 2019.3.14 ou mais recente do Unity
- Para suporte a cenas do Addressables, é preciso ter o Unity 2019.3 ou mais recente e o pacote do Addressables 1.19.4 (link em inglês) ou mais recente
Integrar o Android Performance Tuner ao Unity
Para mais informações sobre como integrar o Android Performance Tuner no Unity, consulte Ativar a API.