Spelideeën en functies

Je volgende functie

Leaderboard

Sla de score na elke ronde op en laat zien wie vooropstaat.

Spelerssessie vereist
Unity
Illustratie van Leaderboard
Je zichtbare resultaat

Je testscore verschijnt na een ronde in de ranglijst.

Scorebordstanden bekijken3:54

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Leaderboard →
  2. Maak of hergebruik deze testgegevens in het dashboardformulier. Dit zijn voorbeeldwaarden, geen huidige projectgegevens.

    Sleutel (slug)
    weekly
    Sortering
    DESC
    Alleen scores van gevalideerde runs accepteren
    false
  3. Sla de gegevens op, laad ze opnieuw en controleer ze vóór het voorbeeld. Behoud andere definities.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

Sla het C#-bestand op, koppel het aan een GameObject en start Play. Controleer Console.

C#
Assets/Scripts/LeaderboardDemo.cs
horizOn-aanroepVoorbereiding
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Koppel dit script aan een GameObject in je eerste scène.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Voorbereiding: initialiseren, verbinden en een speler aanmelden.
11 HorizonApp.Initialize();
12 await new HorizonServer().Connect();
13 if (!UserManager.Instance.IsSignedIn)
14 {
15 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
16 ? await UserManager.Instance.RestoreAnonymousSession()
17 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
18 if (!authenticated) return;
19 }
20​
21 // horizOn: een score indienen, de ranglijst en je eigen positie
22 // lezen.
23 var boards = LeaderboardManager.Instance;
24 bool submitted = await boards.SubmitScore(12500, boardKey: "weekly");
25 if (!submitted) { Debug.LogWarning(boards.LastErrorCode); return; }
26 var top = await boards.GetTop(10, useCache: false, boardKey: "weekly");
27 if (top == null) return;
28 foreach (var entry in top) Debug.Log($"#{entry.position} {entry.username}: {entry.score}");
29 var rank = await boards.GetRank(boardKey: "weekly");
30 if (rank != null) Debug.Log($"Your rank: {rank.position}");
31 }
32}
Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Je testscore verschijnt na een ronde in de ranglijst.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Alle eindpunten in de API-referentie