Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Ações validadas

Faz o servidor validar as ações do jogo.

SDK: developRequer uma sessão de jogador
Unity
Ilustração de Ações validadas
O resultado visível

Uma ação válida é aceite e uma ação inválida é rejeitada.

Validar ações do jogo3:12

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.

    Ações validadas →
  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
    Aceitar pontuações apenas de partidas validadas
    true
    Pontuação máxima
    20000
    Duração mínima (segundos)
    0
    Fase obrigatória
    false

    Guardem estas regras num projeto de teste sem outros limites. Os bytes fixos quickstart testam o protocolo. A pontuação 18250 deve passar. Iniciem outra partida com 20001 para testar a rejeição. No jogo, registem entradas reais.

    Classificação →
  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.

Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

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

C#
Assets/Scripts/ValidatedActionsDemo.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 ValidatedActionsDemo : 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 byte[] inputLog = System.Text.Encoding.UTF8.GetBytes("quickstart");
23​
24 // horizOn: iniciar uma partida, gravar os inputs, enviar a
25 // pontuação validada.
26 // 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
27 var va = ValidatedActionsManager.Instance;
28​
29 // 2. Round start: single-use ticket plus server seed
30 var run = await va.StartRun("weekly");
31 if (run == null) { Debug.Log(va.LastErrorCode); return; } // e.g. RUN_RATE_LIMITED
32 var random = new System.Random(run.seed);
33​
34 // Protocol test input only. Replace it with actual recorded game inputs in your game.
35​
36 // 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
37 var result = await va.SubmitValidated(18250, inputLog);
38 if (result == null)
39 {
40 Debug.Log($"{va.LastErrorCode}, run kept: {va.HasActiveRun}");
41 return;
42 }
43 Debug.Log($"Accepted score={result.score}, rank={result.rank}");
44 }
45}
Abrir o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

Uma ação válida é aceite e uma ação inválida é rejeitada.

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

Endpoints da API
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Todos os endpoints na referência da API
Ilustração de Tabelas de classificação
A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.

Vídeo tutorial

Ações validadasUnity3:28

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗
Valores controlados pelo servidorUnity4:44

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗
Log de entradasUnity5:13

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗