Ideas y funciones para tu juego

Tu próxima función

Tabla de Clasificación

Guarda la puntuación después de cada partida y muestra quién va primero.

Requiere una sesión de jugador
Unity
Ilustración de Tabla de Clasificación
El resultado visible

Tu puntuación de prueba aparece en la clasificación después de una partida.

Ver las clasificaciones3:54

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗

Preparar el mismo proyecto

  1. Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

    Tabla de Clasificación →
  2. Cread o reutilizad estas entradas de prueba en el formulario del panel. Son valores de ejemplo, no datos actuales.

    Clave (slug)
    weekly
    Orden de clasificación
    DESC
    Aceptar puntuaciones solo de partidas validadas
    false
  3. Guardad, recargad y verificad las entradas antes del ejemplo. Conservad las demás definiciones.

Implementa esta función

Puedes consultar la guía. Para ejecutarla necesitas una clave de proyecto activa. Preparar el proyecto

SDK instalado, configuración del proyecto importada y jugador conectado.

Guardad el archivo C#, añadidlo a un GameObject y activad Play. Revisad Console.

C#
Assets/Scripts/LeaderboardDemo.cs
Llamada a horizOnPreparación
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Añade este script a un GameObject de tu primera escena.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Preparación: inicializar, conectar e iniciar la sesión de un
11 // jugador.
12 HorizonApp.Initialize();
13 await new HorizonServer().Connect();
14 if (!UserManager.Instance.IsSignedIn)
15 {
16 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
17 ? await UserManager.Instance.RestoreAnonymousSession()
18 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
19 if (!authenticated) return;
20 }
21​
22 // horizOn: enviar una puntuación, leer la clasificación y el propio
23 // puesto.
24 var boards = LeaderboardManager.Instance;
25 bool submitted = await boards.SubmitScore(12500, boardKey: "weekly");
26 if (!submitted) { Debug.LogWarning(boards.LastErrorCode); return; }
27 var top = await boards.GetTop(10, useCache: false, boardKey: "weekly");
28 if (top == null) return;
29 foreach (var entry in top) Debug.Log($"#{entry.position} {entry.username}: {entry.score}");
30 var rank = await boards.GetRank(boardKey: "weekly");
31 if (rank != null) Debug.Log($"Your rank: {rank.position}");
32 }
33}
Abrir el ejemplo completo del SDK ↗

Prueba tu nueva función.

Tu puntuación de prueba aparece en la clasificación después de una partida.

Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

Endpoints de la API
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Todos los endpoints en la referencia de la API