Idee e funzionalità per il gioco

La tua prossima funzionalità

Codici Regalo

Permetti ai giocatori di inserire e riscattare codici regalo.

Sessione del giocatore richiesta
Godot
Illustrazione di Codici Regalo
Il risultato visibile

Un codice di prova viene riscattato. I riscatti ripetuti seguono le tue regole.

Crea un codice regalo1:42

Questo tutorial viene riprodotto in inglese.

Apri il video separatamente ↗
Video in arrivo

Questo passaggio non ha ancora un video. La guida e la richiesta MCP sono già utilizzabili.

Valori giocatore sul server

Preparare lo stesso progetto

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

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

    Codice
    WELCOME
    Dati Regalo (JSON)
    {}
    Massimo per Utente
    1

    Il server accredita fino a otto valori configurati al riscatto. giftData resta un contenuto separato del gioco. Mostra il saldo ricevuto senza aggiungere di nuovo la ricompensa localmente.

    Valori del giocatore →
  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.

Il server accredita fino a otto valori configurati al riscatto. giftData resta un contenuto separato del gioco. Mostra il saldo ricevuto senza aggiungere di nuovo la ricompensa localmente. 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/gift_codes.gd
Chiamata horizOnPreparazione
1# Aggiungi questo script a un nodo della tua scena principale.
2extends Node
3​
4​
5func _ready() -> void:
6 # Preparazione: inizializza, connetti e fai accedere un giocatore.
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: verifica un codice regalo e riscattalo.
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.
Aprire l’esempio SDK completo ↗

Prova la tua nuova funzionalità.

Un codice di prova viene riscattato. I riscatti ripetuti seguono le tue regole.

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

Endpoint dell'API
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
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.