Spielideen & Features

Euer nächstes Feature

Leaderboard

Den Score nach Rundenende speichern und zeigen, wer vorne liegt.

Spielersession erforderlich
Unity
Illustration für Leaderboard
Euer sichtbares Ergebnis

Nach Rundenende erscheint euer Testscore in der Rangliste.

Bestenlisten-Platzierungen ansehen3:48
Video separat öffnen ↗

Dasselbe Projekt vorbereiten

  1. Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

    Leaderboard →
  2. Erstellt diese Testeinträge im Dashboard-Formular oder verwendet passende vorhandene Einträge. Die Werte sind Beispieldaten, kein aktueller Projektstand.

    Key (Slug)
    weekly
    Sortierreihenfolge
    DESC
    Punkte nur aus validierten Runs annehmen
    false
  3. Speichert die Einträge, ladet sie neu und prüft sie vor dem Beispiel. Erhaltet andere vorhandene Definitionen.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Speichert die C#-Datei, hängt sie an ein GameObject und startet Play. Prüft die Console.

C#
Assets/Scripts/LeaderboardDemo.cs
horizOn-AufrufEinrichtung
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Hängt dieses Skript an ein GameObject in eurer ersten Szene.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Einrichtung: initialisieren, verbinden und einen Spieler
11 // anmelden.
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: Punktzahl einreichen, Bestenliste und eigenen Rang
23 // lesen.
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}
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Nach Rundenende erscheint euer Testscore in der Rangliste.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Endpunkte
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Alle Endpunkte in der API-Referenz