Usando estatísticas de jogadores - XBOX Game Development Documentation

Este tutorial descreve como criar e usar estatísticas de jogadores. As estatísticas de jogadores são armazenadas como pares chave-valor (KVPs), em que a chave é uma cadeia de caracteres e o valor é um inteiro de 32 bits (para compatibilidade com linguagens que não oferecem suporte a 64 bits). As estatísticas de jogadores também são usadas pelos placares, mas este guia aborda exclusivamente as estatísticas de jogadores. Se você quiser ler sobre como as estatísticas de jogadores e os placares funcionam juntos, leia nosso tutorial Usando estatísticas e placares redefiníveis.

Em algumas documentações e chamadas de API, você pode encontrar o termo UserStatistics. Para os fins desta discussão, os termos usuário e jogador são idênticos e intercambiáveis. Na página do Game Manager, a guia Players fornece acesso aos Users/Players do seu título e, dentro dela, às estatísticas deles. Estatísticas de jogadores referem-se especificamente a informações vinculadas a um jogador, não a informações analíticas sobre o jogador.

API do cliente

O cliente tem acesso para ler as estatísticas de jogadores, mas, para evitar trapaças, o cliente não pode atualizar estatísticas por padrão. Para habilitar isso:

Faça logon no PlayFab
Selecione seu Title.
Selecione Settings no menu à esquerda.
Selecione a guia API Features.
Localize e ative Allow client to post player statistics.

Fazer isso desabilita uma camada de segurança do seu título, permitindo que os jogadores publiquem pontuações arbitrárias em todas as suas estatísticas. Se o seu jogo tiver qualquer aspecto competitivo, recomendamos que você nunca publique estatísticas a partir do cliente.

Estatísticas são informações públicas

Não existem estatísticas privadas ou exclusivas do servidor. Um jogador sempre pode ler todas as suas próprias estatísticas por meio de GetPlayerStatistics e pode ler as estatísticas de todos os outros jogadores por meio de chamadas de API de placar. Isso é verdade mesmo que você não exiba uma estatística no jogo nem use placares. A única exceção seria se você desabilitasse recursos do cliente por meio da nossa Política de acesso à API. Consulte esse link para obter mais informações sobre como usar as configurações de política para títulos, pois esse é um tópico avançado que não é abordado neste tutorial.

Definindo estatísticas

O código Unity/C# a seguir cria (ou atualiza, se já existir) um valor de estatística de força para um jogador.

PlayFabClientAPI.UpdatePlayerStatistics( new UpdatePlayerStatisticsRequest {
    // request.Statistics is a list, so multiple StatisticUpdate objects can be defined if required.
    Statistics = new List<StatisticUpdate> {
        new StatisticUpdate { StatisticName = "strength", Value = 18 },
    }
},
result => { Debug.Log("User statistics updated"); },
error => { Debug.LogError(error.GenerateErrorReport()); });

Obtendo estatísticas

O código Unity/C# a seguir recupera todos os valores de estatística atuais de um jogador.

void GetStatistics()
{
    PlayFabClientAPI.GetPlayerStatistics(
        new GetPlayerStatisticsRequest(),
        OnGetStatistics,
        error => Debug.LogError(error.GenerateErrorReport())
    );
}

void OnGetStatistics(GetPlayerStatisticsResult result)
{
    Debug.Log("Received the following Statistics:");
    foreach (var eachStat in result.Statistics)
        Debug.Log("Statistic (" + eachStat.StatisticName + "): " + eachStat.Value);
}

Método de agregação

O PlayFab oferece suporte a algumas opções práticas de agregação de estatísticas. As quatro opções incluem:

Last
Min
Max
Sum

Você pode criar uma definição de estatística por meio da chamada de API CreatePlayerStatisticDefinition, embora isso não seja obrigatório. Qualquer chamada para atualizar uma estatística de jogador do título criará automaticamente a definição de estatística padrão, usando o método de agregação Last. Para alterar o método de agregação de uma estatística, você pode usar o Game Manager ou a chamada de API UpdatePlayerStatisticDefinition. Para editar uma definição de estatística no Game Manager:

Faça logon no PlayFab
Selecione seu Title.
Selecione Leaderboards no menu à esquerda (Statistics e Leaderboards estão intimamente relacionados).
Selecione a estatística existente que deseja modificar, ou
Selecione o botão New Leaderboard.
- Para uma estatística existente, você verá outra página, com um botão Edit Leaderboard.
Nesse ponto, você deverá ver a página mostrada abaixo.

Alguns exemplos de como usar a agregação de estatísticas:

Max e Min podem ser usados para salvar as melhores/piores pontuações, como tiros na cabeça ou precisão:
- Em resumo, eles aplicam a regra: se esta for maior (ou menor) que a pontuação existente, atualize a pontuação.
- Publique a estatística ao final da sessão, e a agregação Min/Max se encarrega de decidir se deve atualizar ou não.
- Elas podem ser muito úteis para placares redefiníveis, bem como para uma regra do PlayStream que concede conquistas.
Sum pode ser usado para salvar pontos de experiência:
- Você publica a experiência obtida nesta batalha, e ela é adicionada ao valor de estatística existente do jogador.
Last permite que você mesmo gerencie a estatística:
- Sempre que você publica uma estatística, o valor mais recente é usado.

Placares

Um placar é gerado para todas as estatísticas salvas no PlayFab. Acessar um placar de uma estatística específica é opcional. A frequência de redefinição e os métodos de agregação desempenham um papel importante no dinamismo dos placares do seu jogo. O recurso Tournaments se concentra em placares com frequências de redefinição automática e é descrito no tutorial Usando estatísticas e placares redefiníveis. Incentivamos você a usar estatísticas de todas as formas relevantes para o seu jogo. Você pode usar estatísticas redefiníveis para realizar torneios diários e estatísticas de longo prazo, como pontos de experiência, lado a lado.

​API do cliente

​Estatísticas são informações públicas

​Definindo estatísticas

​Obtendo estatísticas

​Método de agregação

​Placares

API do cliente

Estatísticas são informações públicas

Definindo estatísticas

Obtendo estatísticas

Método de agregação

Placares