Exemple Wrapper

​

Contenu de l’exemple

• Wrapper—intègre le dernier package NuGet du SDK du serveur de jeu PlayFab (GSDK) à votre serveur de jeu. Cette application wrapper n’est pas destinée à une utilisation en production
• Fakegame—un serveur de jeu de base qui n’a aucune connaissance du GSDK. Il ressemble au serveur de jeu type dont vous disposeriez avant d’utiliser PlayFab Multiplayer Servers. Il démarre le serveur web ASP.NET Core Kestrel, qui écoute sur le port TCP 80. Il est conçu pour simuler un serveur de jeu qui n’a absolument aucune connaissance du GSDK. Vous pouvez l’utiliser si vous ne disposez pas de votre propre serveur de jeu. Il propose deux routes GET utilisables : /hello pour obtenir une réponse simple et /hello/terminate pour arrêter le serveur.

​

Exigences

• SDK .NET Core 3.1 x64

​

Procédure pas à pas

​

Obtenir et générer l’exécutable Wrapper

• Obtenez l’exemple de wrapper GSDK à l’aide des méthodes Git standard ou en le téléchargeant sous forme de fichier zip
• Ouvrez l’invite de commandes et utilisez la commande cd pour accéder à l’emplacement du fichier wrapper.csproj. Exemple : cd C:/ReplaceWithYourFilePath/wrappingGsdk/wrapper
• Exécutez ensuite la commande CLI .NET Core suivante :

dotnet publish --self-contained -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true

​

Créer une ressource de serveur de jeu

​

Utiliser le serveur de jeu Fakegame avec le wrapper

• Ouvrez PowerShell
• Utilisez la commande cd pour accéder à l’emplacement du script build.ps1. Exemple : cd C:/ReplaceWithYourFilePath/wrappingGsdk/
• Exécutez \build.ps1
• Une fois le script exécuté avec succès, accédez au dossier ..\wrappingGsdk\drop. Vous y trouverez un fichier gameassets.zip contenant la build du faux serveur de jeu, l’exécutable wrapper (généré à l’étape précédente) et les autres fichiers requis.

​

Utiliser vos propres fichiers de serveur de jeu avec le wrapper

• Suivez les instructions de Générer l’exécutable wrapper
• Accédez à l’emplacement de publication du wrapper : ..\wrappingGsdk\wrapper\bin\Debug\netcoreapp3.1\win-x64\publish
• Dans une autre fenêtre, accédez à la build de votre serveur de jeu et aux fichiers nécessaires à son exécution. Si vous ne savez pas quels fichiers sont nécessaires, consultez Déterminer les fichiers DLL nécessaires
• Copiez la build du serveur de jeu et tous les fichiers requis dans l’emplacement de publication du wrapper
• Sélectionnez tous les fichiers de l’emplacement de publication du wrapper
• Avec tous les fichiers sélectionnés, cliquez avec le bouton droit, puis sélectionnez Send to > Compressed (zip) files to zip. Ne sélectionnez pas le dossier de publication du wrapper pour l’ajouter au zip, car cela entraînerait un mappage incorrect.

​

Créer et charger une image de conteneur Linux (serveurs Linux uniquement)

1. Configurer votre appareil de développement Windows (facultatif)
2. Obtenir les informations d’identification de connexion à votre registre de conteneurs PlayFab
3. Utiliser un Dockerfile existant ou créer le vôtre Cette étape diffère selon que vous utilisez FakeGame ou votre propre serveur de jeu.
   • Si vous utilisez FakeGame, vérifiez que vous disposez du Dockerfile
   • Si vous utilisez votre jeu ou devez créer un Dockerfile, consultez Créer votre Dockerfile. Vous pouvez utiliser le Dockerfile de FakeGame comme point de départ.
4. Ouvrez votre terminal Linux sur lequel Docker est installé, par exemple Ubuntu. Remplacez les valeurs des variables TAG et ACR par vos propres valeurs. Exécutez ensuite les commandes ci-dessous.

TAG="0.1"
ACR="customer5555555.azurecr.io"
docker login ${ACR}

5. Saisissez le nom d’utilisateur et le mot de passe obtenus à l’étape précédente.
6. Générez et chargez l’image de conteneur Linux.

docker build -t ${ACR}/wrapper:${TAG} .
docker push ${ACR}/wrapper:${TAG}

​

Déployer une build à l’aide de Game Manager ou de l’API

​

Déployer des serveurs de jeu Windows

• Utiliser Game Manager pour déployer et configurer des serveurs
• Utiliser PowerShell/l’API pour déployer et configurer des serveurs

• Commande de démarrage :
  • Utilisez C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2
  • Remplacez fakegame.exe par le nom de l’exécutable de votre serveur de jeu, si vous utilisez votre propre build de serveur de jeu
• Configuration réseau : Name : gameport, Port : 80, Protocol : TCP
• Ressources : si vous utilisez FakeGame, chargez gameassets.zip en tant que ressource.

​

Déployer des serveurs de jeu Linux

• Utiliser Game Manager pour déployer et configurer des serveurs
• Utiliser PowerShell/l’API pour déployer et configurer des serveurs

• Sélectionnez le conteneur que vous avez chargé
• Configuration réseau : Name : gameport, Port : 80, Protocol : TCP
• Inutile de charger des ressources et de définir Start Command

​

Exécution du wrapper à l’aide de LocalMultiplayerAgent

"AssetDetails": [
    {
        "MountPath": "C:\\Assets",
        "SasTokens": null,
        "LocalFilePath": "C:\\projects\\gsdkSamples\\wrappingGsdk\\drop\\gameassets.zip"
    }
],
"StartGameCommand": "C:\\Assets\\wrapper.exe -g C:\\Assets\\fakegame.exe",

// if you are using fakegameserver you should also configure port mapping for port 80
"PortMappingsList": [
            [
                {
                    "NodePort": 56100,
                    "GamePort": {
                        "Name": "gameport",
                        "Number": 80,
                        "Protocol": "TCP"
                    }
                }
            ]
        ]

​

Se connecter à un serveur de jeu sur MPS

​

Utiliser Game Manager

1. Connectez-vous à Game Manager
2. Accédez à la page Multiplayer => Servers, puis sélectionnez votre build
3. Accédez à la page Servers, puis cliquez sur le bouton “Request server”.
4. Sur la page suivante, notez l’adresse IPv4 publique et le Port.
5. Utilisez curl pour vous connecter à http://[IPV4Address]:[Ports->Num]/Hello.”

​

Utiliser l’exemple MPS Allocator

1. Compilez et exécutez l’exemple MPS Allocator.
2. Utilisez la commande “ListBuildSummaries” pour afficher les builds disponibles et leurs ID de build correspondants.
3. Appelez “RequestMultiplayerServer” pour lancer une demande d’instance de serveur de jeu.
4. Saisissez l’ID de build sélectionné dans la commande “ListMultiplayerServers” pour générer la liste des serveurs disponibles.
5. Choisissez une instance de serveur de jeu active, puis utilisez “GetMultiplayerServerDetails” avec les ID de build et de session obtenus aux étapes précédentes.
6. Notez les valeurs IPV4Address et Ports->Num affichées dans la réponse.
7. Utilisez curl pour vous connecter à http://[IPV4Address]:[Ports->Num]/Hello.

​

Voir aussi

• Créer votre premier serveur
• Ressources et exemples
• SDK PlayFab Multiplayer Server
• Référence de l’API