Euer nächstes Feature

Gruppen

Gilden, Clans und Teams mit Rollen für das ausgewählte Projekt.

SDK: developSpielersession erforderlich

Unity

Euer sichtbares Ergebnis

Nach Timeout oder Konflikt die ursprüngliche Aktion behalten und den aktuellen Stand lesen. Niemals automatisch mit neuer Revision wiederholen.

Video folgt

Für diesen Schritt fehlt noch das Video. Die Anleitung und der MCP-Auftrag sind bereits nutzbar.

Gruppen

Dasselbe Projekt vorbereiten

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.
Gruppen →
Für die erste Anfrage ist keine weitere Definition nötig. Ein leeres Ergebnis ist gültig, solange passende Spieldaten fehlen.
Gruppen werden im Spiel erstellt und verwaltet.
Dieses erste Beispiel liest Daten. Es erstellt keine Gruppe, keinen Match und kein Objekt. Eine leere Liste ist eine gültige erste Antwort.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Dieses SDK-Beispiel nutzt develop. Prüft, ob die nötigen APIs in eurem installierten SDK verfügbar sind.

Verbindet zuerst den vorgesehenen Spieler über den Schnellstart. Ruft ReadMyGroups() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

Assets/Scripts/GroupsDemo.cs

horizOn-Aufruf

1using UnityEngine;

2using PM.horizOn.Cloud.Manager;

4public sealed class GroupsDemo : MonoBehaviour

6 // Initialize/connect once and restore the existing player in the Quickstart first.

7 // Invoke from a player action; no background refresh or membership mutation.

8 public async void ReadMyGroups()

9 {

10 var user = UserManager.Instance.CurrentUser;

11 if (user == null || !user.IsValid()) return;

12 var result = await GroupsManager.Instance.GetGroups(user.UserId);

13 if (!result.IsSuccess) { Debug.LogWarning(result.ErrorCode); return; }

14 Debug.Log($"Player revision: {result.Data.revision}");

15 foreach (var group in result.Data.groups)

16 Debug.Log($"Group {group.id}: {group.myRole}, revision {group.revision}");

17 // result.Data.limits contains all current limits; existing groups may exceed them.

18 // GetMembers(userId, groupId, afterUserId: null, limit: 1) reads one page.

19 // Keep its revision and nextAfterUserId. A changed revision requires a restart.

20 // Pending createdAt may be absent/null; it does not mean the Unix epoch.

21 }

22}

23// For writes use the SDK GroupsExample and its durable GroupsSampleStore.

24// Preserve the exact project/player, body, expected revision and pending requestId.

25// Unknown create: read/reconcile explicitly; never create with a replacement revision.

Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Nach Timeout oder Konflikt die ursprüngliche Aktion behalten und den aktuellen Stand lesen. Niemals automatisch mit neuer Revision wiederholen.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Im Dashboard prüfen Ein weiteres Spielziel finden

Endpunkte

GET/groups
GET/groups/{groupId}
GET/groups/{groupId}/members
GET/groups/{groupId}/pending
POST/groups
PUT/groups/{groupId}
POST/groups/{groupId}/join
POST/groups/{groupId}/request
POST/groups/{groupId}/invite
POST/groups/{groupId}/accept-invite
POST/groups/{groupId}/decline-invite
POST/groups/{groupId}/cancel-invite
POST/groups/{groupId}/accept-request
POST/groups/{groupId}/decline-request
POST/groups/{groupId}/cancel-request
POST/groups/{groupId}/leave
POST/groups/{groupId}/remove
POST/groups/{groupId}/role
POST/groups/{groupId}/transfer
POST/groups/{groupId}/delete

Alle Endpunkte in der API-Referenz

Doku und Dashboard

Doku lesen

Unser Vorschlag für den nächsten Schritt

Gebt jeder Runde einen Highscore.

Speichert den Score nach dem Spiel und zeigt, wer vorne liegt. Eure Verbindung und Spielersession nutzt ihr weiter.

Leaderboard einbauen Mit MCP-Agent umsetzen

Fortschritt sicher nach Hause bringen.Cloud-Speicher · Code & MCP-Auftrag

Balancing ändern. Spiel weiterlaufen lassen.Remote-Konfig · Code & MCP-Auftrag