Pomysły i funkcje gry

Twoja następna funkcja

Ranking

Zapisz wynik po każdej rundzie i pokaż, kto prowadzi.

Wymagana sesja gracza
Unity
Ilustracja funkcji Ranking
Widoczny rezultat

Testowy wynik pojawia się w rankingu po rundzie.

Podgląd pozycji w rankingu3:54

Ten samouczek jest odtwarzany po angielsku.

Otwórz wideo osobno ↗

Przygotuj ten sam projekt

  1. Wybierz w panelu ten sam projekt co w konfiguracji gry.

    Ranking →
  2. Utwórz lub wykorzystaj te wpisy testowe w formularzu panelu. To wartości przykładowe, nie aktualne dane projektu.

    Klucz (slug)
    weekly
    Kolejność sortowania
    DESC
    Przyjmuj wyniki tylko ze zweryfikowanych rozgrywek
    false
  3. Zapisz, wczytaj ponownie i sprawdź wpisy przed uruchomieniem przykładu. Zachowaj pozostałe definicje.

Dodaj tę funkcję

Możesz przeglądać poradnik. Uruchomienie wymaga aktywnego klucza projektu. Przygotuj projekt

Zainstalowany SDK, zaimportowana konfiguracja projektu i zalogowany gracz.

Zapisz plik C#, przypnij do GameObject i uruchom Play. Sprawdź Console.

C#
Assets/Scripts/LeaderboardDemo.cs
Wywołanie horizOnPrzygotowanie
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Dodaj ten skrypt do obiektu GameObject w pierwszej scenie.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Przygotowanie: inicjalizacja, połączenie i logowanie gracza.
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: wyślij wynik, odczytaj ranking i własne miejsce.
22 var boards = LeaderboardManager.Instance;
23 bool submitted = await boards.SubmitScore(12500, boardKey: "weekly");
24 if (!submitted) { Debug.LogWarning(boards.LastErrorCode); return; }
25 var top = await boards.GetTop(10, useCache: false, boardKey: "weekly");
26 if (top == null) return;
27 foreach (var entry in top) Debug.Log($"#{entry.position} {entry.username}: {entry.score}");
28 var rank = await boards.GetRank(boardKey: "weekly");
29 if (rank != null) Debug.Log($"Your rank: {rank.position}");
30 }
31}
Otwórz pełny przykład SDK ↗

Przetestuj nową funkcję.

Testowy wynik pojawia się w rankingu po rundzie.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Wszystkie punkty końcowe w dokumentacji API