Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Classificação

Guarda a pontuação depois de cada partida e mostra quem está à frente.

Requer uma sessão de jogador
Unity
Ilustração de Classificação
O resultado visível

A tua pontuação de teste aparece na classificação depois de uma partida.

Ver a classificação do placar3:54

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗

Preparar o mesmo projeto

  1. Seleciona no painel o mesmo projeto que na configuração do teu jogo.

    Classificação →
  2. Criem ou reutilizem estas entradas de teste no formulário do painel. São valores de exemplo, não dados atuais.

    Chave (slug)
    weekly
    Ordem de classificação
    DESC
    Aceitar pontuações apenas de partidas validadas
    false
  3. Guardem, recarreguem e verifiquem as entradas antes do exemplo. Preservem as restantes definições.

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

Guardem o ficheiro C#, associem-no a um GameObject e iniciem Play. Verifiquem Console.

C#
Assets/Scripts/LeaderboardDemo.cs
Chamada ao horizOnPreparação
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Adiciona este script a um GameObject da tua primeira cena.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Preparação: inicializar, conectar e iniciar a sessão de um
11 // jogador.
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 uma pontuação, ler a classificação e a própria
23 // posição.
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 o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

A tua pontuação de teste aparece na classificação depois de uma partida.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Endpoints da API
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Todos os endpoints na referência da API