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.CallAsync | PlayServRpc.InvokeAsync | |
|---|---|---|
| Alcança | Uma cloud function com deploy feito | Uma cloud function ou um game server, pelo nome |
| Passa por | Uma requisição própria | A conexão que o SDK mantém aberta |
| Use para | Pedido e resposta: resgatar uma recompensa, comprar um item, validar uma jogada | Chamadas ao seu game server em execução |
| Versões | Pode chamar uma versão com tag | Sem 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 |
|---|---|
Version | Chama 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. |
TimeoutSeconds | Quanto 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 · Headers | Parâmetros de query e os seus próprios headers. |
StrictResponseTypes | Falha 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.
| Detalhe | Valor |
|---|---|
| Timeout | 30 segundos por padrão; defina outro com PlayServRpcInvokeOptions.Timeout. Uma cloud function chamada por RPC precisa responder em até 20 segundos. |
| Resultado | IsSuccess, 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 esperar | PlayServRpc.Invoke(service, method, payload) envia a chamada e não espera a resposta. |
| Um game server com Rooms | Só 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.
SourceCode | Quando |
|---|---|
not_found | Não há Function com esse slug neste Project e Environment. |
function_version_not_found | A tag de Version não existe. |
function_execute_forbidden | A Function não aceita chamadas do jogo. |
player_auth_required | A Function exige um Player logado. |
function_unreachable | A Function não respondeu em 60 segundos ou está fora do ar. |
function_response_too_large | A resposta passa de 16 MiB. |
function_transport_failed | Uma 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