Spielideen & Features

Euer nächstes Feature

Validierte Aktionen

Spielaktionen serverseitig prüfen lassen.

SDK: developSpielersession erforderlich
Unity
Illustration für Validierte Aktionen
Euer sichtbares Ergebnis

Eine gültige Aktion wird angenommen und eine ungültige abgewiesen.

Spielaktionen validieren3:08
Video separat öffnen ↗

Dasselbe Projekt vorbereiten

  1. Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

    Validierte Aktionen →
  2. Erstellt diese Testeinträge im Dashboard-Formular oder verwendet passende vorhandene Einträge. Die Werte sind Beispieldaten, kein aktueller Projektstand.

    Key (Slug)
    weekly
    Punkte nur aus validierten Runs annehmen
    true
    Höchster Punktestand
    20000
    Mindestdauer (Sekunden)
    0
    Abschnitt erforderlich
    false

    Speichert diese Regeln in einem Testprojekt ohne weitere Grenzen. Die festen quickstart-Bytes prüfen das Anfrageprotokoll. Score 18250 sollte angenommen werden. Startet einen neuen Lauf mit 20001 für die Ablehnung. Zeichnet im Spiel echte Eingaben auf.

    Leaderboard →
  3. Speichert die Einträge, ladet sie neu und prüft sie vor dem Beispiel. Erhaltet andere vorhandene Definitionen.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Dieses SDK-Beispiel nutzt develop. Prüft, ob die nötigen APIs in eurem installierten SDK verfügbar sind.

Speichert die C#-Datei, hängt sie an ein GameObject und startet Play. Prüft die Console.

C#
Assets/Scripts/ValidatedActionsDemo.cs
horizOn-AufrufEinrichtung
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Hängt dieses Skript an ein GameObject in eurer ersten Szene.
6public class ValidatedActionsDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Einrichtung: initialisieren, verbinden und einen Spieler
11 // anmelden.
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: Run starten, Eingaben aufzeichnen, geprüfte Punktzahl
25 // einreichen.
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}
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Eine gültige Aktion wird angenommen und eine ungültige abgewiesen.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Endpunkte
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Alle Endpunkte in der API-Referenz
Illustration für Bestenlisten
Unser Vorschlag für den nächsten Schritt

Gebt jeder Runde einen Highscore.

Speichert den Score nach dem Spiel und zeigt, wer vorne liegt. Eure Verbindung und Spielersession nutzt ihr weiter.

Tutorial-Video

Validierte AktionenUnity3:24
Video separat öffnen ↗
Servereigene WerteUnity4:54
Video separat öffnen ↗
EingabeprotokollUnity5:14
Video separat öffnen ↗