> ## 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.

# Se connecter à un serveur Unreal hébergé dans le nuage

> Connectez des clients Unreal Engine à une build de serveur dédié hébergée par PlayFab Multiplayer Servers (MPS) à l'aide d'un utilitaire de développement qui contourne l'allocation standard.

# Se connecter à une build hébergée par MPS

Cet article explique comment connecter des clients à des serveurs hébergés par PlayFab Multiplayer Servers (MPS) à l'aide d'un outil utilitaire. Cet outil est utilisé pendant le développement pour contourner les étapes habituelles de provisionnement et d'activation des serveurs. Les étapes précédentes de cette série d'exemples ont couvert l'ajout du GSDK Unreal à un projet de tutoriel ThirdPersonMP standard. Nous avons ainsi configuré le côté connexion du serveur, mais nous avons ignoré une séquence de connexion client appropriée. PlayFab exige que les serveurs soient provisionnés et activés avant que les clients puissent s'y connecter. Nous ne décrirons pas ce processus ici, mais vous trouverez plus de détails dans la [documentation MPS](/fr-CA/services/playfab/multiplayer/servers/connecting-clients-to-game-servers). Pour cet exemple, nous allons plutôt contourner ces étapes complexes et utiliser un utilitaire manuel pour tester rapidement les connexions entre le client et le serveur.

## Prérequis

* Clonez ou téléchargez le [référentiel MpsSamples](https://github.com/PlayFab/MpsSamples)
* Un serveur ThirdPersonMP entièrement déployé, à l'état "Deployed", avec au moins un serveur entièrement préparé et en mode "Standby"
  * ThirdPersonMP est l'exemple de projet [généré](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project) et [déployé](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment) dans les pages précédentes de ce guide.
  * L'état d'une build devient "Deployed" lorsqu'elle contient des serveurs prêts à accepter des connexions. Ces serveurs sont considérés comme étant en "Standby"
* Un [client de jeu généré](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project), prêt à se connecter
* Visual Studio avec .NET Core 3.1 (disponible sous forme de case à cocher facultative dans Visual Studio Installer)

## Connecter automatiquement un client au serveur

Votre client de jeu généré s'appelle probablement **ThirdPersonMP.exe** et se trouve dans votre projet ou à proximité. Si vous n'avez pas utilisé ThirdPersonMP comme modèle de départ, votre client de jeu généré s'appelle **\{YourProjectName}.exe** et se trouve de même dans votre projet Unreal ou à proximité. Recherchez ce fichier.

* Recherchez `ThirdPersonMP.exe`
* Créez à côté un nouveau fichier `RunCloud.bat`
* Ouvrez ce fichier dans l'éditeur de texte de votre choix et définissez le contenu suivant :

```Batch theme={null}
ThirdPersonMP {IP-ADDRESS}:{PORT} -log
```

REMARQUE : remplacez `ThirdPersonMP` par le nom de votre projet si nécessaire.

* Pour l'instant, nous ne connaissons pas encore l'IP-ADDRESS ni le PORT; enregistrez simplement le fichier et laissez l'éditeur ouvert.
* Recherchez le fichier `{MpsSamples Repo}/MpsAllocatorSample/MpsAllocatorSample.csproj`
* Ouvrez ce fichier dans Visual Studio
* Exécutez ce programme
* Suivez les instructions à l'écran et saisissez les valeurs suivantes lorsque vous y êtes invité :
  * \{Your PlayFab TitleId}
  * \{Any valid and active secret key for your PlayFab Title}
  * Choisissez **1** pour **RequestMultiplayerServer**
  * Saisissez le \{BuildId} de la build de serveur à l'état **Deployed** que vous souhaitez tester
    * Vous le trouverez à côté du nom dans la liste de toutes les builds, dans l'onglet **Details** de la build concernée, ou dans l'URL de n'importe quelle page propre à la build
  * Si vous avez défini plusieurs régions, vous êtes invité à en sélectionner une. Sinon, la seule région disponible est sélectionnée automatiquement.
  * Pour les ID de joueur, vous pouvez saisir une valeur hexadécimale réelle ou fictive
    * Si vous avez suivi la configuration de ThirdPersonMP, vous pouvez choisir n'importe quel nombre hexadécimal, comme 1337, abc123, etc.
    * Saisissez au moins un nombre, puis appuyez une fois de plus sur Entrée pour terminer
* Vous devriez recevoir une réponse semblable à celle-ci :

```json theme={null}
{
  "ConnectedPlayers": [],
  "FQDN": "...",
  "IPV4Address": "52.180.68.101",
  "LastStateTransitionTime": "2021-12-06T22:12:46.212Z",
  "Ports": [
    {
      "Name": "gameport",
      "Num": 30000,
      "Protocol": "UDP"
    }
  ],
  "Region": "WestUs",
  "ServerId": "...",
  "SessionId": "...",
  "State": "Active",
  "VmId": "..."
}
```

* REMARQUE : les valeurs sans importance pour cet exemple ont été remplacées par `...`
* Recherchez **IPV4Address** et **Ports.Num** dans votre réponse
  * Dans l'exemple ci-dessus, ces valeurs sont respectivement `52.180.68.101` et `30000`
  * Vos valeurs peuvent être/seront différentes
* Revenez à votre fichier `RunCloud.bat` et renseignez ces valeurs pour IP-ADDRESS et PORT. Exemple :

```Batch theme={null}
ThirdPersonMP 52.180.68.101:30000 -log
```

* Dans l'Explorateur Windows, double-cliquez sur ce fichier .bat pour exécuter le client de jeu, patientez un instant, puis double-cliquez de nouveau dessus
* Deux instances de votre client de jeu devraient démarrer, toutes deux connectées à votre serveur de jeu hébergé dans le nuage
* Vous pouvez alors vous déplacer dans les deux jeux : les mouvements et les actions des deux utilisateurs devraient se refléter dans les deux clients de jeu, pour les deux joueurs
  * RÉUSSITE! Si c'est le cas, vous avez terminé l'ensemble du processus de configuration, de génération, de déploiement et de connexion

## Navigation

Pour certains utilisateurs, cette série de guides est désormais terminée. Vous pouvez revenir au guide principal du [plug-in Unreal GSDK](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk).

Si votre test a été exécuté sur des serveurs Windows, vous pouvez essayer le guide de déploiement plus avancé pour [serveur Linux](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab).


## Related topics

- [Déployer un serveur Unreal Linux dans le nuage MPS](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab.md)
- [Déploiement infonuagique du projet GSDK](/fr-CA/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment.md)
- [Configuration de serveurs dédiés avec PlayFab Online Subsystem (OSS)](/fr-CA/services/playfab/multiplayer/networking/party-unreal-engine-oss-dedicated-servers.md)
- [Se connecter directement pour déboguer les serveurs de jeu](/fr-CA/services/playfab/multiplayer/servers/directly-debugging-game-servers.md)
- [Utiliser PlayFab Multiplayer Servers pour héberger des jeux multijoueurs](/fr-CA/services/playfab/multiplayer/servers/using-playfab-servers-to-host-games.md)
