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

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

Проверенные действия

Проверяйте игровые действия на сервере.

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

Допустимое действие принимается, а недопустимое отклоняется.

Проверять игровые действия3:12

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

Открыть видео отдельно ↗

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

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

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

    Ключ (slug)
    weekly
    Принимать результаты только из проверенных забегов
    true
    Максимальный результат
    20000
    Минимальная длительность (секунды)
    0
    Этап обязателен
    false

    Сохраните эти правила в тестовом проекте без других ограничений. Фиксированные байты quickstart проверяют протокол. Счёт 18250 должен приниматься. Начните новый забег с 20001 для проверки отказа. В игре записывайте реальные действия.

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

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

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

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

Этот пример SDK использует develop. Проверьте наличие нужных API в установленном SDK.

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

C#
Assets/Scripts/ValidatedActionsDemo.cs
Вызов horizOnПодготовка
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Прикрепи этот скрипт к GameObject в первой сцене.
6public class ValidatedActionsDemo : 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 byte[] inputLog = System.Text.Encoding.UTF8.GetBytes("quickstart");
22​
23 // horizOn: начать забег, записать ввод, отправить проверенный
24 // результат.
25 // 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
26 var va = ValidatedActionsManager.Instance;
27​
28 // 2. Round start: single-use ticket plus server seed
29 var run = await va.StartRun("weekly");
30 if (run == null) { Debug.Log(va.LastErrorCode); return; } // e.g. RUN_RATE_LIMITED
31 var random = new System.Random(run.seed);
32​
33 // Protocol test input only. Replace it with actual recorded game inputs in your game.
34​
35 // 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
36 var result = await va.SubmitValidated(18250, inputLog);
37 if (result == null)
38 {
39 Debug.Log($"{va.LastErrorCode}, run kept: {va.HasActiveRun}");
40 return;
41 }
42 Debug.Log($"Accepted score={result.score}, rank={result.rank}");
43 }
44}
Открыть полный пример SDK ↗

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

Допустимое действие принимается, а недопустимое отклоняется.

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

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

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

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

Обучающее видео

Проверенные действияUnity3:28

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

Открыть видео отдельно ↗
Значения, управляемые серверомUnity4:44

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

Открыть видео отдельно ↗
Журнал вводаUnity5:13

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

Открыть видео отдельно ↗