Pomysły i funkcje gry

Twoja następna funkcja

Zweryfikowane akcje

Zleć serwerowi sprawdzanie działań w grze.

SDK: developWymagana sesja gracza
Unity
Ilustracja funkcji Zweryfikowane akcje
Widoczny rezultat

Prawidłowe działanie zostaje zaakceptowane, a nieprawidłowe odrzucone.

Weryfikuj działania w grze3:12

Ten samouczek jest odtwarzany po angielsku.

Otwórz wideo osobno ↗

Przygotuj ten sam projekt

  1. Wybierz w panelu ten sam projekt co w konfiguracji gry.

    Zweryfikowane akcje →
  2. Utwórz lub wykorzystaj te wpisy testowe w formularzu panelu. To wartości przykładowe, nie aktualne dane projektu.

    Klucz (slug)
    weekly
    Przyjmuj wyniki tylko ze zweryfikowanych rozgrywek
    true
    Maksymalny wynik
    20000
    Minimalny czas trwania (sekundy)
    0
    Wymagaj etapu
    false

    Zapisz te reguły w projekcie testowym bez innych limitów. Stałe bajty quickstart testują protokół. Wynik 18250 powinien zostać przyjęty. Rozpocznij nową rundę z 20001, aby sprawdzić odrzucenie. W grze rejestruj rzeczywiste wejście.

    Ranking →
  3. Zapisz, wczytaj ponownie i sprawdź wpisy przed uruchomieniem przykładu. Zachowaj pozostałe definicje.

Dodaj tę funkcję

Możesz przeglądać poradnik. Uruchomienie wymaga aktywnego klucza projektu. Przygotuj projekt

Zainstalowany SDK, zaimportowana konfiguracja projektu i zalogowany gracz.

Ten przykład SDK korzysta z develop. Sprawdź, czy wymagane API istnieją w zainstalowanym SDK.

Zapisz plik C#, przypnij do GameObject i uruchom Play. Sprawdź Console.

C#
Assets/Scripts/ValidatedActionsDemo.cs
Wywołanie horizOnPrzygotowanie
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// Dodaj ten skrypt do obiektu GameObject w pierwszej scenie.
6public class ValidatedActionsDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // Przygotowanie: inicjalizacja, połączenie i logowanie gracza.
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: rozpocznij rozgrywkę, zapisz wejścia, wyślij
24 // zweryfikowany wynik.
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}
Otwórz pełny przykład SDK ↗

Przetestuj nową funkcję.

Prawidłowe działanie zostaje zaakceptowane, a nieprawidłowe odrzucone.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Wszystkie punkty końcowe w dokumentacji API
Ilustracja funkcji Rankingi
Nasza propozycja następnego kroku

Daj każdej rundzie najlepszy wynik.

Zapisz wynik po rundzie i pokaż, kto prowadzi. Nadal korzystaj z połączenia i sesji gracza.

Film instruktażowy

Zweryfikowane akcjeUnity3:28

Ten samouczek jest odtwarzany po angielsku.

Otwórz wideo osobno ↗
Wartości zarządzane przez serwerUnity4:44

Ten samouczek jest odtwarzany po angielsku.

Otwórz wideo osobno ↗
Log wejściaUnity5:13

Ten samouczek jest odtwarzany po angielsku.

Otwórz wideo osobno ↗