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
Godot
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 GDScript, attachez-le à un nœud de la scène principale et lancez-la. Vérifiez Output.

GDScript
res://scripts/gift_codes.gd
Appel horizOnMise en place
1# Attache ce script à un nœud de ta scène principale.
2extends Node
3​
4​
5func _ready() -> void:
6 # Mise en place : initialiser, se connecter et connecter un joueur.
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn : valider un code cadeau et l'utiliser.
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
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.