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

Unity

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

Wybierz w panelu ten sam projekt co w konfiguracji gry.
Skrzynka gracza →
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 RunReviewedAction() jawnym przyciskiem lub akcją sceny. Samo otwarcie pliku nie wysyła żądania.

Assets/Scripts/InboxDemo.cs

Wywołanie horizOn

1using PM.horizOn.Cloud.Objects.Network.Responses;

2using UnityEngine;

3using PM.horizOn.Cloud.Core;

4using PM.horizOn.Cloud.Manager;

6// Existing SDK/project configuration and authenticated player session required.

7// Call RunReviewedAction explicitly after reviewing this example and its data.

8// Używaj uwierzytelnionej sesji bieżącego gracza. Ponawiaj niepewny odbiór

9// z tym samym ID wpisu. Zastępuj stan odpowiedzią serwera; nie dodawaj

10// nagrody ponownie.

11public sealed class InboxDemo : MonoBehaviour

12{

13 public async void RunReviewedAction()

14 {

15 var sessionUser = UserManager.Instance.CurrentUser;

16 if (sessionUser == null || !sessionUser.IsValid()) return;

17 var userId = UserManager.Instance.CurrentUser.UserId;

18 var manager = InboxManager.Instance;

19 var loaded = await manager.GetInbox(userId, since: null);

20 if (!loaded.IsSuccess) { Debug.LogWarning(loaded.ErrorCode); return; }

21 foreach (var entry in loaded.Data.entries) Debug.Log(entry.textKey);

22 // The manager retains full cached entries when the wire response is unchanged.

23 // Poll again only after loaded.Data.pollAfterSeconds, and stop with the game lifecycle.

25 bool claimInFlight = false;

26 async System.Threading.Tasks.Task ClaimSelectedReward(string entryId)

27 {

28 if (claimInFlight) return;

29 const string projectId = "YOUR_PROJECT_ID";

30 string pendingKey = "horizOn_inbox_claim_" + projectId + "_" + userId;

31 string pending = PlayerPrefs.GetString(pendingKey, "");

32 if (pending.Length > 0 && pending != entryId) return; // Resolve the original claim first.

33 if (pending.Length == 0)

34 {

35 var current = manager.CurrentInbox; // Authorized for the current project/session.

36 if (current == null || current.userId != userId) return;

37 var selected = System.Array.Find(current.entries, entry => entry.id == entryId);

38 if (selected == null || selected.claimed || selected.attachment?.values == null ||

39 selected.attachment.values.Length == 0) return;

40 }

41 // Previously saved IDs remain replayable even after their visible state changes.

42 PlayerPrefs.SetString(pendingKey, entryId);

43 PlayerPrefs.Save();

44 if (PlayerPrefs.GetString(pendingKey) != entryId) return;

45 claimInFlight = true;

46 try

47 {

48 var claimed = await manager.Claim(userId, entryId);

49 if (!claimed.IsSuccess) { Debug.LogWarning(claimed.ErrorCode); return; }

50 // Display claimed.Data.inbox and replace values with claimed.Data.playerValues.

51 // The SDK refreshes its cache. Never add reward deltas yourself.

52 if (PlayerPrefs.GetString(pendingKey, "") == entryId)

53 {

54 PlayerPrefs.DeleteKey(pendingKey);

55 PlayerPrefs.Save();

56 }

57 }

58 finally { claimInFlight = false; }

59 }

60 // Invoke ClaimSelectedReward only from an explicit player action.

61 // Retry the saved entryId after a lost response; no replacement grant or new action ID.

62 // Other deliberate actions: await manager.MarkRead(userId, entryId);

63 // await manager.Remove(userId, entryId); // Protects unclaimed rewards.

64 }

65}

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.

Sprawdź w panelu Znajdź kolejny cel gry

Punkty końcowe

GET/inbox
POST/inbox/read
POST/inbox/claim
POST/inbox/remove

Wszystkie punkty końcowe w dokumentacji API

Dokumentacja i dashboard

Przeczytaj dokumentację

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.

Dodaj ranking Dodaj z agentem MCP

Zachowaj wszystkie postępy.Zapis w Chmurze · Kod i żądanie MCP

Dostosuj grę, gdy gracze nadal grają.Konfig. Zdalna · Kod i żądanie MCP