Pomysły i funkcje gry

Twoja następna funkcja

Osiągnięcia

Klucz odblokowuje się raz na gracza. Tryb ręczny ufa grze; progi są sprawdzane w tej samej transakcji powiązanego raportu.

SDK: developWymagana sesja gracza
Godot
Ilustracja funkcji Osiągnięcia
Widoczny rezultat

Po akcji first_steps jest odblokowane dla tego samego gracza. Powtórzenie klucza nie daje kolejnego osiągnięcia ani nagrody.

Wideo pojawi się później

Ten krok nie ma jeszcze wideo. Instrukcja i polecenie MCP są już dostępne.

Osiągnięcia

Przygotuj ten sam projekt

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

    Osiągnięcia →
  2. Utwórz lub wykorzystaj te wpisy testowe w formularzu panelu. To wartości przykładowe, nie aktualne dane projektu.

    Klucz
    first_steps
    Nazwa
    First steps
    Reguła odblokowania
    manual
    Aktywne
    true
    Ukryte do odblokowania
    false
    Brak nagrody
    []

    Klucz odblokowuje się raz na gracza. Tryb ręczny ufa grze; progi są sprawdzane w tej samej transakcji powiązanego raportu.

  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.

Połącz wybranego gracza zgodnie z szybkim startem. Wywołaj run_reviewed_action() jawnym przyciskiem lub akcją sceny. Samo otwarcie pliku nie wysyła żądania.

GDScript
res://scripts/achievements.gd
Wywołanie horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5# This explicit action unlocks the shown configured achievement key.
6func run_reviewed_action() -> void:
7 if not Horizon.auth.isSignedIn():
8 return
9 var user_id: String = Horizon.auth.getCurrentUser().userId
10 var loaded: Dictionary = await Horizon.achievements.getAchievements(user_id, "")
11 if not loaded.success:
12 push_warning(loaded.errorCode)
13 return
14 for progress in loaded.data.progress:
15 print(progress.key, ": ", progress.rewardState)
16​
17 # Configure manual first_steps; invoke on the corresponding game action.
18 var unlocked: Dictionary = await Horizon.achievements.unlock(user_id, "first_steps")
19 if not unlocked.success:
20 push_warning(unlocked.errorCode) # After timeout retry the same key.
21 return
22 # Complete progress has no unlock date or pending reward payload.
23 # Values were credited atomically. Refresh playerValues when displaying balances.
24 # No Inbox claim or local value addition. Retry the original key after an uncertain reply.
Otwórz pełny przykład SDK ↗

Przetestuj nową funkcję.

Po akcji first_steps jest odblokowane dla tego samego gracza. Powtórzenie klucza nie daje kolejnego osiągnięcia ani nagrody.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • GET/achievements
  • POST/achievements/unlock
  • POST/achievements/rewards/deliver
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.