A tua próxima funcionalidade

Amigos

Amigos, pedidos e bloqueios do projeto selecionado.

SDK: developRequer uma sessão de jogador

Unity

O resultado visível

Após timeout ou conflito, atualize e reveja a intenção. Nunca repita automaticamente com nova revisão.

Vídeo em breve

Este passo ainda não tem vídeo. O guia e o pedido MCP já podem ser usados.

Amigos

Preparar o mesmo projeto

Seleciona no painel o mesmo projeto que na configuração do teu jogo.
Amigos →
O primeiro pedido não exige outra definição. Um resultado vazio é válido enquanto faltarem dados do jogo.
Usem duas sessões distintas no mesmo projeto. Copiem o UUID exato do outro jogador da gestão de utilizadores.
Use um UUID exato ou código H canónico. Nomes e emails não são aceites.
Apenas consulta; só a sessão do próprio jogador altera relações.

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

Concluam a ligação do início rápido com o jogador escolhido. Chamem RunReviewedAction() através de um botão ou ação explícita da cena. Abrir o ficheiro não envia pedidos.

Assets/Scripts/FriendsDemo.cs

Chamada ao 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// Após timeout ou conflito, atualize e reveja a intenção. Nunca repita

8// automaticamente com nova revisão.

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}

Abrir o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

Após timeout ou conflito, atualize e reveja a intenção. Nunca repita automaticamente com nova revisão.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Verificar no painel Encontrar outro objetivo de jogo

Endpoints da 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

Todos os endpoints na referência da API

Documentação e dashboard

Ler a documentação

A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.

Criar uma classificação Integrar com um agente MCP

Conserva todo o progresso.Salvamento na Nuvem · Código e pedido MCP

Ajusta o jogo enquanto os jogadores continuam a jogar.Config Remota · Código e pedido MCP