Intégration du GSDK PlayFab dans Unity - XBOX Game Development Documentation

La plateforme Multiplayer Servers fournit une bibliothèque GSDK que vous pouvez intégrer à votre serveur de jeu Unity. La bibliothèque est open source et disponible dans le référentiel GSDK sur GitHub.

Installation

Vous pouvez copier le dossier Assets/PlayFabSdk dans votre projet Unity. Vous devez ensuite activer la directive de script ENABLE_PLAYFABSERVER_API dans les paramètres de build Unity (exemple). Vous pouvez également utiliser le fichier de package Unity fourni. Vous trouverez un exemple de code dans le projet MultiplayerServerSample.

Utilisation

Vous devez au minimum implémenter la méthode PlayFabMultiplayerAgentAPI.Start() et démarrer une coroutine pour la méthode PlayFabMultiplayerAgentAPI.ReadyForPlayers(), comme dans le code ci-dessous

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

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

Vous voudrez également vous abonner à la transition du serveur de jeu vers l’état Active à l’aide de PlayFabMultiplayerAgentAPI.OnServerActiveCallback, comme dans l’exemple ci-dessous :

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

Pour plus d’informations sur les états des serveurs de jeu, consultez la section Notions de base d’un serveur de jeu PlayFab ici

En outre, vous pouvez implémenter les rappels suivants sur votre serveur de jeu :

PlayFabMultiplayerAgentAPI.OnMaintenanceCallback, déclenché lorsqu’Azure doit effectuer une maintenance sur la machine virtuelle
PlayFabMultiplayerAgentAPI.OnShutDownCallback, déclenché à la réception d’une notification d’arrêt
PlayFabMultiplayerAgentAPI.OnAgentErrorCallback, déclenché en cas d’erreur de communication entre le serveur de jeu et l’agent de machine virtuelle PlayFab

Pour d’autres exemples du GSDK, vous pouvez consulter notre référentiel d’exemples MPS ici

​Installation

​Utilisation

Installation

Utilisation