Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Códigos de Presente

Permite aos jogadores introduzir e resgatar códigos de oferta.

Requer uma sessão de jogador
Unity
Ilustração de Códigos de Presente
O resultado visível

Um código de teste é resgatado. Resgates repetidos seguem as tuas regras.

Crie um código de presente1:42

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗
Vídeo em breve

Este passo ainda não tem vídeo. O guia e o pedido MCP já podem ser usados.

Valores do jogador no servidor

Preparar o mesmo projeto

  1. Seleciona no painel o mesmo projeto que na configuração do teu jogo.

    Códigos de Presente →
  2. Criem ou reutilizem estas entradas de teste no formulário do painel. São valores de exemplo, não dados atuais.

    Código
    WELCOME
    Dados do Presente (JSON)
    {}
    Máximo por Usuário
    1

    O servidor credita até oito valores configurados no resgate. giftData continua separado dos valores do jogador. Mostre o saldo retornado sem adicionar a recompensa novamente no cliente.

    Valores do jogador →
  3. Guardem, recarreguem e verifiquem as entradas antes do exemplo. Preservem as restantes definições.

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

O servidor credita até oito valores configurados no resgate. giftData continua separado dos valores do jogador. Mostre o saldo retornado sem adicionar a recompensa novamente no cliente. Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

Guardem o ficheiro C#, associem-no a um GameObject e iniciem Play. Verifiquem Console.

C#
Assets/Scripts/GiftCodesDemo.cs
Chamada ao horizOnPreparação
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Adiciona este script a um GameObject da tua primeira cena.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Preparação: inicializar, conectar e iniciar a sessão de um
11 // jogador.
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 um código de oferta e resgatá-lo.
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 o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

Um código de teste é resgatado. Resgates repetidos seguem as tuas regras.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Endpoints da API
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Todos os endpoints na referência da API
Ilustração de Tabelas de classificação
A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.