Spelideeën en functies

Je volgende functie

Cadeaucodes

Laat spelers cadeaucodes invoeren en inwisselen.

Spelerssessie vereist
Unity
Illustratie van Cadeaucodes
Je zichtbare resultaat

Een testcode wordt ingewisseld. Opnieuw inwisselen volgt je regels.

Een cadeaucode aanmaken1:42

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗
Video volgt

Voor deze stap is nog geen video. De handleiding en MCP-opdracht zijn al bruikbaar.

Spelerwaarden op de server

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Cadeaucodes →
  2. Maak of hergebruik deze testgegevens in het dashboardformulier. Dit zijn voorbeeldwaarden, geen huidige projectgegevens.

    Code
    WELCOME
    Cadeaugegevens (JSON)
    {}
    Max. per Gebruiker
    1

    De server kent bij inwisseling maximaal acht ingestelde waarden toe. giftData blijft aparte speldata. Toon het ontvangen saldo en tel de beloning niet opnieuw lokaal op.

    Spelerwaarden →
  3. Sla de gegevens op, laad ze opnieuw en controleer ze vóór het voorbeeld. Behoud andere definities.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

De server kent bij inwisseling maximaal acht ingestelde waarden toe. giftData blijft aparte speldata. Toon het ontvangen saldo en tel de beloning niet opnieuw lokaal op. Dit SDK-voorbeeld gebruikt develop. Controleer of de benodigde API's in je geïnstalleerde SDK bestaan.

Sla het C#-bestand op, koppel het aan een GameObject en start Play. Controleer Console.

C#
Assets/Scripts/GiftCodesDemo.cs
horizOn-aanroepVoorbereiding
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Koppel dit script aan een GameObject in je eerste scène.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Voorbereiding: initialiseren, verbinden en een speler aanmelden.
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: een cadeaucode controleren en inwisselen.
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}
Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Een testcode wordt ingewisseld. Opnieuw inwisselen volgt je regels.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Alle eindpunten in de API-referentie
Illustratie van Leaderboards
Onze suggestie voor je volgende stap

Geef elke ronde een topscore.

Sla de score na een ronde op en laat zien wie vooropstaat. Blijf je verbinding en de sessie van de speler gebruiken.