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.

Cloud Functions e RPC

Mantenha no servidor as regras que importam: o jogo pede, o código do seu servidor decide. A lógica do lado do servidor é uma cloud function ou um game server, cada um com o seu próprio deploy. O jogo chama uma cloud function com PlayServCode.CallAsync e recebe um resultado tipado; chama um game server em execução com PlayServRpc.InvokeAsync.

using Playserv.Wrapper;
using UnityEngine;

var result = await PlayServCode.CallAsync<ClaimReward, RewardGranted>(
    "claim-match-reward", new ClaimReward { MatchId = matchId });

if (result.IsSuccess)
    Debug.Log($"+{result.Value.Coins} coins");
else
    Debug.LogWarning(result.Error.SourceCode);

Escolha o caminho

PlayServCode.CallAsyncPlayServRpc.InvokeAsync
AlcançaUma cloud function com deploy feitoUma cloud function ou um game server, pelo nome
Passa porUma requisição própriaA conexão que o SDK mantém aberta
Use paraPedido e resposta: resgatar uma recompensa, comprar um item, validar uma jogadaChamadas ao seu game server em execução
VersõesPode chamar uma versão com tagSem escolha de versão

Para leituras e gravações simples dos seus próprios dados, você não precisa de nenhum dos dois: use Records.


Chamar uma cloud function

Faça o deploy da Function

Escreva a Function e faça o deploy com a CLI, veja Deploy com a CLI. O slug dela, como claim-match-reward, é o nome que o jogo chama.

Permita que o jogo a chame

A configuração execute no manifesto da Function precisa permitir chamadas do cliente. Se a autenticação dela exigir um Player, o jogo precisa estar logado. Veja Functions → Configurações.

Chame a Function

CallAsync<TRequest, TResponse>(slug, body) envia body como JSON e lê a resposta como TResponse. CallAsync<TResponse>(slug) chama sem corpo.

Opção (PlayServFunctionCallOptions)O que faz
VersionChama uma versão com tag em vez da mais recente. Uma tag desconhecida falha com function_version_not_found; não há recurso à versão mais recente.
TimeoutSecondsQuanto tempo o jogo espera. A plataforma deixa de esperar pela Function após 60 segundos, então um timeout maior não muda nada.
Query · HeadersParâmetros de query e os seus próprios headers.
StrictResponseTypesFalha quando a resposta não corresponde a TResponse, em vez de preencher o que for possível.

CallAsync sempre envia um POST. Para outro método, ou um corpo bruto, use PlayServCode.InvokeAsync(new PlayServFunctionRequest { … }). InvokeBytesAsync e DownloadToFileAsync retornam respostas binárias; o download para arquivo não está disponível no WebGL.


Quem está chamando

O SDK envia a sessão do Player logado em cada chamada. A plataforma a verifica e passa o Player para a sua Function, que assim sabe quem chamou. Numa Function em C#, ele está em Caller.PlayerId, junto com Caller.IsPlayer e Caller.IsAnonymous.

Nunca confie num ID de Player vindo do corpo da requisição

Qualquer um pode colocar qualquer ID no corpo. Pegue o Player do chamador que a plataforma passa e confira cada valor que o jogo envia com as suas regras.


Chamar o seu game server (RPC)

using Playserv.RPC;
using Playserv.Wrapper;

PlayServRpcResult<RoundPreview> preview = await PlayServRpc.InvokeAsync<PreviewRequest, RoundPreview>(
    "arena", "round.preview", new PreviewRequest { Round = 3 });   // sent as "Round": names must match the handler's parameters, case included

InvokeAsync(service, method, request) envia a chamada pela conexão do jogo. O nome do serviço é o nome de uma Function ou de um game server com deploy feito: o PlayServ o converte para kebab-case e remove um Service no final, então "Arena" e "ArenaService" chegam ambos a arena. O nome do método é repassado a ele.

DetalheValor
Timeout30 segundos por padrão; defina outro com PlayServRpcInvokeOptions.Timeout. Uma cloud function chamada por RPC precisa responder em até 20 segundos.
ResultadoIsSuccess, Value e Error. Timeouts e falhas voltam no resultado, não como exceções: Error.Code é Timeout, ServerError e assim por diante, e UnifiedError.SourceCode informa o motivo dado pela plataforma.
Sem esperarPlayServRpc.Invoke(service, method, payload) envia a chamada e não espera a resposta.
Um game server com RoomsSó Players que participam de uma das Rooms ativas dele podem chamá-lo.

Um game server Unity responde a RPCs com handlers registrados num PlayServServerRpcRegistry, veja Hospedagem de game servers.


Erros e limites das chamadas de Functions

Em CallAsync, os erros voltam em result.Error; Error.SourceCode diz o que aconteceu, e Error.Retryable, se tentar de novo pode ajudar. Só argumentos inválidos, a falta da client key e o cancelamento são lançados como exceção.

SourceCodeQuando
not_foundNão há Function com esse slug neste Project e Environment.
function_version_not_foundA tag de Version não existe.
function_execute_forbiddenA Function não aceita chamadas do jogo.
player_auth_requiredA Function exige um Player logado.
function_unreachableA Function não respondeu em 60 segundos ou está fora do ar.
function_response_too_largeA resposta passa de 16 MiB.
function_transport_failedUma falha de rede. Dá para tentar de novo.

Qualquer outro status vem da própria Function, com o corpo em result.Response.

Torne as chamadas de recompensa seguras para repetir

Um timeout não significa que a Function não rodou: ela pode ter terminado depois que o jogo parou de esperar. Em chamadas que concedem algo, passe um ID da ação, como o ID da partida, e deixe a Function ignorar uma segunda chamada com o mesmo ID.


Próximos passos

  • Functions — Functions com deploy feito, suas configurações e tags de versão
  • Deploy com a CLI — escreva uma Function e faça o deploy
  • Events do servidor — deixe o seu servidor avisar os Players sobre o que aconteceu

Atualizado em 22 de out. de 2026