Spielideen & Features

Euer nächstes Feature

Geschenkcodes

Spieler Gift Codes eingeben und einlösen lassen.

Spielersession erforderlich
Unity
Illustration für Geschenkcodes
Euer sichtbares Ergebnis

Ein Testcode wird eingelöst. Erneutes Einlösen folgt euren Regeln.

Gift Code erstellen1:36
Video separat öffnen ↗
Video folgt

Für diesen Schritt fehlt noch das Video. Die Anleitung und der MCP-Auftrag sind bereits nutzbar.

Serverseitige Spielerwerte

Dasselbe Projekt vorbereiten

  1. Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

    Geschenkcodes →
  2. Erstellt diese Testeinträge im Dashboard-Formular oder verwendet passende vorhandene Einträge. Die Werte sind Beispieldaten, kein aktueller Projektstand.

    Code
    WELCOME
    Geschenkdaten (JSON)
    {}
    Max. pro Benutzer
    1

    Bis zu acht konfigurierte Werte schreibt der Server beim Einlösen gut. giftData bleibt eine getrennte Spielnutzlast. Zeige den zurückgegebenen Stand an; addiere die Belohnung nicht erneut lokal.

    Spielerwerte →
  3. Speichert die Einträge, ladet sie neu und prüft sie vor dem Beispiel. Erhaltet andere vorhandene Definitionen.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Bis zu acht konfigurierte Werte schreibt der Server beim Einlösen gut. giftData bleibt eine getrennte Spielnutzlast. Zeige den zurückgegebenen Stand an; addiere die Belohnung nicht erneut lokal. Dieses SDK-Beispiel nutzt develop. Prüft, ob die nötigen APIs in eurem installierten SDK verfügbar sind.

Speichert die C#-Datei, hängt sie an ein GameObject und startet Play. Prüft die Console.

C#
Assets/Scripts/GiftCodesDemo.cs
horizOn-AufrufEinrichtung
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Hängt dieses Skript an ein GameObject in eurer ersten Szene.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Einrichtung: initialisieren, verbinden und einen Spieler
11 // anmelden.
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: Geschenkcode prüfen und einlösen.
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}
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Ein Testcode wird eingelöst. Erneutes Einlösen folgt euren Regeln.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Endpunkte
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Alle Endpunkte in der API-Referenz
Illustration für Bestenlisten
Unser Vorschlag für den nächsten Schritt

Gebt jeder Runde einen Highscore.

Speichert den Score nach dem Spiel und zeigt, wer vorne liegt. Eure Verbindung und Spielersession nutzt ihr weiter.