Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Codes Cadeaux

Permettez aux joueurs de saisir et d'utiliser des codes cadeaux.

Session de joueur requise
Unity
Illustration de Codes Cadeaux
Votre résultat visible

Un code de test est utilisé. Une nouvelle utilisation suit vos règles.

Créer un code cadeau1:42

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗
Vidéo à venir

Cette étape n’a pas encore de vidéo. Le guide et la demande MCP sont utilisables.

Valeurs joueur côté serveur

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.

    Codes Cadeaux →
  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.

    Code
    WELCOME
    Données du Cadeau (JSON)
    {}
    Maximum par Utilisateur
    1

    Le serveur crédite jusqu’à huit valeurs configurées lors de l’échange. giftData reste une charge utile distincte du jeu. Affichez le solde renvoyé sans ajouter à nouveau la récompense localement.

    Valeurs du joueur →
  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é.

Le serveur crédite jusqu’à huit valeurs configurées lors de l’échange. giftData reste une charge utile distincte du jeu. Affichez le solde renvoyé sans ajouter à nouveau la récompense localement. 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/GiftCodesDemo.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 GiftCodesDemo : 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 // horizOn : valider un code cadeau et l'utiliser.
22 // Run from one explicit player action; serialize this handler until it completes.
23 string userId = UserManager.Instance.CurrentUser.UserId;
24 string project = HorizonApp.Network.GetApiKey();
25 string scope = PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent.ProjectFingerprint(project);
26 string pendingKey = "horizOn_gift_v2_" + scope + "_" + userId;
27 // Preserve an old V1 demo record for reconciliation. Never reinterpret its UUID as a count.
28 if (PlayerPrefs.HasKey("horizOn_gift_pending_" + userId)) return;
29 PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent pending;
30 if (PlayerPrefs.HasKey(pendingKey)) {
31 pending = JsonUtility.FromJson<PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent>(PlayerPrefs.GetString(pendingKey));
32 if (pending == null || !pending.IsValidFor(project, userId)) return;
33 } else {
34 pending = await GiftCodeManager.Instance.PrepareRedemption("WELCOME");
35 if (pending == null || !pending.IsValidFor(project, userId) || PlayerPrefs.HasKey(pendingKey)) return;
36 PlayerPrefs.SetString(pendingKey, JsonUtility.ToJson(pending));
37 PlayerPrefs.Save(); // All seven fields before the first mutating request.
38 }
39 string original = JsonUtility.ToJson(pending);
40 if (PlayerPrefs.GetString(pendingKey) != original) return;
41 var result = await GiftCodeManager.Instance.RedeemPrepared(pending);
42 if (result == null || !result.success) return; // Keep the exact tuple after any uncertain result.
43 if (PlayerPrefs.GetString(pendingKey) == original) {
44 PlayerPrefs.DeleteKey(pendingKey);
45 PlayerPrefs.Save();
46 }
47 if (result.playerValues != null) {
48 foreach (var value in result.playerValues.values) Debug.Log(value.key + "=" + value.balance);
49 }
50 // alreadyApplied/replayed means the sequence slot was consumed, with no copied historical rewards.
51 // Replace balances with playerValues. Never add grantedValues locally.
52 }
53}
Ouvrir l’exemple SDK complet ↗

Testez votre nouvelle fonctionnalité.

Un code de test est utilisé. Une nouvelle utilisation suit vos règles.

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

Points de terminaison
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
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.