Ideas y funciones para tu juego

Tu próxima función

Códigos de Regalo

Permite que los jugadores introduzcan y canjeen códigos de regalo.

Requiere una sesión de jugador
Unity
Ilustración de Códigos de Regalo
El resultado visible

Se canjea un código de prueba. Los canjes repetidos siguen tus reglas.

Crear un código de regalo1:42

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗
Vídeo próximamente

Este paso aún no tiene vídeo. La guía y la solicitud MCP ya se pueden utilizar.

Valores del jugador en el servidor

Preparar el mismo proyecto

  1. Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

    Códigos de Regalo →
  2. Cread o reutilizad estas entradas de prueba en el formulario del panel. Son valores de ejemplo, no datos actuales.

    Código
    WELCOME
    Datos del Regalo (JSON)
    {}
    Máximo por Usuario
    1

    El servidor acredita hasta ocho valores configurados al canjear. giftData sigue siendo una carga del juego independiente. Muestra el saldo recibido sin sumar otra vez la recompensa localmente.

    Valores del jugador →
  3. Guardad, recargad y verificad las entradas antes del ejemplo. Conservad las demás definiciones.

Implementa esta función

Puedes consultar la guía. Para ejecutarla necesitas una clave de proyecto activa. Preparar el proyecto

SDK instalado, configuración del proyecto importada y jugador conectado.

El servidor acredita hasta ocho valores configurados al canjear. giftData sigue siendo una carga del juego independiente. Muestra el saldo recibido sin sumar otra vez la recompensa localmente. Este ejemplo del SDK usa develop. Comprueba si las API necesarias están disponibles en el SDK instalado.

Guardad el archivo C#, añadidlo a un GameObject y activad Play. Revisad Console.

C#
Assets/Scripts/GiftCodesDemo.cs
Llamada a horizOnPreparación
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Añade este script a un GameObject de tu primera escena.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Preparación: inicializar, conectar e iniciar la sesión de un
11 // jugador.
12 HorizonApp.Initialize();
13 await new HorizonServer().Connect();
14 if (!UserManager.Instance.IsSignedIn)
15 {
16 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
17 ? await UserManager.Instance.RestoreAnonymousSession()
18 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
19 if (!authenticated) return;
20 }
21​
22 // horizOn: validar un código de regalo y canjearlo.
23 // Run from one explicit player action; serialize this handler until it completes.
24 string userId = UserManager.Instance.CurrentUser.UserId;
25 string project = HorizonApp.Network.GetApiKey();
26 string scope = PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent.ProjectFingerprint(project);
27 string pendingKey = "horizOn_gift_v2_" + scope + "_" + userId;
28 // Preserve an old V1 demo record for reconciliation. Never reinterpret its UUID as a count.
29 if (PlayerPrefs.HasKey("horizOn_gift_pending_" + userId)) return;
30 PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent pending;
31 if (PlayerPrefs.HasKey(pendingKey)) {
32 pending = JsonUtility.FromJson<PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent>(PlayerPrefs.GetString(pendingKey));
33 if (pending == null || !pending.IsValidFor(project, userId)) return;
34 } else {
35 pending = await GiftCodeManager.Instance.PrepareRedemption("WELCOME");
36 if (pending == null || !pending.IsValidFor(project, userId) || PlayerPrefs.HasKey(pendingKey)) return;
37 PlayerPrefs.SetString(pendingKey, JsonUtility.ToJson(pending));
38 PlayerPrefs.Save(); // All seven fields before the first mutating request.
39 }
40 string original = JsonUtility.ToJson(pending);
41 if (PlayerPrefs.GetString(pendingKey) != original) return;
42 var result = await GiftCodeManager.Instance.RedeemPrepared(pending);
43 if (result == null || !result.success) return; // Keep the exact tuple after any uncertain result.
44 if (PlayerPrefs.GetString(pendingKey) == original) {
45 PlayerPrefs.DeleteKey(pendingKey);
46 PlayerPrefs.Save();
47 }
48 if (result.playerValues != null) {
49 foreach (var value in result.playerValues.values) Debug.Log(value.key + "=" + value.balance);
50 }
51 // alreadyApplied/replayed means the sequence slot was consumed, with no copied historical rewards.
52 // Replace balances with playerValues. Never add grantedValues locally.
53 }
54}
Abrir el ejemplo completo del SDK ↗

Prueba tu nueva función.

Se canjea un código de prueba. Los canjes repetidos siguen tus reglas.

Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

Endpoints de la API
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Todos los endpoints en la referencia de la API
Ilustración de Tablas de clasificación
Nuestra sugerencia para el siguiente paso

Dale una puntuación máxima a cada partida.

Guarda la puntuación después de una partida y muestra quién va primero. Sigue usando tu conexión y la sesión del jugador.