Идеи и функции для игры

Ваша следующая функция

Подарочные Коды

Разрешите игрокам вводить и активировать подарочные коды.

Требуется сессия игрока
Unity
Иллюстрация функции «Подарочные Коды»
Видимый результат

Тестовый код активирован. Повторная активация следует вашим правилам.

Создание подарочного кода1:42

Этот урок воспроизводится на английском.

Открыть видео отдельно ↗
Видео появится позже

Для этого шага пока нет видео. Инструкция и запрос MCP уже доступны.

Значения игрока на сервере

Подготовьте тот же проект

  1. Выберите в панели тот же проект, что указан в конфигурации игры.

    Подарочные Коды →
  2. Создайте или используйте эти тестовые записи в форме панели. Это примеры значений, а не текущие данные проекта.

    Код
    WELCOME
    Данные Подарка (JSON)
    {}
    Макс. на Пользователя
    1

    Сервер начисляет до восьми настроенных значений при активации. giftData остаётся отдельными данными игры. Показывайте полученный баланс, не прибавляя награду повторно локально.

    Значения игрока →
  3. Сохраните, загрузите заново и проверьте записи до запуска примера. Сохраните остальные определения.

Добавьте эту функцию

Вы можете просмотреть руководство. Для выполнения нужен активный ключ проекта. Подготовить проект

SDK установлен, конфигурация проекта импортирована, игрок вошёл в систему.

Сервер начисляет до восьми настроенных значений при активации. giftData остаётся отдельными данными игры. Показывайте полученный баланс, не прибавляя награду повторно локально. Этот пример SDK использует develop. Проверьте наличие нужных API в установленном SDK.

Сохраните файл C#, добавьте к GameObject и запустите Play. Проверьте Console.

C#
Assets/Scripts/GiftCodesDemo.cs
Вызов horizOnПодготовка
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Прикрепи этот скрипт к GameObject в первой сцене.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Подготовка: инициализация, подключение и вход игрока.
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: проверить подарочный код и активировать его.
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}
Открыть полный пример SDK ↗

Проверьте новую функцию.

Тестовый код активирован. Повторная активация следует вашим правилам.

Выберите в панели тот же проект, что указан в конфигурации игры.

Эндпоинты
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Все эндпоинты в справочнике API
Иллюстрация функции «Рейтинги»
Наше предложение для следующего шага

Добавьте рекорд для каждого раунда.

Сохраняйте результат после раунда и показывайте лидеров. Продолжайте использовать подключение и сессию игрока.