Integrando o PlayFab GSDK ao Unity - XBOX Game Development Documentation

A plataforma Multiplayer Servers fornece uma biblioteca GSDK que você pode integrar ao seu servidor de jogo do Unity. A biblioteca é de código aberto e pode ser encontrada no repositório do GSDK no GitHub.

Instalação

Você pode copiar a pasta Assets/PlayFabSdk para o seu projeto do Unity. Depois disso, você precisa habilitar a diretiva de script ENABLE_PLAYFABSERVER_API nas configurações de build do Unity (exemplo). Como alternativa, você pode usar o arquivo de pacote do Unity fornecido. Você pode encontrar um código de exemplo no projeto MultiplayerServerSample.

Uso

No mínimo, você precisa implementar o método PlayFabMultiplayerAgentAPI.Start() e iniciar uma corrotina para o método PlayFabMultiplayerAgentAPI.ReadyForPlayers(), como no código abaixo

//...
StartCoroutine(ReadyForPlayers());
//...

private IEnumerator ReadyForPlayers()
{
    yield return new WaitForSeconds(.5f);
    PlayFabMultiplayerAgentAPI.ReadyForPlayers();
}

Você também vai querer se registrar para saber quando o servidor de jogo passa para Active usando PlayFabMultiplayerAgentAPI.OnServerActiveCallback, como no exemplo abaixo:

PlayFabMultiplayerAgentAPI.OnServerActiveCallback += OnServerActive;
// ...
private void OnServerActive()
{
    Debug.Log("Server Started From Agent Activation");
    // players can now connect to the server
}

Para obter mais informações sobre os estados do servidor de jogo, confira a seção Noções básicas de um servidor de jogo do PlayFab aqui

Além disso, você pode implementar os seguintes retornos de chamada no seu servidor de jogo:

PlayFabMultiplayerAgentAPI.OnMaintenanceCallback: disparado quando o Azure precisa realizar a manutenção na VM
PlayFabMultiplayerAgentAPI.OnShutDownCallback: disparado quando uma notificação de encerramento é recebida
PlayFabMultiplayerAgentAPI.OnAgentErrorCallback: disparado se houver algum erro na comunicação entre o servidor de jogo e o PlayFab VM Agent

Para ver mais exemplos do GSDK, você pode dar uma olhada no nosso repositório de exemplos do MPS aqui

​Instalação

​Uso

Instalação

Uso