Oyun fikirleri ve özellikleri

Sıradaki özelliğin

Hediye Kodları

Oyuncuların hediye kodlarını girip kullanmasını sağla.

Oyuncu oturumu gerekli
Unity
Hediye Kodları görseli
Görünür sonuç

Test kodu kullanılır. Tekrar kullanım, kurallarına göre değerlendirilir.

Bir hediye kodu oluşturun1:42

Bu eğitim İngilizce oynatılır.

Videoyu ayrı aç ↗
Video yakında

Bu adımın videosu henüz yok. Rehber ve MCP isteği kullanıma hazır.

Sunucudaki oyuncu değerleri

Aynı projeyi hazırlayın

  1. Panelde oyun yapılandırmandaki projeyle aynı projeyi seç.

    Hediye Kodları →
  2. Bu test kayıtlarını panel formunda oluşturun veya mevcut olanları kullanın. Bunlar örnek değerlerdir, güncel proje verileri değildir.

    Kod
    WELCOME
    Hediye Verisi (JSON)
    {}
    Kullanıcı Başına Maks.
    1

    Sunucu kullanım sırasında en fazla sekiz yapılandırılmış değeri verir. giftData ayrı oyun verisi olarak kalır. Dönen bakiyeyi gösterin; ödülü yerelde tekrar eklemeyin.

    Oyuncu değerleri →
  3. Örneği çalıştırmadan önce kaydedin, yeniden yükleyin ve doğrulayın. Diğer tanımları koruyun.

Bu özelliği ekle

Kılavuzu inceleyebilirsin. Çalıştırmak için etkin bir proje anahtarı gerekir. Projeyi hazırla

SDK kurulu, proje yapılandırması içe aktarılmış ve oyuncu oturum açmış olmalı.

Sunucu kullanım sırasında en fazla sekiz yapılandırılmış değeri verir. giftData ayrı oyun verisi olarak kalır. Dönen bakiyeyi gösterin; ödülü yerelde tekrar eklemeyin. Bu SDK örneği develop kullanır. Gerekli API'lerin kurulu SDK sürümünde bulunduğunu kontrol et.

C# dosyasını kaydedip GameObject nesnesine ekleyin ve Play başlatın. Console bölümünü kontrol edin.

C#
Assets/Scripts/GiftCodesDemo.cs
horizOn çağrısıHazırlık
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Bu betiği ilk sahnendeki bir GameObject'e ekle.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Hazırlık: başlat, bağlan ve bir oyuncunun oturumunu aç.
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: hediye kodunu doğrula ve kullan.
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}
Tam SDK örneğini aç ↗

Yeni özelliğini test et.

Test kodu kullanılır. Tekrar kullanım, kurallarına göre değerlendirilir.

Panelde oyun yapılandırmandaki projeyle aynı projeyi seç.

Uç noktalar
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
API referansındaki tüm uç noktalar
Skor Tabloları görseli
Sıradaki adım için önerimiz

Her tura bir yüksek puan ekle.

Turdan sonra puanı kaydet ve kimin önde olduğunu göster. Bağlantını ve oyuncu oturumunu kullanmaya devam et.