Uso de tablas de premios

​

Requisitos

• Serán necesarios conocimientos básicos sobre cómo crear un jugador, ya que deberá haber jugadores en una tabla de clasificación antes de que esta pueda realizar acciones sobre ellos.
• También merece la pena leer el inicio rápido de Game Manager si no está familiarizado con Game Manager, ya que es el lugar donde se crean las tablas de premios.
• Para usar las tablas de premios, debe tener conocimientos generales sobre cómo funcionan las tablas de clasificación restablecibles. Lea sobre las tablas de clasificación en nuestro tutorial Uso de estadísticas y tablas de clasificación restablecibles.
• Además, deben configurarse las monedas virtuales. Lea nuestro tutorial sobre monedas y configure dos monedas con los parámetros siguientes:
  • Currency code: GO
  • Display name: Gold
  • Initial deposit: 200
  • Currency code: SI
  • Display name: Silver
  • Initial deposit: 1000

​

Paso 1: Crear una tabla de clasificación

• Vaya a Leaderboards en el menú de la izquierda.
• Seleccione New Leaderboard.
• Agregue una tabla de clasificación llamada tournamentScore_manual en el campo Statistic name.
• Con el menú desplegable proporcionado, establezca el campo Reset frequency en Manually.
• Vaya al campo Aggregation method y seleccione Maximum (always use the highest value) en el menú desplegable proporcionado.

​

Paso 2: Crear una tabla de premios para la tabla de clasificación

• Leaderboards en el menú de la izquierda.
• Seleccione la pestaña Prize Tables.
• Seleccione el botón NEW PRIZE TABLE para ir a la vista New Prize Table.

• Vaya al área INFO e introduzca el nombre de la nueva tabla de premios, titulada End Tournament Prizes.
• Elija tournamentScore_manual en el menú desplegable Leaderboard.

• Seleccione + ADD RANK en la sección TABLE CONTENTS.
• Aparecerá un formulario de posición.

• Compruebe que el campo Rank from tiene el valor 1.
• Compruebe que el campo To (inclusive) tiene el valor 2.
• En el menú desplegable Type, elija Grant virtual currency.
• En el menú desplegable virtual currency code, elija GO (Gold) con una cantidad de 10.

• Seleccione +ADD RANK en la sección TABLE CONTENTS (también hay un segundo botón en la parte inferior, que también funciona).
• En el formulario de posición que aparece, asegúrese de que el campo Rank from tiene el valor 3 y el campo To (inclusive) tiene el valor 5.
• En el menú desplegable Virtual currency code, elija SI (Silver) con una cantidad de 10.

​

Paso 3: Rellenar la tabla de clasificación con un jugador

• Seleccione Settings en el menú de la izquierda.
• Seleccione la pestaña API Features.
• Marque la casilla Allow client to post player statistics.
• Después, seleccione el botón SAVE API FEATURES en la parte inferior de la pantalla.

​

Ejemplo de código de C#

// Note: This is a recursive function. Invoke it initially with no parameter
public void CreatePlayerAndPopulateLeaderboard(int playerIndex = 5) {
    if (playerIndex <= 0) return;
    const string leaderboardName = "tournamentScore_manual";
    PlayFabClientAPI.LoginWithCustomID(new LoginWithCustomIDRequest {
        CustomId = playerIndex.ToString(),
        CreateAccount = true
    }, result => OnLoggedIn(result,playerIndex,leaderboardName), FailureCallback);
}

private void OnLoggedIn(LoginResult loginResult, int playerIndex, string leaderboardName) {
    Debug.Log("Player has successfully logged in with " + loginResult.PlayFabId);
    PlayFabClientAPI.UpdatePlayerStatistics(new UpdatePlayerStatisticsRequest {
        Statistics = new List<StatisticUpdate> {
            new StatisticUpdate {
                StatisticName = leaderboardName,
                Value = playerIndex + 100
            }
        }
    }, result=> OnStatisticsUpdated(result,playerIndex), FailureCallback);
}

private void OnStatisticsUpdated(UpdatePlayerStatisticsResult updateResult, int playerIndex) {
    Debug.Log("Successfully updated player statistic");
    // Recursively invoke for next player
    CreatePlayerAndPopulateLeaderboard(playerIndex - 1);
}

private void FailureCallback(PlayFabError error){
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}

​

Comprobación de los resultados del ejemplo de código de C#

• Seleccione Leaderboards en el menú de la izquierda.
• En la pestaña Leaderboards, vuelva a la vista de lista de tablas de clasificación.
• Seleccione tournamentScore_manual y debería haber 5 jugadores con los valores 105, 104, 103, 102 y 101.

​

Paso 4: Comprobar las monedas iniciales de los jugadores

• Vuelva a Players en el menú de la izquierda del paso 2.
• Vaya a la pestaña Players y busque un jugador que se haya incluido en la tabla de clasificación tournamentScore_manual en el paso 3.
• Seleccione el identificador del jugador y la pestaña Virtual Currency de ese jugador.
• Anote los valores de las monedas GO (Gold) y SI (Silver) de ese jugador.

• Vaya a Players y busque uno que se haya incluido en la tabla de clasificación tournamentScore_manual en el paso 3.
• Seleccione el identificador del jugador y la pestaña Virtual Currency de ese jugador.
• Anote los valores de las monedas GO (Gold) y SI (Silver) de ese jugador.
• Ahora haga esto para los 4 jugadores restantes de los 5 que se incluyeron en la tabla de clasificación tournamentScore_manual en el paso 3.
• Asegúrese de anotar los valores de sus monedas GO (Gold) y SI (Silver) (serán importantes para confirmar que la tabla de premios funcionó después del restablecimiento).

​

Paso 5: Restablecer la tabla de clasificación para otorgar las recompensas

• Vuelva a la vista de lista de tablas de clasificación.
• Seleccione tournamentScore_manual.
• Anote las posiciones de los jugadores en la tabla de clasificación (están indexadas desde cero, por lo que la posición 0 será el primer puesto).
• Seleccione el botón RESET NOW.
• Seleccione el botón RESET para confirmar el restablecimiento de la tabla de clasificación.
• Esto borrará la lista de jugadores.

• Seleccione el botón RESET NOW en la parte superior de la pantalla.
• Cuando se le pregunte Reset this Leaderboard now?, seleccione el botón RESET para confirmar el restablecimiento.
• Esto borrará la lista de jugadores.

​

Paso 6: Probar que la tabla de premios funciona

• Seleccione Players en el menú de la izquierda.
• La pestaña PlayStream mostrará un evento de clasificación de un jugador en una tabla de clasificación, seguido de una actualización de moneda virtual.

• Seleccione Players en el menú de la izquierda.
• En la pestaña Players, vaya al área Virtual Currency de la pantalla.
• Compruebe que la moneda se otorgó correctamente.
• Debería ser una más que la cantidad anotada anteriormente.
• Observe que los jugadores en las posiciones 0 o 1 de la tabla de clasificación ganaron 10 de oro sin recibir plata.
• Mientras tanto, a los jugadores en las posiciones 2, 3 y 4 se les otorgaron 10 de plata y nada de oro.
• Esto coincide con las acciones configuradas para la tabla de premios.

• Entre en Players.
• Consulte el historial de eventos.
• Este mostrará un evento player_virtual_currency_balance_changed con detalles específicos sobre las cantidades que cambiaron para la moneda virtual otorgada.