Pular para o conteúdo principal
Neste tutorial, explicamos o conceito de controle de versão das estatísticas. Há vários casos em que queremos ter versões diferentes de uma determinada estatística. Por exemplo, se um jogo tiver temporadas, provavelmente redefinirá as estatísticas quando a nova temporada começar. Continuamos com o exemplo de Criar uma estatística básica. Imagine que nosso jogo de tiro está ficando muito popular. Por isso, o conceito de temporadas é introduzido. Todo mês, o jogo lança uma nova temporada temática para toda a base de jogadores. Portanto, queremos manter estatísticas independentes por temporada.

Criando uma definição de estatística para controle de versão

No exemplo anterior, ao criar uma definição de estatística, havia uma dica sobre a importância do parâmetro VersionConfiguration para o controle de versão. Aqui, detalhamos como usá-lo e como ele funciona.
A principal diferença deste exemplo em relação à estatística básica é o parâmetro VersionConfiguration. Esse parâmetro permite definir uma configuração MaxQueryableVersions, que especifica quantas versões da mesma estatística podemos consultar. Neste caso, definimos para consultar 12 versões. O parâmetro ResetInterval define com que frequência o processo de redefinição ocorre. Esse processo envolve criar uma estatística com a mesma configuração de antes, mas sem nenhum valor, e o parâmetro de versão muda da seguinte forma: N = N + 1, com N = 0 na criação da definição da estatística. Por exemplo, digamos que temos uma estatística com o parâmetro de versão igual a dois e um determinado valor. Agora aumentamos a versão dessa estatística; o resultado será uma nova estatística com o parâmetro de versão igual a três, sem nenhum valor. Enquanto isso, a estatística anterior permanece no sistema para ser consultada. O ResetInterval pode funcionar de várias maneiras. Neste exemplo, ele é mensal, mas pode ser alterado de acordo com as necessidades do desenvolvedor. Neste caso específico, significa que o placar será redefinido automaticamente todo mês a partir do momento em que foi configurado. Oferecemos suporte às seguintes estratégias de redefinição:
  • Day
  • Hour
  • Manual
  • Month
  • Week
Referência de API: criando uma estatística

Incrementando a versão de uma estatística

Com essa nova configuração, podemos ter várias versões da mesma estatística para temporadas diferentes. Mas o que acontece se precisarmos redefinir manualmente o placar devido a um problema e recomeçar a temporada? Nesses casos, podemos executar uma redefinição manual usando a API. Veja um exemplo usando o SDK:
Agora estamos preparados para lidar com quaisquer desafios de controle de versão das estatísticas. Um aspecto importante aqui é que o número de definições de estatísticas que decidimos manter como versões será medido, pois elas usam armazenamento no serviço. Saiba mais sobre isso aqui:

Conclusões

Neste tutorial, aprendemos a fazer as seguintes operações:
  • Criar uma estatística com a estratégia de redefinição correta
  • Incrementar a versão de uma estatística

Confira também

Última modificação em 8 de outubro de 2026