Pular para o conteúdo principal
Primeiros passos

Esta página ainda não foi traduzida: mostrando a versão em inglês.

Arquitetura

O PlayServ é o backend com que o seu jogo conversa, operado para você. O jogo se conecta pelo SDK; os seus Game servers, se você tiver, registram as Rooms deles; a sua equipe configura tudo no Backoffice e publica código pelo CLI. Cada Project é dividido em Environments, e a key usada por quem faz a chamada define qual Project e qual Environment ela alcança.

PlayServ · your project's environment Players: sign-in and sessions Data: schema, records, live updates Cloud functions Game rooms and game servers Settings, keys, team and deploys the key decides the project and environment Your game · PlayServ SDK Your game servers Your team · Backoffice, CLI client key server key manage, deploy
De um lado, o seu jogo, os Game servers e a equipe; do outro, os Players, dados, Functions e Rooms da plataforma, alcançados com uma key para cada chamador

As partes

ParteO que é
O seu jogoO seu projeto Unity com o PlayServ SDK. Ele faz o login dos Players, lê e grava dados, recebe atualizações ao vivo e Events e chama Functions.
Os seus Game serversServidores dedicados opcionais. Eles registram as Rooms em que os Players entram e falam com a plataforma usando uma server key. Veja Hospedagem de Game servers.
BackofficeO console web em que a sua equipe gerencia Projects, keys, Players, o Schema e os dados, Functions, servidores e Rooms.
CLIA linha de comando playserv, para fazer o deploy de Functions e Game servers. Veja Interface de linha de comando.
PlayersContas de Player, provedores de login e sessões. Veja Gerenciamento de Players.
DadosO seu Schema e os Records dele, com atualizações ao vivo para o jogo. Veja Como montar o Schema do jogo.
Cloud functionsO seu código de servidor, executado pela plataforma. Veja Functions.
Rooms de jogoAs Rooms que os seus Game servers executam e os Players dentro delas. Veja Game Rooms.

Como o jogo se conecta

O jogo mantém uma única conexão ao vivo com o PlayServ. PlayServ.Connect() faz o login do Player e abre essa conexão; o SDK a mantém ativa e reconecta depois de uma queda.

Por ondeO que trafega
A conexão ao vivoAtualizações de dados ao vivo, Events dos seus servidores, chamadas RPC.
Requisições separadasA maior parte das leituras e escritas de Records, chamadas de cloud functions, login.

Você não precisa escolher entre as duas: o SDK usa o caminho certo para cada chamada. Os estados da conexão, as reconexões e o tratamento da sessão estão em Conexão e sessão.


Keys, Environments e Players

TermoO que é
ProjectO backend de um jogo. Veja Criar um Project.
EnvironmentUma cópia separada dos dados, Functions e Players do Project, como dev e prod. Veja Environments.
Client key (pk_…)Vai embutida no jogo. Define o Project e o Environment que o jogo alcança. Pode ser distribuída com segurança.
Server key (sk_…)Para os seus servidores, ferramentas e CI. Nunca a inclua em uma build do jogo. Veja Gerenciamento de API keys.
PlayerTodo jogo conectado faz login como um Player, anônimo no início. O Player vem da sessão, não de uma configuração. Veja Login de usuários.

Uma key, um Environment

Uma build com uma client key de dev sempre fala com dev. Para lançar, gere a build com uma key do Environment que os Players devem usar.


Módulos do SDK

O SDK é um único pacote, com.playserv.sdk, com um módulo para cada área, além de pacotes complementares opcionais.

MóduloO que fazGuia
PlayServConecta, configura e desconecta.Conexão e sessão
PlayServAuthFaz o login dos Players, vincula provedores, encerra sessões.Login de usuários
PlayServDataLê, grava e assina Records.Leitura de Records
PlayServCodeChama cloud functions.Functions
PlayServEvents · PlayServRpcRecebe Events dos seus servidores; chama RPCs.Events do servidor
PlayServMatchmakingLista Rooms de jogo e entra nelas.Listar, hospedar e entrar em Rooms

Os pacotes complementares adicionam provedores de login, um Game server dedicado e outros recursos opcionais. Eles são instalados em Tools ▸ PlayServ ▸ Settings; veja Conectar o seu jogo.


Próximos passos

Atualizado em 19 de out. de 2026