A tua próxima funcionalidade

Grupos

Guildas, clãs e equipas com funções para o projeto selecionado.

SDK: developRequer uma sessão de jogador

Unity

O resultado visível

Após timeout ou conflito, guarde a intenção original e leia o estado atual. Nunca repita automaticamente com outra revisão.

Vídeo em breve

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

Grupos

Preparar o mesmo projeto

Seleciona no painel o mesmo projeto que na configuração do teu jogo.
Grupos →
O primeiro pedido não exige outra definição. Um resultado vazio é válido enquanto faltarem dados do jogo.
Os grupos são criados e geridos no jogo.
Este primeiro exemplo lê dados. Não cria grupos, partidas nem objetos. Uma lista vazia é uma primeira resposta válida.

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 ReadMyGroups() através de um botão ou ação explícita da cena. Abrir o ficheiro não envia pedidos.

Assets/Scripts/GroupsDemo.cs

Chamada ao horizOn

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.

Abrir o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

Após timeout ou conflito, guarde a intenção original e leia o estado atual. Nunca repita automaticamente com outra 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/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

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