Spelideeën en functies

Je volgende functie

Gevalideerde acties

Laat de server spelacties valideren.

SDK: developSpelerssessie vereist
Godot
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 GDScript op, koppel het aan een knooppunt in de hoofdscène en voer die uit. Controleer Output.

GDScript
res://scripts/validated_actions.gd
horizOn-aanroepVoorbereiding
1# Koppel dit script aan een node in je hoofdscène.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Voorbereiding: initialiseren, verbinden en een speler aanmelden.
9 var connected = await Horizon.connect_to_server()
10 if not connected:
11 print("Failed to connect to horizOn server")
12 return
13 if not Horizon.auth.isSignedIn():
14 var signed_in: bool
15 if Horizon.auth.hasCachedAnonymousToken():
16 signed_in = await Horizon.auth.restoreAnonymousSession()
17 else:
18 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
19 if not signed_in:
20 return
21​
22 # horizOn: een run starten, de invoer opnemen, de gevalideerde score
23 # indienen.
24 # 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
25​
26 # 2. Round start: single-use ticket plus server seed
27 var run: Dictionary = await Horizon.validatedActions.startRun("weekly")
28 if run.is_empty():
29 print(Horizon.validatedActions.getLastErrorCode()) # e.g. RUN_RATE_LIMITED
30 return
31 var rng := RandomNumberGenerator.new()
32 rng.seed = 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: Dictionary = await Horizon.validatedActions.submitValidated(18250, input_log)
38 if result.is_empty():
39 print(Horizon.validatedActions.getLastErrorCode())
40 return
41 print("Accepted score=", result.get("score"), ", rank=", result.get("rank"))
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 actiesGodot6:05

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗
Door de server beheerde waardenGodot4:58

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗
InvoerlogGodot5:45

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗