Spelideeën en functies

Je volgende functie

Gevalideerde acties

Laat de server spelacties valideren.

SDK: developSpelerssessie vereist
Unity
Illustratie van Gevalideerde acties
Je zichtbare resultaat

Een geldige actie wordt geaccepteerd en een ongeldige actie wordt afgewezen.

Spelacties valideren3:12

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Gevalideerde acties →
  2. Maak of hergebruik deze testgegevens in het dashboardformulier. Dit zijn voorbeeldwaarden, geen huidige projectgegevens.

    Sleutel (slug)
    weekly
    Alleen scores van gevalideerde runs accepteren
    true
    Hoogste score
    20000
    Minimale duur (seconden)
    0
    Fase verplicht
    false

    Sla deze regels zonder andere limieten op in een testproject. De vaste quickstart-bytes testen het protocol. Score 18250 hoort te slagen. Start een nieuwe ronde met 20001 om afwijzing te testen. Leg in het spel echte invoer vast.

    Leaderboard →
  3. Sla de gegevens op, laad ze opnieuw en controleer ze vóór het voorbeeld. Behoud andere definities.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

Dit SDK-voorbeeld gebruikt develop. Controleer of de benodigde API's in je geïnstalleerde SDK bestaan.

Sla het C#-bestand op, koppel het aan een GameObject en start Play. Controleer Console.

C#
Assets/Scripts/ValidatedActionsDemo.cs
horizOn-aanroepVoorbereiding
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Koppel dit script aan een GameObject in je eerste scène.
6public class ValidatedActionsDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Voorbereiding: initialiseren, verbinden en een speler aanmelden.
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 byte[] inputLog = System.Text.Encoding.UTF8.GetBytes("quickstart");
22​
23 // horizOn: een run starten, de invoer opnemen, de gevalideerde
24 // score indienen.
25 // 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
26 var va = ValidatedActionsManager.Instance;
27​
28 // 2. Round start: single-use ticket plus server seed
29 var run = await va.StartRun("weekly");
30 if (run == null) { Debug.Log(va.LastErrorCode); return; } // e.g. RUN_RATE_LIMITED
31 var random = new System.Random(run.seed);
32​
33 // Protocol test input only. Replace it with actual recorded game inputs in your game.
34​
35 // 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
36 var result = await va.SubmitValidated(18250, inputLog);
37 if (result == null)
38 {
39 Debug.Log($"{va.LastErrorCode}, run kept: {va.HasActiveRun}");
40 return;
41 }
42 Debug.Log($"Accepted score={result.score}, rank={result.rank}");
43 }
44}
Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Een geldige actie wordt geaccepteerd en een ongeldige actie wordt afgewezen.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Alle eindpunten in de API-referentie
Illustratie van Leaderboards
Onze suggestie voor je volgende stap

Geef elke ronde een topscore.

Sla de score na een ronde op en laat zien wie vooropstaat. Blijf je verbinding en de sessie van de speler gebruiken.

Instructievideo

Gevalideerde actiesUnity3:28

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗
Door de server beheerde waardenUnity4:44

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗
InvoerlogUnity5:13

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗