Uso del perfil para tablas de clasificación avanzadas - XBOX Game Development Documentation

Con PlayFab, normalmente se crean tablas de clasificación mediante los métodos de API siguientes:

El resultado es una lista de objetos PlayerLeaderboardEntry que contienen solo información básica sobre el jugador y su relación con la tabla de clasificación actual. Sin embargo, PlayFab también le permite usar PlayerProfileViewConstraints para obtener información adicional sobre cada jugador.

En este ejemplo se supone que ya tiene algunos datos de tabla de clasificación con los que trabajar. Consulte nuestro tutorial Acceso a los resultados archivados de torneos para conocer un método para generar algunos datos de prueba.

Configuración de las restricciones de vista del perfil de jugador

De forma predeterminada, la API de cliente solo puede obtener el nombre para mostrar del perfil de otro jugador. En este ejemplo, permitiremos que todos los jugadores accedan a información adicional sobre otros jugadores de la tabla de clasificación. Vaya al Game Manager de su título:

Seleccione el icono Settings en el menú de la izquierda.
Seleccione Title settings
Después, seleccione la pestaña Client Profile Options.
Compruebe que DisplayName está seleccionado.
Asegúrese de que Avatar URL está seleccionado.
Envíe los cambios seleccionando el botón Save Client Profile Options.

Pruebas

El paso anterior permite que el código de cliente use las restricciones de perfil DisplayName y AvatarUrl. El ejemplo siguiente muestra cómo obtener e imprimir una tabla de clasificación usando cualquiera de los datos de perfil mencionados. Consulte los comentarios del código para obtener más información.

private static async Task DoReadLeaderboard()
{
    // Get Leaderboard Request
    var result = await PlayFabClientAPI.GetLeaderboardAsync(new GetLeaderboardRequest()
    {
        // Specify your statistic name here
        StatisticName = "TestScore",
        // Override Player Profile View Constraints and fetch player DisplayName and AvatarUrl
        ProfileConstraints = new PlayerProfileViewConstraints()
        {
            ShowDisplayName = true,
            ShowAvatarUrl = true
        }
    });

    // Start printing the leaderboard
    Console.WriteLine("=== LEADERBOARD ===");

    if (result.Error != null)
    {
        // Handle error if any
        Console.WriteLine(result.Error.GenerateErrorReport());
    }
    else
    {
        // Traverse the leaderboard list
        foreach (var entry in result.Result.Leaderboard)
        {
            // Print regular leaderboard entry information
            Console.WriteLine($"{entry.Position + 1} {entry.PlayFabId} {entry.StatValue}");

            // Additionally print display name and avatar url that comes from player profile
            Console.WriteLine($"    {entry.Profile.DisplayName} | {entry.Profile.AvatarUrl}");
        }
    }
}

Los campos individuales del perfil solo están disponibles si el cliente los solicita explícitamente mediante las restricciones de perfil. Tenga en cuenta también que si determinadas restricciones de perfil no están permitidas en Game Manager, y su cliente las solicita, la llamada API fallará con el error correspondiente. El resultado tendrá un aspecto similar al del ejemplo siguiente.

Con esta técnica, puede obtener bastante información del perfil, incluidos otros valores de estadísticas.

​Configuración de las restricciones de vista del perfil de jugador

​Pruebas

Configuración de las restricciones de vista del perfil de jugador

Pruebas