Je volgende functie

Spelerinbox

Persoonlijke meldingen en projectberichten, met beschermde beloningen en één aanvraag voor sociale berichten.

SDK: developSpelerssessie vereist

Unity

Je zichtbare resultaat

Je spel toont persoonlijke en projectberichten, markeert ze als gelezen en haalt elke beschermde beloning hoogstens één keer op.

Video volgt

Voor deze stap is nog geen video. De handleiding en MCP-opdracht zijn al bruikbaar.

Spelerinbox

Hetzelfde project voorbereiden

Kies in het dashboard hetzelfde project als in de configuratie van je spel.
Spelerinbox →
Voor het eerste verzoek is geen extra definitie nodig. Een leeg resultaat is geldig zolang bijpassende spelgegevens ontbreken.
Registreer de testspeler voordat je in dit project een tekstbericht uitzendt. Lees de inbox met dezelfde speler.
Het bericht bereikt momenteel actieve projectspelers die uiterlijk bij publicatie waren geregistreerd. Eerder inactieve spelers kunnen na heractivering in aanmerking komen. Latere registraties zijn uitgesloten.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

Dit SDK-voorbeeld gebruikt develop. Controleer of de benodigde API's in je geïnstalleerde SDK bestaan.

Voltooi de Quickstart-verbinding met de bedoelde speler. Roep RunReviewedAction() expliciet aan via een knop of scèneactie. Alleen het bestand openen verstuurt geen verzoek.

Assets/Scripts/InboxDemo.cs

horizOn-aanroep

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// Gebruik de aangemelde sessie van de huidige speler. Herhaal een onzekere

9// claim met dezelfde bericht-ID. Vervang waarden door de serverstatus; pas

10// een beloning nooit dubbel toe.

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}

Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Je spel toont persoonlijke en projectberichten, markeert ze als gelezen en haalt elke beschermde beloning hoogstens één keer op.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Controleren in het dashboard Een ander speldoel vinden

Eindpunten

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

Alle eindpunten in de API-referentie

Documentatie en dashboard

Documentatie lezen

Onze suggestie voor je volgende stap

Geef elke ronde een topscore.

Sla de score na een ronde op en laat zien wie vooropstaat. Blijf je verbinding en de sessie van de speler gebruiken.

Een ranglijst bouwen Bouwen met een MCP-agent

Bewaar alle voortgang.Cloud Opslag · Code en MCP-verzoek

Pas je spel aan terwijl spelers doorspelen.Externe Config · Code en MCP-verzoek