> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble du plug-in PlayFab Unreal GSDK

> Vue d'ensemble du plug-in PlayFab Unreal GSDK permettant d'intégrer des serveurs de jeu dédiés à PlayFab Multiplayer Servers à l'aide des API Blueprint ou C++.

# 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 offre à 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](https://github.com/PlayFab/gsdk/issues).

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](https://visualstudio.microsoft.com/vs/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)](https://docs.unrealengine.com/ProgrammingAndScripting/ProgrammingWithCPP/DownloadingSourceCode/).
* 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](https://github.com/PlayFab/MpsAgent/releases)
  * \[Facultatif] Vous pouvez également télécharger le [code source de LocalMultiplayerAgent](https://github.com/PlayFab/MpsAgent/tree/main/LocalMultiplayerAgent).
* \[Facultatif] Le [plug-in PlayFab de la Marketplace](https://www.unrealengine.com/marketplace/product/playfab-sdk) ou la [version source sur GitHub](https://github.com/PlayFab/UnrealMarketplacePlugin/tree/master/PlayFabPlugin/PlayFab). 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](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-setup) 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 façon 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 au moyen de 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

Avec un projet multijoueur correctement configuré, vous êtes prêt à [installer le GSDK](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-gsdk-project-setup). Ce plug-in permettra à votre serveur de s'exécuter sur PlayFab Multiplayer Services.

## Configurations de build du projet Unreal

Une fois le GSDK installé et configuré dans votre projet, vous pouvez [générer votre projet Unreal](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project). Plusieurs configurations de build vous seront nécessaires pour exécuter l'ensemble des tests des étapes suivantes.

## Tester le déploiement local du serveur

Une fois que vous disposez d'une build client et d'une build "Development Server", vous pouvez [tester localement le processus de déploiement MPS](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-local-deployment-and-debugging) et vérifier que votre serveur fonctionne.

## Déployer sur PlayFab

Vous êtes maintenant prêt à créer des serveurs de jeu dans le nuage à l'aide de PlayFab Multiplayer Services. PlayFab MPS prend en charge les [serveurs Windows](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment) et les [serveurs Linux](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab).

## Se connecter au serveur déployé

Enfin, vous êtes prêt à [vous connecter à votre serveur déployé](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/connect-to-mps-hosted-build).

## Remerciements

Merci à [Stefan Krismann](https://github.com/stkrwork) d'avoir créé et soumis ce plug-in.

Merci à [Nick Arthur](https://github.com/narthur157) pour son excellent [Dockerfile](https://github.com/narthur157/playfab-gsdk-ue4).

Merci à [Adam Rehn](https://github.com/adamrehn) pour tout son travail sur Unreal et Docker, notamment le code, les exemples et les tutoriels.


## Related topics

- [Vue d'ensemble de PlayFab pour Unreal Engine](/fr-CA/services/playfab/sdks/unified-unreal/overview.md)
- [Vue d'ensemble du plugiciel Unity PlayFab Multiplayer](/fr-CA/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
- [Vue d'ensemble de PlayFab Lobby](/fr-CA/services/playfab/multiplayer/lobby/index.md)
- [Démarrage rapide Unreal Engine](/fr-CA/services/playfab/sdks/unreal/quickstart.md)
- [Configuration du GSDK dans le projet](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-gsdk-project-setup.md)
