Uso de estadísticas de jugador - XBOX Game Development Documentation

En este tutorial se describe cómo crear y usar estadísticas de jugador. Las estadísticas de jugador se almacenan como pares clave-valor (KVP), donde la clave es una cadena y el valor es un entero de 32 bits (por compatibilidad con lenguajes que no admiten 64 bits). Las estadísticas de jugador también las usan las tablas de clasificación, pero esta guía solo trata las estadísticas de jugador en exclusiva. Si desea leer sobre cómo funcionan juntas las estadísticas de jugador y las tablas de clasificación, lea nuestro tutorial Uso de estadísticas y tablas de clasificación restablecibles.

En parte de la documentación y en algunas llamadas API, puede encontrar el término UserStatistics. A efectos de esta explicación, los términos usuario y jugador son idénticos e intercambiables. En la página de Game Manager, la pestaña Players proporciona acceso a los usuarios/jugadores de su título y, dentro de ella, a sus estadísticas. Las estadísticas de jugador se refieren específicamente a la información vinculada a un jugador, no a información analítica sobre el jugador.

API de cliente

El cliente tiene acceso de lectura a las estadísticas de jugador, pero para evitar las trampas, el cliente no puede actualizar las estadísticas de forma predeterminada. Para habilitarlo:

Inicie sesión en PlayFab
Seleccione su título.
Seleccione Settings en el menú de la izquierda.
Seleccione la pestaña API Features.
Busque y active Allow client to post player statistics.

Hacer esto deshabilita una capa de seguridad para su título, lo que permite a los jugadores publicar puntuaciones arbitrarias en todas sus estadísticas. Si su juego tiene algún aspecto de juego competitivo, le recomendamos que nunca publique estadísticas desde el cliente.

Las estadísticas son información pública

No hay estadísticas privadas ni exclusivas del servidor. Un jugador siempre puede leer todas sus propias estadísticas mediante GetPlayerStatistics y puede leer las estadísticas de todos los demás jugadores mediante las llamadas API de tablas de clasificación. Esto es cierto incluso si no muestra una estadística en el juego ni usa tablas de clasificación. La única excepción a esto sería si deshabilita las características de cliente mediante nuestra directiva de acceso a API. Consulte ese vínculo para obtener más información sobre cómo usar la configuración de directivas para los títulos, ya que es un tema avanzado que no se trata en este tutorial.

Establecimiento de estadísticas

El código de Unity/C# siguiente crea (o actualiza, si ya existe) un valor de estadística de fuerza para un jugador.

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()); });

Obtención de estadísticas

El código de Unity/C# siguiente recupera todos los valores de estadísticas actuales de un jugador.

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 agregación

PlayFab admite algunas opciones prácticas para la agregación de estadísticas. Las cuatro opciones son:

Last
Min
Max
Sum

Puede crear una definición de estadística mediante la llamada API CreatePlayerStatisticDefinition, aunque no es obligatorio. Cualquier llamada para actualizar una estadística de jugador del título creará automáticamente la definición de estadística predeterminada, con el método de agregación Last. Para cambiar el método de agregación de una estadística, puede usar Game Manager o la llamada API UpdatePlayerStatisticDefinition. Para editar una definición de estadística en Game Manager:

Inicie sesión en PlayFab
Seleccione su título.
Seleccione Leaderboards en el menú de la izquierda (las estadísticas y las tablas de clasificación están estrechamente relacionadas).
Seleccione la estadística existente que quiera modificar, o bien:
Seleccione el botón New Leaderboard.
- Para una estadística existente, tendrá otra página con un botón Edit Leaderboard.
En este punto debería ver la página que se muestra a continuación.

Algunos ejemplos de cómo usar la agregación de estadísticas:

Max y Min se pueden usar para guardar las mejores/peores puntuaciones, como disparos a la cabeza o precisión:
- En resumen, aplican la regla de: si esto es superior (o inferior) a la puntuación existente, actualizar la puntuación.
- Publique la estadística al finalizar la sesión y la agregación Min/Max se encargará de decidir si se actualiza o no.
- Pueden resultar muy útiles para las tablas de clasificación restablecibles, así como para una regla de PlayStream que otorgue logros.
Sum podría usarse para guardar puntos de experiencia:
- Publica la experiencia obtenida en esta batalla y se suma al valor de estadística existente del jugador.
Last le permite administrar la estadística usted mismo:
- Cada vez que publica una estadística, se usa el valor más reciente.

Tablas de clasificación

Se genera una tabla de clasificación para todas las estadísticas guardadas en PlayFab. Acceder a una tabla de clasificación para una estadística específica es opcional. La frecuencia de restablecimiento y los métodos de agregación desempeñan un papel fundamental en lo dinámicas que son las tablas de clasificación de su juego. La característica de torneos se centra en las tablas de clasificación con frecuencias de restablecimiento automáticas y se describe en el tutorial Uso de estadísticas y tablas de clasificación restablecibles. Le animamos a usar las estadísticas de todas las formas pertinentes para su juego. Puede usar estadísticas restablecibles para organizar torneos diarios y, en paralelo, estadísticas a largo plazo como los puntos de experiencia.

​API de cliente

​Las estadísticas son información pública

​Establecimiento de estadísticas

​Obtención de estadísticas

​Método de agregación

​Tablas de clasificación

API de cliente

Las estadísticas son información pública

Establecimiento de estadísticas

Obtención de estadísticas

Método de agregación

Tablas de clasificación