Utiliser le plug-in Unreal PlayFab GSDK
Cet article explique comment intégrer le plug-in Unreal Online Subsystem (OSS) du SDK PlayFab Multiplayer Server (GSDK) à votre projet Unreal. Ce plug-in propose à la fois une API Blueprint et une API C++. L’API Blueprint nécessite tout de même que votre projet Unreal soit un projet C++ ; elle ne fonctionne pas avec un projet uniquement Blueprint. Si votre projet est actuellement uniquement Blueprint, vous devez d’abord le convertir en projet C++ avant d’ajouter le plug-in. Il a été initialement testé avec Unreal Engine 4.26, 4.27, 5.0 et 5.1. Ce plug-in sera activement maintenu pour fonctionner avec les 3 ou 4 dernières versions d’Unreal. Si un problème survient avec ces versions, ouvrez un problème ici : Référentiel Unreal Engine GSDK. Pour utiliser ces guides, remplacez toutes les occurrences de ThirdPersonMP par le nom de votre projet, s’il est différent.Exigences
- Téléchargez Visual Studio. La version Community est gratuite.
- Charges de travail requises : Développement .NET Desktop et Développement Desktop en C++
- Téléchargez le code source d’Unreal Engine. Pour obtenir des instructions, consultez Downloading Unreal Engine Source code (externe).
- Si ce n’est pas déjà fait, effectuez un git clone de ce référentiel sur votre machine locale
git clone https://github.com/PlayFab/gsdk.git- Les étapes ultérieures consisteront à intégrer des fichiers de ce référentiel à votre projet
- [Facultatif] Téléchargez LocalMultiplayerAgent
- [Facultatif] Vous pouvez également télécharger le code source de LocalMultiplayerAgent.
- [Facultatif] Le plug-in PlayFab de la Marketplace ou la version source sur GitHub. Ce plug-in n’est pas requis pour le GSDK, mais il est nécessaire pour de nombreux services PlayFab, dont la connexion.
Création du projet
Le projet de serveur Unreal doit être un projet Unreal multijoueur compatible réseau, doté d’un mode serveur dédié. Si vous ne disposez pas d’un projet qui remplit ces prérequis, suivez notre guide de configuration des prérequis Unreal pour en configurer un. Une fois que vous disposez d’un projet multijoueur compatible réseau avec un serveur dédié, revenez à cette étape et continuez. Lorsque vous êtes prêt, ouvrez votre projet de serveur Unreal multijoueur compatible réseau et passez à l’étape suivante pour installer le GSDK Unreal.Configuration du GSDK dans le projet
- Détails des prérequis du projet pour le GSDK
- Serveur dédié :
- Votre projet doit comporter un fichier {ProjectName}Server.Target.cs distinct
- Ce fichier doit contenir
Type = TargetType.Server;pour activer le mode serveur dédié - Lorsque vous générez dans la configuration “development server” pour Win64, votre sortie contient {ProjectName}Server.exe
- Compatible réseau :
- Il existe plusieurs façons de satisfaire cette exigence, mais en résumé : votre client peut établir une connexion réseau avec un serveur de jeu situé sur une autre machine et communiquer de manière significative
- Nos instructions vous guident à travers le système de réplication des données intégré d’Unreal, qui gère l’essentiel de cette exigence pour vous
- Vous pouvez établir cette connexion plus directement avec un socket, par exemple via ISocketSubsystem, mais il s’agit d’un sujet beaucoup plus avancé
- Multijoueur :
- Votre serveur de jeu peut accepter plusieurs connexions client entrantes et communiquer correctement avec chacune d’elles
- Là encore, avec la réplication des données intégrée d’Unreal, cette exigence est en grande partie gérée pour vous
- Serveur dédié :