Pular para o conteúdo principal
Primeiros passos

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 deOnde conseguir
Unity 2021.3 ou mais recente—
Um Project do PlayServCriar 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:

CampoValor
NameOpenUPM
URLhttps://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.

CampoO que é
EnvironmentA plataforma PlayServ. Use Prod.
Client TokenA sua client key. Ela vai embutida no jogo.
Server TokenUma server key para ferramentas do editor, como o deploy de Functions. Ela fica no editor e nunca entra em uma build.
Game VersionA 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 loginA client key: cole-a de novo e confirme que ela não foi revogada.
Connect() retorna false com o erro 00001A 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 aparecemO 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 compilamExecute o Migrate Project.

Próximos passos

Atualizado em 19 de out. de 2026