Esta página ainda não foi traduzida: mostrando a versão em inglês.
Groups
Um Group é um canal nomeado: o seu servidor envia um Event para ele, e todo Player cujo jogo entrou no Group o recebe. Use um Group para avisar todos de uma partida que a rodada começou, ou todos de um lobby que o mapa mudou, sem precisar saber quem são. O jogo entra e sai de Groups; só os seus servidores enviam para eles.
using Playserv.Wrapper;
await PlayServEvents.SubscribeGroupAsync("arena-7"); // after PlayServ.Connect()
var sub = PlayServEvents.Subscribe<RoundStarted>(e => hud.ShowRound(e.Round));
// Later
sub.Dispose();
await PlayServEvents.UnsubscribeGroupAsync("arena-7");
Como um Group funciona
| Aspecto | Como funciona |
|---|---|
| Participação | Pertence à conexão do jogo. Um Player está no Group desde SubscribeGroupAsync até UnsubscribeGroupAsync ou o fim da sessão. Nada é armazenado. |
| Envio | O seu game server ou cloud function envia um Event para o nome do Group. |
| Recebimento | Toda conexão no Group recebe o Event. O jogo escolhe os Events por tipo com PlayServEvents.Subscribe<T>, veja Server Events. |
| Reconexão | Depois de uma reconexão, o SDK coloca o jogo de volta nos seus Groups. Events enviados nesse meio-tempo não são entregues. |
Um Event entregue não diz por qual Group chegou. Se o jogo está em vários Groups e precisa distingui-los, coloque essa informação no próprio Event, como um campo RoomName.
Entrar e sair
SubscribeGroupAsync(name) e UnsubscribeGroupAsync(name) retornam quando a plataforma responde. As chamadas rodam uma de cada vez, e cada uma espera até 10 segundos antes de lançar TimeoutException. O jogo precisa estar conectado, com um Player logado.
Os nomes de Group têm escopo no seu Project: o jogo usa o nome simples, como arena-7, e o PlayServ o mantém separado dos Groups de outros Projects. Um nome nunca alcança o Group de outro Project.
Um Group não é controle de acesso
Qualquer jogo do seu Project pode entrar em qualquer Group pelo nome. Não envie a um Group nada que só alguns Players possam ver e, para uma partida, use um nome que os Players não consigam adivinhar, como o nome que o PlayServ dá à Room.
Enviar para um Group
| De onde | Chamada |
|---|---|
| Uma cloud function | Platform.Publish<T>(group, payload). O nome simples do Group funciona, e o tipo do Event é o nome do tipo C#. |
| Um Unity Dedicated Server | PlayServGameServer.Events.PublishAsync(group, eventType, payload). O Group precisa vir na forma com escopo de Project; um nome simples lança ArgumentException. eventType precisa coincidir com o nome da classe que o jogo assina. |
PublishAsync termina assim que o Event sai do servidor: ele não espera os Players receberem e não reenvia nada depois de uma reconexão.
O jogo não envia para um Group
PlayServEvents.PublishForGroup e as outras chamadas Publish sempre lançam PlayServEventPublishingException. Para uma mensagem de chat ou um sinal de “pronto”, envie-a ao seu servidor com uma chamada de Function ou RPC e deixe o servidor repassá-la ao Group.
Limites
| Item | Limite |
|---|---|
| Groups por conexão | 64 |
| Nome do Group | Até 256 caracteres, incluindo o prefixo de Project que o PlayServ adiciona |
| Tamanho do Event | 1 MiB |
| Entrar ou sair | 10 segundos |
Erros
| Erro | Quando |
|---|---|
PlayServGroupSubscriptionException com group_subscription_limit_reached | O jogo já está em 64 Groups, ou o nome é longo demais. |
PlayServGroupSubscriptionException com group_outside_project | O nome pertence a outro Project. |
TimeoutException | Nenhuma resposta em 10 segundos. |
InvalidOperationException | O jogo ainda não está conectado. |
Repetir uma entrada recusada não adianta.
O que Groups não são
Groups não têm lista de membros, nem presença, nem como aceitar ou recusar um Player, nem fechamento. Para uma partida com vagas, um servidor e Players admitidos, use Rooms.
Próximos passos
- Events do servidor — receber Events tipados no jogo
- Conectar-se a um jogo — Rooms em que os Players entram
- Hospedagem de game servers — enviar Events a partir do seu game server
Atualizado em 22 de out. de 2026