Pular para o conteúdo principal

Visão geral

O PlayFab Game Server SDK (GSDK) é fornecido nas versões C++, C# e Java. O GSDK conecta seu servidor de jogo ao agente do PlayFab instalado na VM. Esse agente facilita as principais interações do servidor com a plataforma PlayFab Multiplayer.

Integração básica

Para que seu servidor de jogo possa se comunicar com a plataforma multijogador do PlayFab, você precisa integrá-lo ao GSDK. No mínimo, você deve implementar os métodos Start e ReadyForPlayers no seu servidor de jogo.

Registro em log com o GSDK

Quando o servidor de jogo for encerrado, o agente de VM do PlayFab compactará todos os arquivos de log em zip e os disponibilizará para você. <!—via the GetMultiplayerServerLogs API.—> Há duas maneiras de adicionar arquivos de log do seu jogo:
  1. Use o método Log do GSDK: ele adicionará suas próprias linhas de log ao arquivo de log do GSDK.
  2. Grave seu próprio arquivo de log no diretório de logs apropriado, que o agente de VM do PlayFab compactará em zip e carregará.

Desligando normalmente o servidor de jogo

Há três cenários em que seu servidor de jogo será encerrado:
  1. O aplicativo do servidor de jogo é encerrado.
  2. O PlayFab encerra seu servidor de jogo porque há mais servidores de jogo disponíveis do que o necessário para a carga atual de jogadores.
O PlayFab só encerrará servidores de jogo que não estejam ativos no momento.
  1. O Azure realizará a manutenção necessária na máquina virtual que hospeda seu servidor de jogo.
Para o item (1) acima: você controla quando isso acontece e pode realizar qualquer limpeza necessária antes que o aplicativo seja encerrado. Para os itens (2) e (3) acima: o GSDK fornece uma maneira de saber quando eles ocorrerão, especificando um método de retorno de chamada.

Fornecendo ao PlayFab informações sobre o seu servidor de jogo

No momento, há duas informações que você pode comunicar ao PlayFab usando o GSDK:
  1. O status de integridade atual do seu servidor de jogo.
  2. Uma lista dos jogadores conectados no momento ao seu servidor de jogo.
Essas duas informações serão transmitidas ao PlayFab na próxima pulsação e, no momento, podem ser usadas para relatórios.

Obtendo as configurações no seu servidor de jogo

Há várias configurações do PlayFab relacionadas ao seu servidor de jogo que você pode recuperar usando o GSDK.
Duas dessas configurações são, na verdade, passadas ao PlayFab pelos seus clientes, como parte da chamada para solicitar um servidor multijogador. Portanto, essas configurações não estarão disponíveis para o seu servidor de jogo até que ele seja alocado.
Última modificação em 8 de outubro de 2026