Passer au contenu principal

Vue d’ensemble

Le SDK du serveur de jeu PlayFab (GSDK) est fourni en versions C++, C# et Java. Le GSDK connecte votre serveur de jeu à l’agent PlayFab installé sur la machine virtuelle. Cet agent facilite les interactions clés du serveur avec la plateforme PlayFab Multiplayer.

Intégration de base

Pour que votre serveur de jeu puisse communiquer avec la plateforme multijoueur PlayFab, vous devez l’intégrer au GSDK. Vous devez au minimum implémenter les méthodes Start et ReadyForPlayers dans votre serveur de jeu.

Journalisation avec le GSDK

À l’arrêt de votre serveur de jeu, l’agent de machine virtuelle PlayFab compresse tous les fichiers journaux et les met à votre disposition. <!—via the GetMultiplayerServerLogs API.—> Il existe deux façons d’ajouter des fichiers journaux à partir de votre jeu :
  1. Utilisez la méthode Log du GSDK : elle ajoute vos propres lignes de journal au fichier journal du GSDK.
  2. Écrivez votre propre fichier journal dans le répertoire de journaux approprié, que l’agent de machine virtuelle PlayFab compressera et téléversera.

Arrêt propre de votre serveur de jeu

Votre serveur de jeu peut s’arrêter dans trois scénarios :
  1. Votre application de serveur de jeu se ferme.
  2. PlayFab arrête votre serveur de jeu, car il y a plus de serveurs de jeu disponibles que nécessaire pour la charge actuelle de joueurs.
PlayFab n’arrête que les serveurs de jeu qui ne sont pas actuellement actifs.
  1. Azure effectue une maintenance requise sur la machine virtuelle qui héberge votre serveur de jeu.
Pour le cas (1) ci-dessus : vous contrôlez le moment où cela se produit et pouvez effectuer tout nettoyage nécessaire avant la fermeture de votre application. Pour les cas (2) et (3) ci-dessus : le GSDK vous permet de savoir quand ils se produiront, en spécifiant une méthode de rappel.

Communiquer à PlayFab des informations sur votre serveur de jeu

Actuellement, vous pouvez communiquer deux éléments à PlayFab à l’aide du GSDK :
  1. L’état d’intégrité actuel de votre serveur de jeu.
  2. La liste des joueurs actuellement connectés à votre serveur de jeu.
Ces deux informations sont transmises à PlayFab lors de la pulsation suivante et peuvent actuellement être utilisées à des fins de création de rapports.

Obtenir les paramètres de configuration dans votre serveur de jeu

Plusieurs paramètres PlayFab liés à votre serveur de jeu peuvent être récupérés à l’aide du GSDK.
Deux de ces paramètres sont en réalité transmis à PlayFab par vos clients, dans le cadre de l’appel de demande d’un serveur multijoueur. Ces paramètres ne sont donc pas disponibles pour votre serveur de jeu tant qu’il n’a pas été alloué.
Dernière modification le 8 octobre 2026