Más operaciones con estadísticas

En este tutorial, vamos a tratar características más avanzadas que ofrece el servicio, como la creación de estadísticas de varias columnas y varias formas de consultar estadísticas. Con estas características, pretendemos llevar al límite lo que un servicio de estadísticas debería ser capaz de hacer. Usamos un juego de disparos muy competitivo como ejemplo de cómo estas nuevas características podrían ayudarnos a resolver algunos problemas. En este juego, hay varias armas que permiten al jugador acertar un tiro a larga distancia. Queremos registrar no solo la distancia del tiro, sino también el calibre de la bala que se usó.

Requisito previo

Complete los pasos descritos en Creación de una estadística básica.

Creación de una definición de estadística de varias columnas

Para comenzar con este ejemplo, necesitamos crear una definición de estadística más compleja que la que teníamos antes. Vamos a definir varias columnas para asignar los aspectos clave del tiro a larga distancia: distancias y calibre. En el ejemplo siguiente se muestra cómo crear la definición de estadística mediante el SDK de C#.

public static async Task CreateStatisticDefinitionAsync(PlayFabAuthenticationContext context, string statName)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
    {
        Name = statName,
        AuthenticationContext = context,
        EntityType = "title_player_account",
        VersionConfiguration = new VersionConfiguration()
        {
            MaxQueryableVersions = 1,
            ResetInterval = ResetInterval.Manual,
        },
        Columns = new List<StatisticColumn>()
        {
            new StatisticColumn()
            {
                Name = "Distance",
                AggregationMethod = StatisticAggregationMethod.Max,
            },
             new StatisticColumn()
            {
                Name = "Caliber",
                AggregationMethod = StatisticAggregationMethod.Min,
            }
        },
    };
    
    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);
}

El componente más importante aquí es el parámetro Columns, que permite varias definiciones de StatisticColumn para que la estadística pueda tener varios valores. La única excepción es cuando usamos la agregación de Sum. Además, el número máximo de columnas permitidas es 5.

Adición de datos a una estadística

Ahora que tenemos nuestra estadística creada, vamos a agregar datos. La principal diferencia con respecto a nuestro tutorial anterior sobre este tema es que ahora necesitamos agregar dos valores diferentes. En el ejemplo siguiente se muestra cómo agregar datos a nuestra estadística mediante el SDK de C#.

public static async Task UpdateStatisticForPlayer(PlayFabAuthenticationContext context, string statName, string entityId, int score)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    UpdateStatisticsRequest updateStatRequest = new UpdateStatisticsRequest()
    {
        Entity = new PlayFab.LeaderboardsModels.EntityKey()
        {
            Id = entityId,
            Type = EntityType
        },
        AuthenticationContext = context,
        Statistics = new List<PlayFab.LeaderboardsModels.StatisticUpdate>() 
        {
            new PlayFab.LeaderboardsModels.StatisticUpdate() 
            {
                Name = statName,
                Scores = new List<string> { score.ToString(), score.ToString()},
            }
        }
    };

    PlayFabResult<UpdateStatisticsResponse> updateResult = await statsAPI.UpdateStatisticsAsync(updateStatRequest);
}

Aquí el punto principal reside en el parámetro Scores dentro de la estadística que se va a agregar. En el ejemplo de código, vemos dos valores diferentes, todos ellos cadenas, pero se trata solo de una definición de entrada dentro de la estadística. Estos valores se tratan como números. La longitud de la lista de puntuaciones siempre debe coincidir con el número de columnas de la definición de estadística.

Recuperación de datos de una estadística

Ahora vamos a aprender una forma de consultar varias entidades y obtener todas las estadísticas relacionadas con cada una de ellas. En el ejemplo siguiente se muestra cómo agregar datos a nuestra estadística mediante el SDK de C#.

public static async Task GetStatsForEntities(PlayFabAuthenticationContext context, string[] entityIds)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

    GetStatisticsForEntitiesRequest request = new GetStatisticsForEntitiesRequest()
    {
        AuthenticationContext = context,
        Entities = entityIds.Select(entity => new PlayFab.LeaderboardsModels.EntityKey()
        {
            Id = entity,
            Type = EntityType
        }).ToList(),
    };

    PlayFabResult<GetStatisticsForEntitiesResponse> result = await statsAPI.GetStatisticsForEntitiesAsync(request);

    foreach (EntityStatistics entityStatistics in result.Result.EntitiesStatistics)
    {
        Console.WriteLine("Stats for entity: " + entityStatistics.EntityKey.ToString());
        foreach (var stat in entityStatistics.Statistics)
        {
            Console.WriteLine($"{stat.Name} : {string.Join('|', stat.Scores)}");
        }
    }

}

Desempate

Cuando tenemos una definición de estadística de varias columnas, podríamos encontrarnos con un escenario que necesita desempate. Este mecanismo funciona siguiendo el orden en que se agregaron las columnas. Cada vez que llega un nuevo valor, el sistema comprueba si cumple los criterios de la agregación de la primera columna. En caso de que el valor sea el mismo, pasa a comprobar los criterios de la segunda columna. Este comportamiento continúa con las columnas siguientes. Por ejemplo, podemos tener una estadística con tres columnas:

La primera columna tiene agregación Min.
La segunda columna tiene agregación Max.
La tercera columna tiene agregación Last.

Si llega un nuevo valor, debe ser menor que el de la primera columna. Luego debe ser mayor que el de la segunda columna. Por último, la tercera columna está establecida en agregación Last, por lo que si supera las dos primeras validaciones, siempre se actualiza.

Conclusión

En este tutorial, aprendimos a realizar las siguientes operaciones:

Crear una estadística de varias columnas
Consultar estadísticas
Comprender cómo funciona el desempate.

XBOX Services

PlayFab

Requisito previo

Creación de una definición de estadística de varias columnas

Adición de datos a una estadística

Recuperación de datos de una estadística

Desempate

Conclusión

Consulte también

​Requisito previo

​Creación de una definición de estadística de varias columnas

​Adición de datos a una estadística

​Recuperación de datos de una estadística

​Desempate

​Conclusión

​Consulte también

Requisito previo

Creación de una definición de estadística de varias columnas

Adición de datos a una estadística

Recuperación de datos de una estadística

Desempate

Conclusión

Consulte también