Esta página ainda não foi traduzida: mostrando a versão em inglês.
Conectar o seu jogo
Três coisas conectam um jogo Unity ao PlayServ: o pacote do SDK, uma client key e uma chamada a PlayServ.Connect(). A client key diz a qual Project e Environment o jogo pertence; o SDK cuida do resto, do login do Player até manter a conexão ativa.
Antes de começar
| Você precisa de | Onde conseguir |
|---|---|
| Unity 2021.3 ou mais recente | — |
| Um Project do PlayServ | Criar um Project |
Uma client key (pk_…) | Projects → API keys do seu Project → Create key, tipo Client. A key pertence ao Environment selecionado na barra superior. Veja Gerenciamento de API keys. |
Instalar o SDK
O SDK é o pacote com.playserv.sdk. Instale-o pelo OpenUPM ou pelo repositório Git dele.
Adicione o registro do OpenUPM
Na Unity, abra Edit ▸ Project Settings ▸ Package Manager e adicione um scoped registry:
| Campo | Valor |
|---|---|
| Name | OpenUPM |
| URL | https://package.openupm.com |
| Scope(s) | com.playserv.sdk |
Adicione o pacote
Abra Window ▸ Package Manager, escolha Add package by name e informe com.playserv.sdk com a versão desejada. Use uma versão exata, para que todas as máquinas e builds recebam o mesmo SDK.
Para instalar pelo Git, escolha Add package from git URL e informe https://github.com/playserv1/playserv-unity-sdk.git#<version>.
Os complementos opcionais do SDK, como login com Apple, Google, Facebook, Epic ou Steam, são pacotes complementares. Instale, remova e ative esses pacotes em Tools ▸ PlayServ ▸ Settings, nas configurações de módulos do SDK.
Configurar o SDK
Abra a janela do PlayServ
Escolha Tools ▸ PlayServ ▸ Settings. A configuração fica em Control Room, na seção PlayServ Config.
Escolha a plataforma
Defina Environment como Prod, a plataforma PlayServ a que o seu jogo se conecta.
Cole a client key
Cole a sua key pk_… em Client Token e defina Game Version com a versão da sua build.
O Environment desta janela não é o Environment do seu Project
Environment, na janela do PlayServ, escolhe a plataforma PlayServ: use sempre Prod. O Environment do seu Project, como dev ou prod, vem da client key que você cola: use uma key do Environment com que a build deve falar.
| Campo | O que é |
|---|---|
| Environment | A plataforma PlayServ. Use Prod. |
| Client Token | A sua client key. Ela vai embutida no jogo. |
| Server Token | Uma server key para ferramentas do editor, como o deploy de Functions. Ela fica no editor e nunca entra em uma build. |
| Game Version | A versão da sua build, enviada quando o jogo se conecta. |
As keys ficam nas configurações locais do seu editor, não nos arquivos do projeto. Em builds de CI, passe a key pela variável de ambiente PLAYSERV_CLIENT_TOKEN e defina PLAYSERV_ENVIRONMENT=Prod.
Conectar pela primeira vez
Adicione um script como este à sua primeira cena:
using System;
using Playserv.Wrapper;
using UnityEngine;
public sealed class PlayServBootstrap : MonoBehaviour
{
async void Start()
{
try
{
bool online = await PlayServ.Connect();
Debug.Log(online ? $"Online as {PlayServAuth.PlayerId}" : "PlayServ connect failed");
}
catch (Exception e) // for example, a client key that isn't valid
{
Debug.LogError($"PlayServ sign-in failed: {e.Message}");
}
}
void OnDestroy() => PlayServ.Disconnect();
}
Aperte Play. O Console mostra Online as plr_…: o jogo está conectado, logado como um Player anônimo. Esse Player agora aparece em Players, no Environment da sua key.
O que Connect() faz, e como a conexão é mantida ativa, está em Conexão e sessão.
Atualizar a partir de um SDK antigo
A API do SDK mudou ao longo das versões. Tools ▸ PlayServ ▸ Migrate Project varre os seus scripts em busca das chamadas antigas, mostra as alterações e aplica as que você selecionar; ele guarda backups dos arquivos que edita.
Game ID e user ID não são mais necessários
Desde a versão 0.5, a client key identifica o Project e o Environment, e o Player vem da sessão. Remova o Game ID ou o user ID do seu código manualmente; o Migrate Project não faz isso. Deixe Deployment Game Id vazio na janela do PlayServ: quando ele está preenchido, o SDK mantém os Players separados dos que foram salvos sem ele.
Se não conectar
| O que você vê | O que verificar |
|---|---|
Connect() lança uma exceção durante o login | A client key: cole-a de novo e confirme que ela não foi revogada. |
Connect() retorna false com o erro 00001 | A conexão foi recusada: verifique a client key, a versão do SDK e o Game Version. |
| O jogo conecta, mas os seus dados não aparecem | O Environment da key: pode ser uma key de outro Environment. |
| "Endpoint is required" | Ao configurar por código, defina BackendServerAddress; veja Do que o SDK precisa. |
Chamadas antigas, como PlayServ.Ready, não compilam | Execute o Migrate Project. |
Próximos passos
- Conexão e sessão — o que acontece quando o jogo se conecta e quando ele reconecta
- Login do usuário — deixe os Players fazerem login com um provedor
- Construir o Schema do jogo — defina os dados que o seu jogo guarda
Atualizado em 19 de out. de 2026