Ideas y funciones para tu juego

Tu próxima función

Acciones validadas

Haz que el servidor valide las acciones de juego.

SDK: developRequiere una sesión de jugador
Unity
Ilustración de Acciones validadas
El resultado visible

Se acepta una acción válida y se rechaza una acción inválida.

Validar acciones del juego3:12

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗

Preparar el mismo proyecto

  1. Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

    Acciones validadas →
  2. Cread o reutilizad estas entradas de prueba en el formulario del panel. Son valores de ejemplo, no datos actuales.

    Clave (slug)
    weekly
    Aceptar puntuaciones solo de partidas validadas
    true
    Puntuación máxima
    20000
    Duración mínima (segundos)
    0
    Fase obligatoria
    false

    Guardad estas reglas en un proyecto de prueba sin otros límites. Los bytes fijos quickstart prueban el protocolo. La puntuación 18250 debe aceptarse. Iniciad otra partida con 20001 para comprobar el rechazo. En el juego, registrad entradas reales.

    Tabla de Clasificación →
  3. Guardad, recargad y verificad las entradas antes del ejemplo. Conservad las demás definiciones.

Implementa esta función

Puedes consultar la guía. Para ejecutarla necesitas una clave de proyecto activa. Preparar el proyecto

SDK instalado, configuración del proyecto importada y jugador conectado.

Este ejemplo del SDK usa develop. Comprueba si las API necesarias están disponibles en el SDK instalado.

Guardad el archivo C#, añadidlo a un GameObject y activad Play. Revisad Console.

C#
Assets/Scripts/ValidatedActionsDemo.cs
Llamada a horizOnPreparación
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Añade este script a un GameObject de tu primera escena.
6public class ValidatedActionsDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Preparación: inicializar, conectar e iniciar la sesión de un
11 // jugador.
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 una partida, grabar las entradas y enviar la
25 // puntuación 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 el ejemplo completo del SDK ↗

Prueba tu nueva función.

Se acepta una acción válida y se rechaza una acción inválida.

Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

Endpoints de la API
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Todos los endpoints en la referencia de la API
Ilustración de Tablas de clasificación
Nuestra sugerencia para el siguiente paso

Dale una puntuación máxima a cada partida.

Guarda la puntuación después de una partida y muestra quién va primero. Sigue usando tu conexión y la sesión del jugador.

Vídeo tutorial

Acciones validadasUnity3:28

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗
Valores gestionados por el servidorUnity4:44

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗
Registro de entradasUnity5:13

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗