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

C#
Assets/Scripts/GiftCodesDemo.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 GiftCodesDemo : 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 // horizOn: verifica un codice regalo e riscattalo.
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}
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.