Euer nächstes Feature

Freunde

Freunde, Anfragen und Blockierungen im ausgewählten Projekt.

SDK: developSpielersession erforderlich

Unity

Euer sichtbares Ergebnis

Nach Timeout oder Konflikt neu laden und die Absicht prüfen. 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.

Freunde

Dasselbe Projekt vorbereiten

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.
Freunde →
Für die erste Anfrage ist keine weitere Definition nötig. Ein leeres Ergebnis ist gültig, solange passende Spieldaten fehlen.
Verwendet zwei getrennte Spielersitzungen im selben Projekt. Kopiert die exakte UUID des anderen Spielers aus der Benutzerverwaltung.
Exakte UUID oder kanonischen H-Code verwenden. Namen und E-Mails werden nicht akzeptiert.
Hier nur prüfen; Beziehungen ändert ausschließlich die eigene Spielersitzung.

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 RunReviewedAction() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

Assets/Scripts/FriendsDemo.cs

horizOn-Aufruf

1using UnityEngine;

2using PM.horizOn.Cloud.Core;

3using PM.horizOn.Cloud.Manager;

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

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

7// Nach Timeout oder Konflikt neu laden und die Absicht prüfen. Niemals

8// automatisch mit neuer Revision wiederholen.

9public sealed class FriendsDemo : MonoBehaviour

10{

11 public async void RunReviewedAction()

12 {

13 var sessionUser = UserManager.Instance.CurrentUser;

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

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

16 var manager = FriendsManager.Instance;

17 var loaded = await manager.GetFriends(userId);

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

19 Debug.Log(loaded.Data.friendCode); // Public identifier, not a credential.

20 foreach (var friend in loaded.Data.friends)

21 Debug.Log(friend.display.name + ": " + (friend.lastActiveAt ?? "unknown"));

23 // Invoke only after the player explicitly reviews this snapshot and chooses an action.

24 async System.Threading.Tasks.Task ApplyReviewed(string action, string targetUserId,

25 long expectedRevision, string requestId = null)

26 {

27 var result = action switch {

28 "request" => await manager.SendRequest(userId, targetUserId, expectedRevision),

29 "accept" => await manager.AcceptRequest(userId, targetUserId, expectedRevision, requestId),

30 "decline" => await manager.DeclineRequest(userId, targetUserId, expectedRevision, requestId),

31 "cancel" => await manager.CancelRequest(userId, targetUserId, expectedRevision, requestId),

32 "remove" => await manager.RemoveFriend(userId, targetUserId, expectedRevision),

33 "block" => await manager.BlockPlayer(userId, targetUserId, expectedRevision),

34 "unblock" => await manager.UnblockPlayer(userId, targetUserId, expectedRevision),

35 _ => throw new System.ArgumentException("Unknown action")

36 };

37 if (!result.IsSuccess) {

38 Debug.LogWarning(result.ErrorCode); // Timeout/409: reload and reconcile; do not repeat automatically.

39 return;

40 }

41 Debug.Log(result.Data.revision); // Replace the whole displayed snapshot.

42 }

43 // Accept/decline: original incoming requestId. Cancel: original outgoing requestId.

44 // Never replace expectedRevision on an uncertain retry. A new request is a new identity.

45 // FindPlayer(userId, exactUuidOrHCode) never searches names or emails.

46 // Last login is nullable, never an online flag. No hidden polling timer.

47 }

48}

Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Nach Timeout oder Konflikt neu laden und die Absicht prüfen. 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/friends
GET/friends/find
POST/friends/request
POST/friends/accept
POST/friends/decline
POST/friends/cancel
POST/friends/remove
POST/friends/block
POST/friends/unblock

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