Procédure pas à pas : déployer des builds à l'aide de PowerShell/de l'API

Cette rubrique explique comment déployer ou créer des builds de machines virtuelles sous système d’exploitation Windows dans PowerShell, sur un appareil de développement Windows 10, à partir de l’exemple Windows Runner C#.

Pour utiliser et afficher PlayFab Multiplayer Servers, vous devez activer la fonctionnalité. Nous vous recommandons d’utiliser la méthode Game Manager pour activer cette fonctionnalité. Pour obtenir des instructions, consultez Activer la fonctionnalité PlayFab Server.

Prérequis

Assurez-vous d’avoir effectué les étapes suivantes.

1. Obtenir l’ID de votre titre et la clé secrète de développeur

Obtenez l’ID de votre titre PlayFab
- Connectez-vous à votre compte de développeur sur PlayFab.com
- Dans Game Manager, accédez à la page My Studios and Titles. Recherchez votre titre de jeu et récupérez l’ID de titre de jeu PlayFab
Obtenez la clé secrète de développeur du titre
- Dans Game Manager, sélectionnez votre titre > paramètres (icône d’engrenage)
- Sélectionnez Title settings, puis l’onglet Secret Keys pour obtenir la clé secrète de développeur

Pour plus d’informations sur les clés secrètes, consultez Gestion des clés secrètes

2. Installer le module PowerShell PlayFab Multiplayer

Ouvrez Windows PowerShell en tant qu’administrateur et exécutez la commande suivante pour installer le module PlayFabMultiplayer API. Ce nouveau module PlayFabMultiplayer API remplace le module Multiplayer PowerShell déprécié. Si vous avez déjà installé le module PlayFab Multiplayer Powershell, désinstallez-le à l’aide de la commande suivante. Si vous passez au nouveau module, consultez Mappage des commandes pour trouver les nouvelles commandes équivalentes.

Uninstall-Package PlayFabMultiplayer

Les commandes et les arguments sont différents dans ce nouveau module. Pour obtenir une documentation détaillée sur chaque commande, consultez la documentation des cmdlets.

Install-Module -Name PlayFabMultiplayerApi

Avant d’installer le module, vous devrez peut-être d’abord définir votre stratégie d’exécution à l’aide de Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser. Pour en savoir plus, consultez Stratégies d’exécution PowerShell.

3. Obtenir un EntityToken pour votre titre

Dans la fenêtre PowerShell, exécutez la commande suivante avec l’ID de votre titre et la clé de développeur associée :

Set-PfTitle -TitleID "mytitleID" -SecretKey "mysecretkey"

4. Charger des ressources

Lorsque vous déployez des serveurs Windows, vous utilisez le conteneur Windows managé. Il vous suffit de charger la build de serveur de jeu multijoueur PlayFab en tant que ressource. Mettez à jour la valeur de l’indicateur FilePath avec l’emplacement local du fichier winrunnerSample.zip. Si vous ne savez pas où se trouve ce fichier, suivez les instructions ici pour l’obtenir.

New-PfAsset -FilePath C:\windowsRunnerCSharp.zip -AssetName windowsRunnerCSharp.zip

5. Créer une build

Maintenant que la ressource est chargée, nous pouvons créer une build. Exécutez les commandes suivantes. Le code ci-dessous utilise la machine virtuelle Standard_D2as_v4 dans la région EastUS. Remplacez les chaînes en fonction de la machine virtuelle et de la région que vous souhaitez utiliser.

$vmSize = "Standard_D2as_v4"

$regions = @( @{ StandbyServers = 1; MaxServers = 1; Region = 'EastUS'; ScheduledStandbySettings = $NULL } )

$ports = @( @{ Name = 'game_port'; Num = 3600; Protocol = 'TCP' } )

$gameAssets = @( @{ FileName = 'windowsRunnerCSharp.zip'; MountPath = 'C:\Assets' } )

$buildResponse = New-PfBuild -BuildName PSTest_build -ContainerFlavor ManagedWindowsServerCore -StartMultiplayerServerCommand 'C:\Assets\WindowsRunnerCSharp.exe' -GameAssetReferences $gameAssets -VMSize $vmSize -MultiplayerServerCountPerVM 1 -Ports $ports -RegionConfigurations $regions

# All PlayFabMultiplayerApi cmdlets return objects, so we can pass the returned object to ConvertTo-Json for human readability.
$buildResponse | ConvertTo-Json -depth 5

Vérifier que votre build a réussi

Au bout de quelques secondes, vous devriez voir la build créée via PowerShell ou l’API ListBuildSummaries. Vous pouvez également exécuter la commande suivante pour vérifier que la build a été déployée correctement.

Get-PfBuild | ConvertTo-Json -depth 5

XBOX Services

PlayFab

Procédure pas à pas : déployer des builds à l'aide de PowerShell/de l'API

Prérequis

1. Obtenir l’ID de votre titre et la clé secrète de développeur

2. Installer le module PowerShell PlayFab Multiplayer

3. Obtenir un EntityToken pour votre titre

4. Charger des ressources

5. Créer une build

Vérifier que votre build a réussi

Voir aussi

​Prérequis

​1. Obtenir l’ID de votre titre et la clé secrète de développeur

​2. Installer le module PowerShell PlayFab Multiplayer

​3. Obtenir un EntityToken pour votre titre

​4. Charger des ressources

​5. Créer une build

​Vérifier que votre build a réussi

​Voir aussi

Prérequis

1. Obtenir l’ID de votre titre et la clé secrète de développeur

2. Installer le module PowerShell PlayFab Multiplayer

3. Obtenir un EntityToken pour votre titre

4. Charger des ressources

5. Créer une build

Vérifier que votre build a réussi

Voir aussi