Pular para o conteúdo principal
Conforme descrito na Visão geral dos Dados do jogador, as estatísticas são informações essenciais usadas para acompanhar o desempenho de um jogador, como Head Shots ou Fastest Lap Time. As estatísticas são usadas para gerar leaderboards em cenários que permitem aos jogadores comparar seu esforço e suas habilidades com os amigos e com todos os outros jogadores da comunidade de um título. Os serviços XBOX são proprietários das estatísticas e as mantêm. Elas são atualizadas com base nos eventos de ação do usuário que seu jogo envia aos serviços XBOX. As estatísticas configuradas aparecem no leaderboard de um título, onde o jogador vê como se classifica em relação aos amigos que também jogaram o título. Para obter mais informações sobre os leaderboards do GameHub, veja Criação de experiências dos serviços XBOX. Há duas implementações disponíveis de estatísticas de usuário para os serviços XBOX:
  • Estatísticas gerenciadas pelo título (anteriormente chamadas de Stats 2017)
  • Estatísticas baseadas em eventos (anteriormente chamadas de Stats 2013)
Recomendamos que você use estatísticas gerenciadas pelo título ao configurar novos títulos. No entanto, as variáveis de Rich Presence funcionam somente com estatísticas baseadas em eventos.
As estatísticas gerenciadas pelo título e as estatísticas baseadas em eventos funcionam com princípios fundamentalmente diferentes.

Estatísticas gerenciadas pelo título

Ao usar estatísticas gerenciadas pelo título, você envia o próprio valor real da estatística para o servidor usar. Nas estatísticas gerenciadas pelo título, o servidor faz pouca ou nenhuma validação do valor enviado a ele. Cabe ao seu título acompanhar os valores corretos das estatísticas. Seu título é a fonte da verdade para os valores das estatísticas. Ao usar estatísticas gerenciadas pelo título, recomendamos que você acompanhe e armazene suas estatísticas na nuvem com o Armazenamento em nuvem. As estatísticas gerenciadas pelo título funcionam como um serviço de relatórios. Você envia ao servidor a estatística correta do seu jogo. Sua estatística então fica no servidor aguardando ser exibida mediante solicitação ou ser atualizada.
O leaderboard global de uma estatística gerenciada pelo título mantém somente o maior valor registrado por jogador. Gravar um valor menor atualiza a estatística armazenada para esse valor menor, mas não reduz a posição do jogador no leaderboard global. Se o seu título precisar que as posições no leaderboard diminuam (por exemplo, uma classificação que sobe ou desce, ou uma pontuação que é redefinida em derrotas), use estatísticas baseadas em eventos com uma regra de estatística Replace ou um serviço de leaderboard externo, como o PlayFab Leaderboards v2. Para obter detalhes, veja a visão geral das estatísticas gerenciadas pelo título e a referência de XblLeaderboardQuery.

Estatísticas baseadas em eventos

Ao usar estatísticas baseadas em eventos, o jogo envia eventos aos serviços XBOX. Os eventos incluem detalhes específicos sobre as ações realizadas por um jogador. As informações desses eventos são usadas para atualizar as estatísticas adequadamente. Nas estatísticas baseadas em eventos, o serviço acompanha e atualiza todos os valores das suas estatísticas. O serviço é a fonte da verdade para os valores das estatísticas de um jogador ou grupo de jogadores.

Histórico

Com o lançamento do XBOX One, os serviços XBOX introduziram as estatísticas baseadas em eventos. Isso ofereceu uma série de benefícios. Por exemplo, um único evento de jogo pode atualizar dados de vários recursos do XBOX, como leaderboards e conquistas, e a configuração dos serviços XBOX é gerenciada no servidor em vez de no cliente, entre outros recursos. Nos anos seguintes ao lançamento do XBOX One, os desenvolvedores solicitaram um serviço de estatísticas mais simplificado para contornar a complexidade de um sistema baseado em eventos. Assim, eles poderiam usar os métodos de acompanhamento de estatísticas que já praticavam. Com base nos comentários dos desenvolvedores, foi criada uma nova versão simplificada das estatísticas que devolveria o controle da lógica das estatísticas às mãos do desenvolvedor. Esse sistema são as estatísticas gerenciadas pelo título. É um serviço que simplesmente aceita o valor passado pelo título, dando aos desenvolvedores o controle da lógica que determina o valor de uma estatística.

Como as estatísticas são tratadas nas estatísticas baseadas em eventos e nas gerenciadas pelo título

Vamos analisar a configuração e a atualização de estatísticas nas estatísticas baseadas em eventos em comparação com as gerenciadas pelo título. Por exemplo, vamos criar estatísticas de um RPG genérico e queremos acompanhar os monstros mortos.

Estatísticas baseadas em eventos

Com as estatísticas baseadas em eventos, seu título enviaria um evento que contém informações sobre uma ação realizada por um jogador. Nesse evento, a ação é matar um orc enquanto o jogador tinha uma espada. Algumas das informações contidas nesse evento podem ser que uma ação de matar foi realizada, que o alvo morto era um orc, que o tipo de combate era corpo a corpo e que a arma usada era uma espada. As estatísticas baseadas em eventos passam essas informações por várias regras configuradas por você, o desenvolvedor, no Partner Center, e atualizam as estatísticas, também configuradas por você, com base no evento. Nas estatísticas baseadas em eventos, o serviço acompanha qual deve ser o valor das suas estatísticas de abates. O evento “matar orc com espada” poderia atualizar várias estatísticas, como número de abates, número de orcs mortos e número de abates com espada.

Estatísticas gerenciadas pelo título

Nas estatísticas gerenciadas pelo título, você enviará os valores reais das suas estatísticas. No exemplo “matar orc com espada”, seu título acompanha individualmente o número total de abates, de abates com espada e de orcs mortos, e envia ao serviço o número atualizado de cada estatística. O serviço tem verificações de validação mínimas para garantir que você esteja enviando um número que faça sentido, por isso é essencial que seu título envie a estatística correta. Embora você possa usar o serviço de estatísticas gerenciadas pelo título para recuperar os valores das estatísticas no início de uma sessão de jogo, não use esse serviço para confirmar o valor de uma estatística enquanto a sessão estiver em andamento. O diagrama a seguir mostra como funcionam os dois tipos de estatísticas.
  • Estatísticas baseadas em eventos à esquerda
  • Estatísticas gerenciadas pelo título à direita
Estatísticas baseadas em eventos vs. estatísticas gerenciadas pelo título

Outras diferenças entre as duas abordagens

Para Managed Partners, há mais algumas diferenças a considerar ao decidir entre estatísticas baseadas em eventos e estatísticas gerenciadas pelo título para seu título. Com as estatísticas baseadas em eventos, você pode:
  • Obter mais exibições de leaderboard.
  • Analisar com mais facilidade os metadados das suas estatísticas. No nosso exemplo de “matar orc”, a estatística geral acompanhava o número de abates.
  • Obter estatísticas detalhadas sobre o que foi morto, com qual arma e quaisquer outras informações definidoras do abate que você configurar.
As estatísticas baseadas em eventos têm uma estatística nativa de “minutos jogados”. Use as estatísticas baseadas em eventos para acessar o tempo de jogo de um jogador sem configurar a estatística. Nas estatísticas gerenciadas pelo título, qualquer estatística de tempo de jogo teria que ser acompanhada pelo seu título.

Frequência de atualização

Nas estatísticas baseadas em eventos, os eventos são gravados localmente no dispositivo, mesmo que o dispositivo esteja offline e sem conexão com a internet. Quando o dispositivo está online e conectado, um serviço executado no dispositivo agrupa os eventos em lotes e os carrega para a plataforma de dados do jogador do XBOX. Normalmente, a atualização das estatísticas baseadas em eventos leva de 5 a 20 segundos se o dispositivo estiver online e conectado, desde o momento em que o evento é gravado localmente no dispositivo até o momento em que as informações atualizadas do evento são refletidas nos serviços XBOX. Nas estatísticas gerenciadas pelo título, os valores reais das suas estatísticas são atualizados e, em seguida, descarregados periodicamente do sistema diretamente para a plataforma de dados do jogador do XBOX se o dispositivo estiver online e conectado à internet. As estatísticas atualizadas são descarregadas automaticamente do sistema em intervalos de 5 minutos. Você pode descarregar manualmente as estatísticas do sistema para os serviços XBOX, mas o descarregamento manual é limitado a um intervalo mínimo de 30 segundos entre descarregamentos. Normalmente, a atualização das estatísticas gerenciadas pelo título leva de 2 a 10 segundos se o dispositivo estiver online e conectado, desde o momento em que os valores atualizados são descarregados do sistema até o momento em que são refletidos nos serviços XBOX. As estatísticas baseadas em eventos podem dar suporte a outros serviços XBOX. Com as estatísticas baseadas em eventos, você pode usar estatísticas para desbloquear conquistas e tomar decisões de matchmaking. As estatísticas gerenciadas pelo título só podem ser usadas para produzir estatísticas em destaque e leaderboards.

Usando conquistas gerenciadas pelo título com estatísticas baseadas em eventos

É muito comum que os títulos usem conquistas gerenciadas pelo título lado a lado com estatísticas baseadas em eventos. Não há problemas de compatibilidade com essa combinação. Recomendamos essa abordagem.

Veja também

Visão geral das estatísticas baseadas em eventos Visão geral das estatísticas gerenciadas pelo título
Última modificação em 20 de outubro de 2026