Esta página ainda não foi traduzida: mostrando a versão em inglês.
Events do servidor
Os seus servidores enviam Events tipados aos Players; o jogo os escuta com PlayServEvents.Subscribe<T>. Um game server ou uma cloud function envia um Event a um Group, e todo Player desse Group o recebe pela conexão que o SDK já mantém aberta. Os Events vão num só sentido: dos seus servidores para o jogo.
using System;
using Playserv.Wrapper;
using UnityEngine;
[Serializable]
public class MatchFinished
{
public string WinnerCallsign;
public int Score;
}
public sealed class MatchEvents : MonoBehaviour
{
IDisposable _sub;
async void Start()
{
await PlayServEvents.SubscribeGroupAsync("arena-7");
_sub = PlayServEvents.Subscribe<MatchFinished>(e => Debug.Log($"{e.WinnerCallsign} wins with {e.Score}"));
}
void OnDestroy() => _sub?.Dispose();
}
Como funciona a entrega
| Parte | O que faz |
|---|---|
| O tipo do Event | Uma classe C# [Serializable] comum, com campos públicos. Sem classe base. |
| O Group | Um canal nomeado. Um Player recebe os Events enviados aos Groups em que o jogo dele entrou com SubscribeGroupAsync, e nada além disso. |
| O remetente | O seu game server ou cloud function, que envia um Event a um Group. |
| O handler | Subscribe<T> separa os Events do tipo T de tudo o que o jogo recebe. |
Um Event é identificado pelo nome do tipo: o remetente informa o tipo do Event, e o jogo o entrega a quem assinou a classe com esse nome. Use o mesmo nome de classe dos dois lados. O namespace pode ser diferente, desde que nenhuma outra classe assinada pelo jogo tenha o mesmo nome.
Events não são armazenados
Um Event chega aos Players que estão no Group no momento do envio. Quem entra depois, ou está offline nesse momento, não o recebe. Para um estado que o Player precisa ver, use Records e envie um Event só para avisar que algo aconteceu.
Assinar
| Chamada | O que faz |
|---|---|
PlayServEvents.Subscribe<T>(handler) | Chama handler para cada Event do tipo T. Retorna um IDisposable: chame Dispose nele para parar. |
PlayServEvents.SubscribeGroupAsync(name) | Entra num Group, para que os Events dele cheguem a este jogo. |
PlayServEvents.UnsubscribeGroupAsync(name) | Sai de um Group. |
Chame-as depois de PlayServ.Connect(): assinar antes de o jogo estar conectado lança InvalidOperationException. Vários handlers do mesmo tipo compartilham uma única assinatura.
Depois de uma reconexão, o SDK coloca o jogo de volta nos seus Groups e mantém os handlers, sem nenhum código da sua parte. Events enviados enquanto o jogo estava desconectado não são entregues.
Groups, seus nomes e limites estão descritos em Groups.
Quem envia Events
| Remetente | Chamada |
|---|---|
| Um Unity Dedicated Server | PlayServGameServer.Events.PublishAsync(group, eventType, payload), com o nome do Group com escopo do Project, veja Groups. |
| Uma cloud function em C# | Platform.Publish<T>(group, payload), que usa o nome do tipo C# como tipo do Event. |
O jogo não pode enviar Events
PlayServEvents.Publish, PublishForGroup e PublishForUser existem no SDK, mas sempre lançam PlayServEventPublishingException. O mesmo vale para os helpers Send… que o Editor gera para tipos [Event]. Para que algo aconteça para outros Players, chame uma Function ou o seu game server e deixe que ele envie o Event.
Limites
| Item | Limite |
|---|---|
| Groups por conexão | 64 |
| Nome do Group | Até 256 caracteres, incluindo o prefixo do Project que o PlayServ adiciona |
| Tamanho do Event | 1 MiB |
| Entrar ou sair de um Group | 10 segundos; depois, TimeoutException |
Erros
| Erro | Quando |
|---|---|
PlayServGroupSubscriptionException | A entrada num Group foi recusada: UnifiedError.SourceCode é group_subscription_limit_reached ou group_outside_project. Tentar de novo não adianta. |
TimeoutException | A plataforma não respondeu à entrada ou saída de um Group em 10 segundos. |
PlayServEventPublishingException | O jogo tentou enviar um Event. |
Um Event que não pode ser lido como T é registrado no log e descartado; os outros Events continuam chegando.
Próximos passos
- Groups — os canais para onde os Events são enviados
- Cloud Functions e RPC — peça ao seu servidor que faça algo
- Hospedagem de game servers — envie Events a partir de um game server Unity
Atualizado em 22 de out. de 2026