Tabelas de classificação sazonais

Neste tutorial, explicamos o conceito de controle de versão para tabelas de classificação. Há vários casos em que queremos ter diferentes versões de uma determinada tabela de classificação. Por exemplo, em um jogo com um modo de torneio mensal, a estrutura da tabela de classificação permanece a mesma, mas os jogadores provavelmente mudam, especialmente em um jogo altamente competitivo. Continuamos com o exemplo de Criar tabelas de classificação básicas. Imagine que nosso jogo de arcade agora é muito popular. Por isso, é introduzido um novo modo chamado “Top of the Mountain”. Todo mês, o jogo oferece um torneio do qual qualquer jogador pode participar. Quem ficar entre os 100 primeiros será exibido em uma tabela de classificação especial no menu principal, para que todos possam ver quem é o melhor no jogo.

Criando uma definição de tabela de classificação para controle de versão

No exemplo anterior, ao criar uma definição de tabela de classificação, 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.

public static async Task CreateLeaderboardDefinitionAsync(PlayFabAuthenticationContext context, string leaderboardName)
{
    PlayFabProgressionInstanceAPI leaderboardsAPI = new PlayFabProgressionInstanceAPI(context);
    CreateLeaderboardDefinitionRequest leaderboardDefinitionRequest = new CreateLeaderboardDefinitionRequest()
    {
        AuthenticationContext = context,
        Name = leaderboardName,
        SizeLimit = 1000,
        EntityType = "title_player_account",
        VersionConfiguration = new VersionConfiguration()
        {
            MaxQueryableVersions = 12,
            ResetInterval = ResetInterval.Month,
        },
        Columns = new List<LeaderboardColumn>()
        {
            new LeaderboardColumn()
            {
                Name = "arcadeScoreTournament",
                SortDirection = LeaderboardSortDirection.Descending,
            }          
        }
    };

    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createLbDefinitionResult = await leaderboardsAPI.CreateLeaderboardDefinitionAsync(leaderboardDefinitionRequest);
}

A principal diferença deste exemplo em comparação com a tabela de classificação básica é o parâmetro VersionConfiguration. Esse parâmetro nos permite definir uma configuração MaxQueryableVersions, que especifica quantas versões da mesma tabela de classificação podemos consultar. Neste caso, nós a definimos para consultar 12 versões, o que permite consultar as 12 tabelas de classificação mais recentes. O parâmetro ResetInterval define com que frequência o processo de redefinição ocorre. Essa ação envolve criar uma tabela de classificação com a mesma configuração de antes, mas vazia, e o parâmetro de versão muda da seguinte forma: N = N + 1, com N = 0 na criação da definição da tabela de classificação. Por exemplo, digamos que temos uma tabela de classificação com o parâmetro de versão igual a dois e cem entradas. Agora, quando incrementamos a versão dessa tabela de classificação, o resultado será uma nova tabela de classificação vazia, com o parâmetro de versão igual a três. Enquanto isso, a tabela de classificação anterior permanece no sistema para ser consultada. O ResetInterval pode funcionar de várias formas. Neste exemplo, ele é mensal, mas pode ser alterado de acordo com as necessidades do desenvolvedor. Neste caso específico, significa que a tabela de classificação será redefinida automaticamente todo mês a partir do momento em que foi configurada. Oferecemos suporte às seguintes estratégias de redefinição:

Day
Hour
Manual
Month
Week

Para obter mais informações sobre todas as configurações disponíveis, confira a documentação da API aqui: Referência da API: Criar uma tabela de classificação

Incrementando a versão de uma tabela de classificação

Com essa nova configuração, podemos ter várias versões da mesma tabela de classificação para o modo de torneio. Mas o que acontece se precisarmos redefinir manualmente a tabela de classificação devido a um problema e recomeçar o torneio? Nesses casos, podemos realizar uma redefinição manual usando a API. Veja um exemplo usando o SDK:

public static async Task ResetLeaderboards(PlayFabAuthenticationContext context, string leaderboardName)
{
    PlayFabProgressionInstanceAPI leaderboardsAPI = new PlayFabProgressionInstanceAPI(context);
    IncrementLeaderboardVersionRequest resetLeaderboardRequest = new IncrementLeaderboardVersionRequest()
    {
        AuthenticationContext = context,
        Name = leaderboardName,
    };

    PlayFabResult<PlayFab.LeaderboardsModels.IncrementLeaderboardVersionResponse> resetLeaderboardResponse = await leaderboardsAPI.IncrementLeaderboardVersionAsync(resetLeaderboardRequest);
}

Consultando versões mais antigas

Agora, se precisarmos consultar uma versão mais antiga de uma tabela de classificação, podemos usar o parâmetro version disponível em todas as APIs GetLeaderboards. Veja um exemplo usando o SDK:

public static async Task<List<EntityLeaderboardEntry>> GetLeaderboard(PlayFabAuthenticationContext context, string leaderboardName)
{
    PlayFabProgressionInstanceAPI leaderboardsAPI = new PlayFabProgressionInstanceAPI(context);
    GetEntityLeaderboardRequest getLbRequest = new GetEntityLeaderboardRequest()
    {
        LeaderboardName = leaderboardName,
        StartingPosition = 1,
        PageSize = 20,
        AuthenticationContext = context,
        Version = 1
    };

    PlayFabResult<GetEntityLeaderboardResponse> lbResponse = await leaderboardsAPI.GetLeaderboardAsync(getLbRequest);
    
    return lbResponse.Result.Rankings;
}

Agora estamos preparados para lidar com qualquer desafio de controle de versão nas tabelas de classificação. Um aspecto importante aqui é que o número de definições de tabelas de classificação que decidimos manter como versões será medido, pois usa armazenamento no serviço. Saiba mais sobre isso aqui:

Gravações em tabelas de classificação.

Conclusões

Neste tutorial, aprendemos a realizar as seguintes operações:

Criar uma tabela de classificação com a estratégia de redefinição correta.
Incrementar a versão de uma tabela de classificação.
Consultar versões mais antigas de uma tabela de classificação.

XBOX Services

PlayFab

Criando uma definição de tabela de classificação para controle de versão

Incrementando a versão de uma tabela de classificação

Consultando versões mais antigas

Conclusões

Confira também

​Criando uma definição de tabela de classificação para controle de versão

​Incrementando a versão de uma tabela de classificação

​Consultando versões mais antigas

​Conclusões

​Confira também

Criando uma definição de tabela de classificação para controle de versão

Incrementando a versão de uma tabela de classificação

Consultando versões mais antigas

Conclusões

Confira também