Pular para o conteúdo principal
Multiplayer

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

AspectoComo funciona
ParticipaçãoPertence à conexão do jogo. Um Player está no Group desde SubscribeGroupAsync até UnsubscribeGroupAsync ou o fim da sessão. Nada é armazenado.
EnvioO seu game server ou cloud function envia um Event para o nome do Group.
RecebimentoToda conexão no Group recebe o Event. O jogo escolhe os Events por tipo com PlayServEvents.Subscribe<T>, veja Server Events.
ReconexãoDepois 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 ondeChamada
Uma cloud functionPlatform.Publish<T>(group, payload). O nome simples do Group funciona, e o tipo do Event é o nome do tipo C#.
Um Unity Dedicated ServerPlayServGameServer.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

ItemLimite
Groups por conexão64
Nome do GroupAté 256 caracteres, incluindo o prefixo de Project que o PlayServ adiciona
Tamanho do Event1 MiB
Entrar ou sair10 segundos

Erros

ErroQuando
PlayServGroupSubscriptionException com group_subscription_limit_reachedO jogo já está em 64 Groups, ou o nome é longo demais.
PlayServGroupSubscriptionException com group_outside_projectO nome pertence a outro Project.
TimeoutExceptionNenhuma resposta em 10 segundos.
InvalidOperationExceptionO 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

Atualizado em 22 de out. de 2026