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

# Exemple Windows Runner

> Configurez l'exemple Windows Runner C# pour PlayFab Multiplayer Servers afin de générer et de déployer un serveur de jeu Windows minimal intégrant le GSDK pour tester les fonctionnalités de MPS.

# Exemple Windows Runner C\#

Ce tutoriel répertorie les étapes permettant de configurer l'exemple afin de l'utiliser avec PlayFab Multiplayer Servers.

<Note>
  Pour utiliser et afficher PlayFab Multiplayer Servers, vous devez activer la fonctionnalité dans Game Manager. Pour obtenir des instructions, consultez [Activer la fonctionnalité PlayFab Server](/fr-CA/services/playfab/multiplayer/servers/enable-playfab-multiplayer-servers).
</Note>

1. [Configurer l'option des fonctionnalités d'API](#configure-api-feature-option)
2. Créer une build de serveur de jeu multijoueur PlayFab : [Configuration du serveur](#server-set-up)
3. [Créer des serveurs en déployant une build](#create-servers-by-deploying-a-build)
4. Demander des serveurs multijoueurs : [Configuration du client](#client-set-up). Cette demande est nécessaire pour pouvoir démarrer un client qui se connecte aux serveurs

<a id="configure-api-feature-option" />

## Configurer l'option des fonctionnalités d'API

<Note>
  Cette étape n'est nécessaire que pour exécuter cet exemple. Vous n'avez pas besoin d'autoriser les clients à démarrer des jeux, sauf si votre titre l'exige.
</Note>

* Connectez-vous à votre compte de développeur sur [PlayFab.com](https://developer.playfab.com) pour utiliser le portail Game Manager
* Sélectionnez votre titre de jeu
* Sélectionnez l'icône des paramètres > **API features**, comme illustré dans l'image ci-dessous.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/create-your-first-server/windowsrunner-api-settings.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=6dc935f952e754c3f14ff8c744c90ac7" alt="Onglet API features dans Game Manager" width="800" height="405" data-path="images/playfab/multiplayer/servers/create-your-first-server/windowsrunner-api-settings.png" />

* Sous **Options**, sélectionnez **Allow client to start games**, comme illustré dans l'image ci-dessous.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/create-your-first-server/windowsrunner-api-settings-option.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=c6d6ad00718feb7293797b0e102875d7" alt="Sélection de Allow client to start games dans Game Manager" width="374" height="177" data-path="images/playfab/multiplayer/servers/create-your-first-server/windowsrunner-api-settings-option.PNG" />

<a id="server-set-up" />

## Configuration du serveur

Explique comment obtenir la build de serveur de jeu multijoueur PlayFab.

* [SDK du serveur de jeu PlayFab](https://github.com/PlayFab/gsdk) de la build PlayFab Multiplayer Server pour l'exemple Windows Runner.
* Si vous préférez la générer vous-même :

  * Obtenez l'[exemple Windows Runner C#](https://github.com/PlayFab/MpsSamples/tree/master/WindowsRunnerCSharp) à l'aide des méthodes Git standard ou en le téléchargeant sous forme de fichier zip.
  * Ouvrez le projet avec Visual Studio 2017 ou une version ultérieure. Cela devrait déclencher automatiquement le téléchargement des dépendances, comme le dernier [package NuGet du SDK du serveur de jeu PlayFab (GSDK)](https://www.nuget.org/packages/com.playfab.csharpgsdk).
  * Compilez et générez WindowsRunnerCSharp.csproj dans la configuration release x64. Vous obtenez une build de serveur de jeu intégrée au GSDK, qui constitue une build de serveur de jeu multijoueur PlayFab valide.
  * Accédez au dossier bin et compressez tous les binaires release x64. Il ne doit y avoir aucune structure de dossiers interne. Le fichier zip doit être un ensemble plat de fichiers, comme illustré dans l'image ci-dessous.

  <img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/tutorials/gsdk-sample-output.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=ca4973938707eae40c4e869aa470c148" alt="Sortie de l'exemple GSDK" width="1136" height="450" data-path="images/playfab/multiplayer/servers/tutorials/gsdk-sample-output.png" />

<Tip>
  Pour effectuer une vérification croisée, vous pouvez comparer la sortie de votre build avec la version compilée fournie dans le lien.
</Tip>

Une fois que vous disposez du fichier zip, vous êtes prêt à [déployer une build](#create-servers-by-deploying-a-build).

<a id="create-servers-by-deploying-a-build" />

## Créer des serveurs en déployant une build

Vous pouvez déployer une build à l'aide de l'une des méthodes suivantes.

* [Utiliser Game Manager pour déployer et configurer des serveurs](/fr-CA/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager)
* [Utiliser PowerShell pour déployer et configurer des serveurs](/fr-CA/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-api-powershell)

Pour certains paramètres, il peut être plus simple de les configurer à l'aide de l'interface web—Game Manager.

Ensuite, [configurez et exécutez le client](#client-set-up) pour vous connecter aux serveurs déployés.

<a id="client-set-up" />

## Configuration du client

Explique comment configurer l'application cliente Windows Runner pour qu'elle se connecte aux serveurs de jeu que vous avez créés à l'aide de PlayFab Multiplayer Servers. Cette configuration ne peut être effectuée qu'une fois que vous disposez de serveurs en attente.

* Après avoir [déployé une build](#create-servers-by-deploying-a-build), attendez que des serveurs en attente soient disponibles

* Obtenez le **titleId** et le **buildId** de la build

  * À l'aide de Game Manager :
    * Accédez à la page **My Studios and Titles** et recherchez votre titre de jeu. Copiez la valeur d'ID qui y figure et collez-la dans un emplacement pratique accessible ultérieurement. Il s'agit du **titleId**
    * Sélectionnez le titre de jeu pour afficher le tableau de bord
    * Accédez à **Multiplayer** > **Servers** > **Builds**
    * Copiez l'ID de la build que vous souhaitez utiliser et collez-le dans un emplacement pratique. Il s'agit du **buildId**

  * Avec PowerShell, ces informations figurent dans la sortie une fois la build déployée avec succès.
    * Copiez le **titleId** et le **buildId** et collez-les dans un emplacement pratique

* Obtenez l'[exemple Windows Runner C#](https://github.com/PlayFab/MpsSamples/tree/master/WindowsRunnerCSharp) à l'aide des méthodes Git standard ou en le téléchargeant sous forme de fichier zip. Ignorez cette étape si vous l'avez déjà fait.

* Ouvrez le projet avec Visual Studio 2017 ou une version ultérieure. Cela devrait déclencher automatiquement le téléchargement des dépendances, comme le dernier [package NuGet du SDK du serveur de jeu](https://www.nuget.org/packages/com.playfab.csharpgsdk).

* Compilez et générez **WindowsRunnerCSharpClient.csproj** dans la configuration release x64

* Ouvrez l'invite de commandes et accédez au dossier de sortie de ce projet

* Exécutez WindowsRunnerCSharpClient avec cette ligne de commande, en remplaçant \<TitleId> et \<BuildID> par les valeurs ci-dessus : **dotnet WindowsRunnerCSharpClient.dll --titleId \<TitleId> --buildId \<BuildId>**

Exemple :

```sample code theme={null}
cd C:\Users\UserName\Documents\GitHub\MpsSamples\WindowsRunnerCSharp\WindowsRunnerCSharpClient\bin\Release\netcoreapp3.1

dotnet WindowsRunnerCSharpClient.dll --titleId CBE66 --buildId 36083326-3bd5-4b8f-a97d-7e82f066aa40 --verbose
```

Lorsque le client se connecte au serveur avec succès, l'invite de commandes affiche un message de journal vous informant qu'un serveur a été alloué avec une adresse IP.

## Voir aussi

* [Créer votre premier serveur](/fr-CA/services/playfab/multiplayer/servers/create-your-first-server)
* [Ressources et exemples](/fr-CA/services/playfab/multiplayer/servers/server-samples-resources)
* [SDK PlayFab Multiplayer Server](/fr-CA/services/playfab/multiplayer/servers/server-sdks/overview)
* [Référence de l'API](xref:titleid.playfabapi.com.multiplayer.multiplayerserver)


## Related topics

- [Procédure pas à pas : déployer des builds à l'aide de Game Manager](/fr-CA/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager.md)
- [Procédure pas à pas : déployer des builds à l'aide de PowerShell/de l'API](/fr-CA/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-api-powershell.md)
- [Déployer des builds à l'aide de Game Manager](/fr-CA/services/playfab/multiplayer/servers/deploy-using-game-manager.md)
- [Exemples et ressources Multiplayer Servers](/fr-CA/services/playfab/multiplayer/servers/server-samples-resources.md)
- [Exemple Wrapper](/fr-CA/services/playfab/multiplayer/servers/wrapper-sample.md)