Pular para o conteúdo principal
Lógica de servidor e Events

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

ParteO que faz
O tipo do EventUma classe C# [Serializable] comum, com campos públicos. Sem classe base.
O GroupUm canal nomeado. Um Player recebe os Events enviados aos Groups em que o jogo dele entrou com SubscribeGroupAsync, e nada além disso.
O remetenteO seu game server ou cloud function, que envia um Event a um Group.
O handlerSubscribe<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

ChamadaO 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

RemetenteChamada
Um Unity Dedicated ServerPlayServGameServer.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

ItemLimite
Groups por conexão64
Nome do GroupAté 256 caracteres, incluindo o prefixo do Project que o PlayServ adiciona
Tamanho do Event1 MiB
Entrar ou sair de um Group10 segundos; depois, TimeoutException

Erros

ErroQuando
PlayServGroupSubscriptionExceptionA entrada num Group foi recusada: UnifiedError.SourceCode é group_subscription_limit_reached ou group_outside_project. Tentar de novo não adianta.
TimeoutExceptionA plataforma não respondeu à entrada ou saída de um Group em 10 segundos.
PlayServEventPublishingExceptionO 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

Atualizado em 22 de out. de 2026