Ide dan fitur game

Fitur berikutnya

Kode Hadiah

Izinkan pemain memasukkan dan menukarkan kode hadiah.

Memerlukan sesi pemain
Godot
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 GDScript, pasangkan ke simpul adegan utama, lalu jalankan. Periksa Output.

GDScript
res://scripts/gift_codes.gd
Panggilan horizOnPersiapan
1# Pasang skrip ini pada sebuah node di adegan utamamu.
2extends Node
3​
4​
5func _ready() -> void:
6 # Persiapan: inisialisasi, hubungkan, dan masukkan seorang pemain.
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn: validasi kode hadiah lalu tukarkan.
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
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.