Idee e funzionalità per il gioco

La tua prossima funzionalità

Azioni convalidate

Fai convalidare le azioni di gioco dal server.

SDK: developSessione del giocatore richiesta
Godot
Illustrazione di Azioni convalidate
Il risultato visibile

Un'azione valida viene accettata e un'azione non valida viene rifiutata.

Convalida le azioni di gioco3:12

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗

Preparare lo stesso progetto

  1. Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

    Azioni convalidate →
  2. Create o riutilizzate queste voci di prova nel modulo del pannello. Sono valori di esempio, non dati attuali.

    Chiave (slug)
    weekly
    Accetta punteggi solo da partite convalidate
    true
    Punteggio massimo
    20000
    Durata minima (secondi)
    0
    Livello obbligatorio
    false

    Salvate queste regole in un progetto di prova senza altri limiti. I byte fissi quickstart verificano il protocollo. Il punteggio 18250 dovrebbe passare. Avviate una nuova partita con 20001 per verificarne il rifiuto. Nel gioco registrate input reali.

    Classifica →
  3. Salvate, ricaricate e verificate le voci prima dell’esempio. Conservate le altre definizioni.

Integra questa funzionalità

Puoi consultare la guida. Per eseguirla serve una chiave di progetto attiva. Prepara il progetto

SDK installato, configurazione del progetto importata e giocatore connesso.

Questo esempio del SDK usa develop. Verifica che le API necessarie siano disponibili nel SDK installato.

Salvate il GDScript, collegatelo a un nodo della scena principale e avviatela. Controllate Output.

GDScript
res://scripts/validated_actions.gd
Chiamata horizOnPreparazione
1# Aggiungi questo script a un nodo della tua scena principale.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Preparazione: inizializza, connetti e fai accedere un giocatore.
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: avvia una partita, registra gli input, invia il punteggio
23 # convalidato.
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"))
Aprire l’esempio SDK completo ↗

Prova la tua nuova funzionalità.

Un'azione valida viene accettata e un'azione non valida viene rifiutata.

Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

Endpoint dell'API
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Tutti gli endpoint nel riferimento API
Illustrazione di Classifiche
Il nostro suggerimento per il prossimo passo

Dai un record a ogni partita.

Salva il punteggio dopo una partita e mostra chi è in testa. Continua a usare la connessione e la sessione del giocatore.

Video tutorial

Azioni convalidateGodot6:05

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗
Valori gestiti dal serverGodot4:58

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗
Log degli inputGodot5:45

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗