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
Unity
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 file C#, collegatelo a un GameObject e avviate Play. Controllate Console.

C#
Assets/Scripts/ValidatedActionsDemo.cs
Chiamata horizOnPreparazione
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Aggiungi questo script a un GameObject della tua prima scena.
6public class ValidatedActionsDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Preparazione: inizializza, connetti e fai accedere un giocatore.
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: avvia una partita, registra gli input, invia il
24 // punteggio convalidato.
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}
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 convalidateUnity3:28

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗
Valori gestiti dal serverUnity4:44

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗
Log degli inputUnity5:13

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗