Votre prochaine fonctionnalité

Amis

Amis, demandes et blocages du projet sélectionné.

SDK : developSession de joueur requise

Unity

Votre résultat visible

Après délai dépassé ou conflit, rechargez et vérifiez l’intention. Ne réessayez jamais avec une nouvelle révision automatiquement.

Vidéo à venir

Cette étape n’a pas encore de vidéo. Le guide et la demande MCP sont utilisables.

Amis

Préparer le même projet

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.
Amis →
Aucune définition supplémentaire pour la première requête. Un résultat vide est valide tant que les données du jeu manquent.
Utilisez deux sessions distinctes du même projet. Copiez l’UUID exact de l’autre joueur depuis la gestion des utilisateurs.
Utilisez un UUID exact ou un code H canonique, sans nom ni courriel.
Consultation uniquement ; seule la session du joueur modifie les relations.

Intégrer cette fonctionnalité

Vous pouvez consulter le guide. Son exécution nécessite une clé de projet active. Préparer le projet

SDK installé, configuration du projet importée et joueur connecté.

Cet exemple du SDK utilise develop. Vérifiez que les API nécessaires existent dans votre SDK installé.

Terminez la connexion du démarrage rapide avec le joueur choisi. Appelez RunReviewedAction() via un bouton ou une action de scène explicite. Ouvrir le fichier seul n’envoie aucune requête.

Assets/Scripts/FriendsDemo.cs

Appel horizOn

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// Après délai dépassé ou conflit, rechargez et vérifiez l’intention. Ne

8// réessayez jamais avec une nouvelle révision automatiquement.

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}

Ouvrir l’exemple SDK complet ↗

Testez votre nouvelle fonctionnalité.

Après délai dépassé ou conflit, rechargez et vérifiez l’intention. Ne réessayez jamais avec une nouvelle révision automatiquement.

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

Vérifier dans le tableau de bord Trouver un autre objectif de jeu

Points de terminaison

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

Tous les points de terminaison dans la référence API

Documentation et dashboard

Lire la documentation

Notre suggestion pour la suite

Donnez un meilleur score à chaque partie.

Enregistrez le score après une partie et montrez qui est en tête. Continuez avec votre connexion et la session du joueur.

Créer un classement Intégrer avec un agent MCP

Conservez toute la progression.Sauvegarde Cloud · Code et demande MCP

Ajustez votre jeu pendant que les joueurs continuent de jouer.Config Distante · Code et demande MCP