Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Actions validées

Faites valider les actions de jeu par le serveur.

SDK : developSession de joueur requise
Unity
Illustration de Actions validées
Votre résultat visible

Une action valide est acceptée et une action invalide est rejetée.

Valider les actions du jeu3:12

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗

Préparer le même projet

  1. Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

    Actions validées →
  2. Créez ou réutilisez ces entrées de test dans le formulaire du tableau de bord. Ce sont des exemples, pas les données actuelles.

    Clé (slug)
    weekly
    N'accepter que les scores des parties validées
    true
    Score maximal
    20000
    Durée minimale (secondes)
    0
    Étape obligatoire
    false

    Enregistrez ces règles dans un projet de test sans autres limites. Les octets fixes quickstart testent le protocole. Le score 18250 doit être accepté. Lancez une nouvelle partie avec 20001 pour vérifier le refus. En jeu, enregistrez les véritables entrées.

    Classement →
  3. Enregistrez, rechargez et vérifiez les entrées avant l’exemple. Conservez les autres définitions.

Intégrer cette fonctionnalité

Vous pouvez consulter le guide. Son exécution nécessite une clé de projet active. Préparer le projet

SDK installé, configuration du projet importée et joueur connecté.

Cet exemple du SDK utilise develop. Vérifiez que les API nécessaires existent dans votre SDK installé.

Enregistrez le fichier C#, attachez-le à un GameObject et lancez Play. Vérifiez Console.

C#
Assets/Scripts/ValidatedActionsDemo.cs
Appel horizOnMise en place
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Attache ce script à un GameObject de ta première scène.
6public class ValidatedActionsDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Mise en place : initialiser, se connecter et connecter un joueur.
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 : démarrer une partie, enregistrer les entrées, envoyer
24 // le score validé.
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}
Ouvrir l’exemple SDK complet ↗

Testez votre nouvelle fonctionnalité.

Une action valide est acceptée et une action invalide est rejetée.

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

Points de terminaison
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Tous les points de terminaison dans la référence API
Illustration de Classements
Notre suggestion pour la suite

Donnez un meilleur score à chaque partie.

Enregistrez le score après une partie et montrez qui est en tête. Continuez avec votre connexion et la session du joueur.

Vidéo tutoriel

Actions validéesUnity3:28

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗
Valeurs gérées par le serveurUnity4:44

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗
Journal d'entréesUnity5:13

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗