La tua prossima funzionalità

Amici

Amici, richieste e blocchi del progetto selezionato.

SDK: developSessione del giocatore richiesta

Unity

Il risultato visibile

Dopo timeout o conflitto, ricarica e verifica l’intento. Mai ritentare automaticamente con una nuova revisione.

Video in arrivo

Questo passaggio non ha ancora un video. La guida e la richiesta MCP sono già utilizzabili.

Amici

Preparare lo stesso progetto

Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.
Amici →
La prima richiesta non richiede altre definizioni. Un risultato vuoto è valido finché mancano i dati del gioco.
Usate due sessioni distinte nello stesso progetto. Copiate l’UUID esatto dell’altro giocatore dalla gestione utenti.
Usa un UUID esatto o un codice H canonico. Nomi ed email non sono accettati.
Sola lettura; solo la sessione del giocatore modifica le relazioni.

Integra questa funzionalità

Puoi consultare la guida. Per eseguirla serve una chiave di progetto attiva. Prepara il progetto

SDK installato, configurazione del progetto importata e giocatore connesso.

Questo esempio del SDK usa develop. Verifica che le API necessarie siano disponibili nel SDK installato.

Completate la connessione rapida con il giocatore scelto. Chiamate RunReviewedAction() tramite un pulsante o un’azione esplicita della scena. Aprire il file non invia richieste.

Assets/Scripts/FriendsDemo.cs

Chiamata 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// Dopo timeout o conflitto, ricarica e verifica l’intento. Mai ritentare

8// automaticamente con una nuova revisione.

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}

Aprire l’esempio SDK completo ↗

Prova la tua nuova funzionalità.

Dopo timeout o conflitto, ricarica e verifica l’intento. Mai ritentare automaticamente con una nuova revisione.

Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

Verifica nella dashboard Trova un altro obiettivo di gioco

Endpoint dell'API

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

Tutti gli endpoint nel riferimento API

Documentazione e dashboard

Leggi la documentazione

Il nostro suggerimento per il prossimo passo

Dai un record a ogni partita.

Salva il punteggio dopo una partita e mostra chi è in testa. Continua a usare la connessione e la sessione del giocatore.

Crea una classifica Integra con un agente MCP

Conserva tutti i progressi.Salvataggio Cloud · Codice e richiesta MCP

Regola il gioco mentre i giocatori continuano a giocare.Config Remota · Codice e richiesta MCP