Ide dan fitur game

Fitur berikutnya

Kode Hadiah

Izinkan pemain memasukkan dan menukarkan kode hadiah.

Memerlukan sesi pemain
Unity
Ilustrasi Kode Hadiah
Hasil yang terlihat

Kode uji ditukarkan. Penukaran ulang mengikuti aturanmu.

Buat kode hadiah1:42

Tutorial ini diputar dalam bahasa Inggris.

Buka video terpisah ↗
Video akan tersedia

Langkah ini belum memiliki video. Panduan dan permintaan MCP sudah dapat digunakan.

Nilai pemain di server

Siapkan proyek yang sama

  1. Pilih proyek yang sama di dasbor dan konfigurasi game.

    Kode Hadiah →
  2. Buat atau gunakan kembali entri uji ini pada formulir dasbor. Nilai ini adalah contoh, bukan data proyek saat ini.

    Kode
    WELCOME
    Data Hadiah (JSON)
    {}
    Maks. Per Pengguna
    1

    Server memberikan hingga delapan nilai yang dikonfigurasi saat penukaran. giftData tetap menjadi data game terpisah. Tampilkan saldo yang dikembalikan tanpa menambahkan hadiah lagi secara lokal.

    Nilai pemain →
  3. Simpan, muat ulang, dan periksa entri sebelum menjalankan contoh. Pertahankan definisi lain.

Tambahkan fitur ini

Kamu dapat membaca panduan. Untuk menjalankannya, diperlukan kunci proyek aktif. Siapkan proyek

SDK terpasang, konfigurasi proyek diimpor, dan pemain sudah masuk.

Server memberikan hingga delapan nilai yang dikonfigurasi saat penukaran. giftData tetap menjadi data game terpisah. Tampilkan saldo yang dikembalikan tanpa menambahkan hadiah lagi secara lokal. Contoh SDK ini menggunakan develop. Periksa apakah API yang diperlukan tersedia di SDK yang terpasang.

Simpan berkas C#, pasangkan ke GameObject, lalu mulai Play. Periksa Console.

C#
Assets/Scripts/GiftCodesDemo.cs
Panggilan horizOnPersiapan
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Pasang skrip ini pada sebuah GameObject di adegan pertamamu.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Persiapan: inisialisasi, hubungkan, dan masukkan seorang pemain.
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: validasi kode hadiah lalu tukarkan.
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}
Buka contoh SDK lengkap ↗

Uji fitur barumu.

Kode uji ditukarkan. Penukaran ulang mengikuti aturanmu.

Pilih proyek yang sama di dasbor dan konfigurasi game.

Titik akhir
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Semua titik akhir di referensi API
Ilustrasi Papan Peringkat
Saran kami untuk langkah berikutnya

Berikan skor tertinggi untuk setiap ronde.

Simpan skor setelah ronde dan tampilkan siapa yang unggul. Tetap gunakan koneksi dan sesi pemainmu.