Pomysły i funkcje gry

Twoja następna funkcja

Skrzynka gracza

Powiadomienia osobiste i ogłoszenia projektu z chronionymi nagrodami oraz jednym odpytywaniem dla wiadomości społecznościowych.

SDK: developWymagana sesja gracza
Godot
Ilustracja funkcji Skrzynka gracza
Widoczny rezultat

Gra wyświetla wiadomości i ogłoszenia, oznacza je jako przeczytane i odbiera każdą chronioną nagrodę najwyżej raz.

Wideo pojawi się później

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

Skrzynka gracza

Przygotuj ten sam projekt

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

    Skrzynka gracza →
  2. Pierwsze żądanie nie wymaga dodatkowej definicji. Pusty wynik jest poprawny, dopóki nie powstaną odpowiednie dane gry.

    Zarejestruj gracza testowego przed publikacją tekstowej wiadomości zbiorczej w projekcie. Odczytaj skrzynkę tym samym graczem.

    Ogłoszenie trafia do aktualnie aktywnych graczy projektu zarejestrowanych najpóźniej w chwili publikacji. Nieaktywni wcześniej gracze mogą kwalifikować się po reaktywacji. Późniejsze rejestracje są wykluczone.

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/inbox.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.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var loaded: Dictionary = await Horizon.inbox.getInbox(user_id, "")
10 if not loaded.success:
11 push_error(loaded.errorCode)
12 return
13 for entry in loaded.data.entries:
14 print(entry.textKey)
15 # The SDK materializes unchanged responses from its project/player cache.
16 # Respect loaded.data.pollAfterSeconds and stop refreshing with the game lifecycle.
17​
18 var claim_state := {"busy": false}
19 var claim_selected = func(entry_id: String) -> void:
20 if claim_state.busy:
21 return
22 var project_id := "YOUR_PROJECT_ID"
23 var path := "user://inbox_claim_" + project_id + "_" + user_id + ".txt"
24 if FileAccess.file_exists(path):
25 var previous := FileAccess.open(path, FileAccess.READ)
26 if previous == null:
27 return
28 var pending := previous.get_as_text()
29 previous.close()
30 if pending != entry_id:
31 return # Resolve the original claim first.
32 else:
33 var current: Dictionary = Horizon.inbox.getCurrentInbox()
34 if current.get("userId", "") != user_id:
35 return
36 var selected: Dictionary = {}
37 for entry in current.get("entries", []):
38 if entry.id == entry_id:
39 selected = entry
40 break
41 if selected.is_empty() or selected.claimed:
42 return
43 var attachment = selected.get("attachment")
44 if not attachment is Dictionary or attachment.get("values", []).is_empty():
45 return
46 # An existing identical pending ID bypasses this new-selection guard for safe replay.
47 var file := FileAccess.open(path, FileAccess.WRITE)
48 if file == null:
49 return
50 file.store_string(entry_id)
51 file.flush()
52 var saved_ok := file.get_error() == OK
53 file.close()
54 if not saved_ok:
55 return
56 claim_state.busy = true
57 var claimed: Dictionary = await Horizon.inbox.claim(user_id, entry_id)
58 claim_state.busy = false
59 if not claimed.success:
60 push_error(claimed.errorCode)
61 return
62 # Display claimed.data.inbox and replace values with claimed.data.playerValues.
63 # Never add the reward delta locally.
64 var current := FileAccess.open(path, FileAccess.READ)
65 if current != null:
66 var still_pending := current.get_as_text() == entry_id
67 current.close()
68 if still_pending:
69 DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
70 # Bind claim_selected to an explicit player action; do not claim automatically.
71 # Retry the same saved entry_id after an uncertain response.
72 # Other deliberate actions: await Horizon.inbox.markRead(user_id, entry_id)
73 # await Horizon.inbox.remove(user_id, entry_id) # Protects unclaimed rewards.
Otwórz pełny przykład SDK ↗

Przetestuj nową funkcję.

Gra wyświetla wiadomości i ogłoszenia, oznacza je jako przeczytane i odbiera każdą chronioną nagrodę najwyżej raz.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • GET/inbox
  • POST/inbox/read
  • POST/inbox/claim
  • POST/inbox/remove
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.