Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Classement

Enregistrez le score après chaque partie et montrez qui est en tête.

Session de joueur requise
Unity
Illustration de Classement
Votre résultat visible

Votre score de test apparaît dans le classement après une partie.

Voir les classements3:54

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗

Préparer le même projet

  1. Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

    Classement →
  2. Créez ou réutilisez ces entrées de test dans le formulaire du tableau de bord. Ce sont des exemples, pas les données actuelles.

    Clé (slug)
    weekly
    Ordre de tri
    DESC
    N'accepter que les scores des parties validées
    false
  3. Enregistrez, rechargez et vérifiez les entrées avant l’exemple. Conservez les autres définitions.

Intégrer cette fonctionnalité

Vous pouvez consulter le guide. Son exécution nécessite une clé de projet active. Préparer le projet

SDK installé, configuration du projet importée et joueur connecté.

Enregistrez le fichier C#, attachez-le à un GameObject et lancez Play. Vérifiez Console.

C#
Assets/Scripts/LeaderboardDemo.cs
Appel horizOnMise en place
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Attache ce script à un GameObject de ta première scène.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Mise en place : initialiser, se connecter et connecter un joueur.
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 : envoyer un score, lire le classement et son propre
22 // rang.
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}
Ouvrir l’exemple SDK complet ↗

Testez votre nouvelle fonctionnalité.

Votre score de test apparaît dans le classement après une partie.

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

Points de terminaison
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Tous les points de terminaison dans la référence API