Pomysły i funkcje gry

Twoja następna funkcja

Kody Podarunkowe

Pozwól graczom wpisywać i realizować kody prezentowe.

Wymagana sesja gracza
Unity
Ilustracja funkcji Kody Podarunkowe
Widoczny rezultat

Kod testowy zostaje zrealizowany. Ponowna realizacja podlega twoim zasadom.

Utworzenie kodu podarunkowego1:42

Ten samouczek jest odtwarzany po angielsku.

Otwórz wideo osobno ↗
Wideo pojawi się później

Ten krok nie ma jeszcze wideo. Instrukcja i polecenie MCP są już dostępne.

Wartości gracza na serwerze

Przygotuj ten sam projekt

  1. Wybierz w panelu ten sam projekt co w konfiguracji gry.

    Kody Podarunkowe →
  2. Utwórz lub wykorzystaj te wpisy testowe w formularzu panelu. To wartości przykładowe, nie aktualne dane projektu.

    Kod
    WELCOME
    Dane Prezentu (JSON)
    {}
    Maks. na Użytkownika
    1

    Serwer przyznaje do ośmiu skonfigurowanych wartości przy realizacji kodu. giftData pozostaje osobnymi danymi gry. Wyświetl zwrócone saldo bez ponownego dodawania nagrody lokalnie.

    Wartości gracza →
  3. Zapisz, wczytaj ponownie i sprawdź wpisy przed uruchomieniem przykładu. Zachowaj pozostałe definicje.

Dodaj tę funkcję

Możesz przeglądać poradnik. Uruchomienie wymaga aktywnego klucza projektu. Przygotuj projekt

Zainstalowany SDK, zaimportowana konfiguracja projektu i zalogowany gracz.

Serwer przyznaje do ośmiu skonfigurowanych wartości przy realizacji kodu. giftData pozostaje osobnymi danymi gry. Wyświetl zwrócone saldo bez ponownego dodawania nagrody lokalnie. Ten przykład SDK korzysta z develop. Sprawdź, czy wymagane API istnieją w zainstalowanym SDK.

Zapisz plik C#, przypnij do GameObject i uruchom Play. Sprawdź Console.

C#
Assets/Scripts/GiftCodesDemo.cs
Wywołanie horizOnPrzygotowanie
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Dodaj ten skrypt do obiektu GameObject w pierwszej scenie.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Przygotowanie: inicjalizacja, połączenie i logowanie gracza.
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: sprawdź kod upominkowy i go zrealizuj.
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}
Otwórz pełny przykład SDK ↗

Przetestuj nową funkcję.

Kod testowy zostaje zrealizowany. Ponowna realizacja podlega twoim zasadom.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Wszystkie punkty końcowe w dokumentacji API
Ilustracja funkcji Rankingi
Nasza propozycja następnego kroku

Daj każdej rundzie najlepszy wynik.

Zapisz wynik po rundzie i pokaż, kto prowadzi. Nadal korzystaj z połączenia i sesji gracza.