> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Uso de tablas de premios
> Cree tablas de premios de PlayFab que otorguen moneda virtual, elementos de inventario, notificaciones push o acciones de CloudScript a los primeros puestos cuando se restablezca una tabla de clasificación.
Este tutorial le guía por la creación de una tabla de premios que desencadena un conjunto de acciones sobre un grupo de jugadores dentro de un intervalo de posiciones, en una [tabla de clasificación restablecible](/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).
En concreto, esta es una manera de desencadenar correos electrónicos, enviar notificaciones push, otorgar [elementos de inventario](/services/playfab/player-progression/player-data/player-inventory) y [moneda virtual](/services/playfab/economy-monetization/economy/tutorials/currencies), o ejecutar una función de [CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript/writing-custom-cloudscript) al restablecerse una tabla de clasificación.
En este ejemplo, le mostramos cómo crear una tabla de premios de fin de torneo, que otorga moneda virtual a 5 jugadores en función de su posición en una tabla de clasificación después de realizar un restablecimiento.
## Requisitos
Este es un tutorial *avanzado*. Asegúrese de que se cumplen todos los requisitos que se muestran a continuación o *no* podrá completar este tutorial.
* 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](/services/playfab/live-service-management/gamemanager/quickstart) 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](/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).
* Además, deben configurarse las monedas virtuales. Lea nuestro tutorial sobre [monedas](/services/playfab/economy-monetization/economy/tutorials/currencies) 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
En Game Manager:
* 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
Ahora que se ha creado una tabla de clasificación, se le puede asociar una tabla de premios. Vaya a:
* **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**.
En 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**.
Para que esta tabla de premios realice alguna acción, será necesario establecer las posiciones. Para ello:
* Seleccione **+ ADD RANK** en la sección **TABLE CONTENTS**.
* Aparecerá un formulario de **posición**.
En el 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**.
Ahora, agregaremos un segundo intervalo de posiciones:
* 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
Ya se ha creado una tabla de clasificación y una tabla de premios asociada a ella. El siguiente paso es rellenar la tabla de clasificación con jugadores.
Para crear jugadores, usaremos [LoginWithCustomID](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid). Después, usaremos los jugadores para rellenar la tabla de clasificación con [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics).
Antes de poder usar [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics), debemos habilitarlo en API Features.
* 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\#
El ejemplo de código de **C#** siguiente crea 5 jugadores y los conecta mediante [LoginWithCustomID](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid).
Después, rellena la tabla de clasificación que creó anteriormente (`tournamentScore_manual`) con los 5 jugadores con los valores: **105**, **104**, **103**, **102** y **101** mediante [UpdatePlayerStatistics](xref:titleid.playfabapi.com.client.playerdatamanagement.updateplayerstatistics).
```csharp theme={null}
// 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 {
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\#
Para comprobar que hay 5 jugadores en la tabla de clasificación con los valores correctos:
* 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
Antes de comprobar nada:
* 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.
Antes de comprobar nada, vuelva a los **jugadores** de prueba del paso 2.
* 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
Ahora vaya a **Leaderboards**.
* 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
Para ver si la tabla de premios funcionó, se puede comprobar si a los jugadores de la tabla de clasificación se les otorgaron las cantidades correctas de moneda. Esto se puede ver rápidamente en el depurador de PlayStream de un jugador.
Para verlo en el depurador de PlayStream:
* 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**.
Ahora, comprobemos manualmente si los jugadores recibieron las monedas correctas:
* 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.
Otra forma de comprobar que la **moneda virtual** se otorgó correctamente es:
* 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.
## Related topics
- [Torneos y tablas de clasificación](/es/services/playfab/community/leaderboards/tournaments-leaderboards/index.md)
- [Uso de estadísticas y tablas de clasificación restablecibles](/es/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards.md)
- [Uso de estadísticas de jugador](/es/services/playfab/community/leaderboards/tournaments-leaderboards/using-player-statistics.md)
- [Uso del perfil para tablas de clasificación avanzadas](/es/services/playfab/community/leaderboards/tournaments-leaderboards/using-the-profile-for-advanced-leaderboards.md)
- [Tablas de clasificación](/es/build/steam-porting-guide/features/steam-leaderboards.md)