Pular para o conteúdo principal
Este tópico descreve os procedimentos para adicionar e alterar regras de estatísticas na configuração de serviço do Partner Center para um título. As estatísticas do jogador são criadas e atualizadas de acordo com as regras de estatísticas acionadas quando um jogo envia eventos ao serviço XBOX Live. Para obter uma introdução à configuração de serviço do XBOX, consulte Configuração de serviço. Para obter uma introdução ao Data Platform 2013, consulte o tópico do XDK How the XBOX Live data platform 2013 works.

O que é uma regra de estatística?

As regras de estatísticas são acionadas quando o serviço XBOX data platform recebe um evento com um nome específico. Acionar uma regra de estatística (enviando um evento apropriado) faz com que o serviço crie ou atualize uma ou mais estatísticas do jogador. Você define as estatísticas do jogador, o XBOX Live data platform as calcula e elas são armazenadas como pares nome-valor por usuário. Veja alguns exemplos de estatísticas do jogador.
  • Número total de zumbis mortos com uma espingarda na dificuldade difícil
  • Maior número de inimigos derrotados em uma partida
  • Tempo mais rápido para concluir uma corrida
  • Nome do carro dirigido mais recentemente
As estatísticas do jogador podem ser exibidas na interface do usuário do hub do jogo do jogador como estatísticas em destaque ou principais, exibidas em placares de líderes e usadas para desbloquear conquistas. Regras de estatísticas individuais podem ser configuradas para produzir um dos seguintes:
  • Uma única instância de uma estatística do jogador
  • Várias instâncias de uma estatística do jogador com base em um modelo de estatística
Para obter informações sobre estatísticas e regras de estatísticas, consulte os tópicos a seguir na documentação do XDK.
  • User Stats for Data Platform 2013
  • User Stat Rules
  • User Stats Scenarios
O diagrama a seguir demonstra o fluxo de um evento que aciona regras de estatísticas que atualizam instâncias de estatísticas. Fluxo de eventos

Configurar uma regra de estatística

1

Entre com sua conta no [Partner Center](https://developer.microsoft.com...

Entre com sua conta no Partner Center.
2

Selecione seu título e acesse Services > XBOX Live.

Selecione seu título e acesse Services > XBOX Live.
3

Selecione o link para Stat rules.

Selecione o link para Stat rules.
4

Na página Events and stat rules, configure os eventos e as regras de estatísticas...

Na página Events and stat rules, configure os eventos e as regras de estatísticas baseadas nesses eventos.
Como as regras de estatísticas se baseiam em eventos, você deve criar um evento antes de criar uma regra de estatística. Para obter detalhes, consulte Configurar eventos do XBOX Live para o data platform 2013 no Partner Center.

Criar uma regra de estatística

  1. Na página Events & Stat Rules, selecione New stat rule.
  2. Na caixa de diálogo Add Stat Rule, especifique os valores para os campos a seguir.
    • Base event
      Na lista suspensa, selecione o evento base que aciona essa regra de estatística.
    • Event fields added to the stat rule
      • Esse campo opcional permite selecionar campos incluídos no evento base como parte da regra de estatística.
      • Na lista suspensa, selecione um campo para adicionar à regra de estatística. Você pode adicionar vários campos dessa forma. Os campos selecionados são acrescentados ao nome raiz da regra de estatística e separados pelo caractere de ponto.
      • Para remover um campo, selecione o X ao lado do nome dele.
    • Stat Rule Name
      Especifique um nome que caracterize a regra de estatística e que você lembre e reconheça facilmente. Os nomes das regras de estatísticas são compostos por um nome raiz, opcionalmente seguido por um ou mais campos separados pelo caractere de ponto. Para conhecer os requisitos de nomenclatura dos nomes de regras de estatísticas, consulte o tópico do XDK User Stat Rules.
    • Operator
      Selecione um dos operadores a seguir.
      • Sum
        Incrementa o valor de estatística existente pelo valor especificado no campo Parameter.
      • Min
        Usa o mínimo entre o valor de estatística existente e o valor do campo Parameter.
      • Max
        Usa o máximo entre o valor de estatística existente e o valor do campo Parameter.
      • Replace
        Substitui o valor da estatística pelo valor especificado no campo Parameter. Não recomendamos usar o operador Replace para estatísticas que acionam conquistas. Os eventos nem sempre são processados em ordem, e isso pode fazer com que uma conquista nunca seja desbloqueada. Em vez disso, use o operador SUM.
    • Parameter
      Especifique o valor a ser usado no operador selecionado no campo Operator.
      • Se você quiser usar um número estático especificado por você, selecione a opção literal e especifique o valor na caixa abaixo da opção.
      • Se você quiser usar o valor de um campo, selecione a opção field e, na lista suspensa abaixo da opção, selecione o campo a ser usado.
    • Restrict other features like achievements and featured stats from accessing this info.
      Marque essa caixa de seleção para tornar a regra de estatística privada.
    • Only allow changes to this stat from a server event. Client events will be ignored.
      Marque essa caixa de seleção para indicar que a regra de estatística é acionada somente por eventos enviados por meio da API de servidor para servidor, e não por clientes de jogo executados no console ou no PC.
  3. Depois de configurar todos os campos e valores, selecione Save e feche a caixa de diálogo.
Sua nova regra de estatística agora é listada na página Events & Stat Rules sempre que o evento da regra é selecionado.

Alterar uma regra de estatística existente

Depois que um título for aprovado na Certificação Final, as regras de estatísticas existentes para um evento nesse título não poderão mais ser alteradas nem excluídas.
  1. Na coluna Stat rules da página Events and stat rules da instância do produto, selecione a regra de estatística que você deseja alterar.
  2. Faça as alterações na caixa de diálogo Update stat rule do evento.
  3. Selecione Save.

Editar uma regra de estatística

A edição de uma regra de estatística ocorre quando o nome de uma regra de estatística ou um campo de evento é removido, adicionado ou reordenado. Essa operação é tratada como a exclusão e a criação de uma nova regra de estatística. Todas as instâncias de estatísticas são excluídas como parte da edição, de acordo com essa definição.

Copiar uma regra de estatística existente

Depois que um título for aprovado na Certificação Final, as regras de estatísticas existentes para um evento nesse título não poderão mais ser alteradas nem excluídas.
  1. Na página Events and stat rules da instância do produto, localize a linha com a regra de estatística que você deseja excluir.
  2. Selecione Copy na coluna Actions dessa linha.
  3. Faça as alterações na caixa de diálogo Update stat rule do evento.
  4. Selecione Save.

Excluir uma regra de estatística existente

  • Depois que um título for aprovado na Certificação Final, as regras de estatísticas existentes para um evento nesse título não poderão mais ser alteradas nem excluídas.
  • A exclusão de uma regra de estatística é uma ação permanente e não pode ser desfeita nem revertida.
  • Excluir uma regra de estatística exclui todas as dependências encadeadas que ela possa ter. Antes de excluir uma regra de estatística, verifique se você também deseja excluir todas as dependências dela.
  1. Na página Events and stat rules da instância do produto, localize a linha com a regra de estatística que você deseja excluir.
  2. Selecione Delete na coluna Actions dessa linha.
  3. Selecione Delete na caixa de diálogo Confirmation.
Dependência de exclusão de evento
Última modificação em 6 de outubro de 2026