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.
As partes
| Parte | O que é |
|---|---|
| O seu jogo | O 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 servers | Servidores 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. |
| Backoffice | O console web em que a sua equipe gerencia Projects, keys, Players, o Schema e os dados, Functions, servidores e Rooms. |
| CLI | A linha de comando playserv, para fazer o deploy de Functions e Game servers. Veja Interface de linha de comando. |
| Players | Contas de Player, provedores de login e sessões. Veja Gerenciamento de Players. |
| Dados | O seu Schema e os Records dele, com atualizações ao vivo para o jogo. Veja Como montar o Schema do jogo. |
| Cloud functions | O seu código de servidor, executado pela plataforma. Veja Functions. |
| Rooms de jogo | As 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 onde | O que trafega |
|---|---|
| A conexão ao vivo | Atualizações de dados ao vivo, Events dos seus servidores, chamadas RPC. |
| Requisições separadas | A 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
| Termo | O que é |
|---|---|
| Project | O backend de um jogo. Veja Criar um Project. |
| Environment | Uma 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. |
| Player | Todo 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ódulo | O que faz | Guia |
|---|---|---|
PlayServ | Conecta, configura e desconecta. | Conexão e sessão |
PlayServAuth | Faz o login dos Players, vincula provedores, encerra sessões. | Login de usuários |
PlayServData | Lê, grava e assina Records. | Leitura de Records |
PlayServCode | Chama cloud functions. | Functions |
PlayServEvents · PlayServRpc | Recebe Events dos seus servidores; chama RPCs. | Events do servidor |
PlayServMatchmaking | Lista 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
- Conectar o seu jogo — instale o SDK e conecte
- Como criar um novo Project — o Project e o primeiro Environment
- Conexão e sessão — o que acontece enquanto o jogo está conectado
Atualizado em 19 de out. de 2026