Exemplarische Vorgehensweise: Bereitstellen von Builds mithilfe von PowerShell/API

  • Artikel

In diesem Thema wird beschrieben, wie Sie Builds für windows-Betriebssystem-VMs in PowerShell auf einem Windows 10 Entwicklungsgerät basierend auf dem C#-Beispiel für Windows Runner bereitstellen/erstellen.

Notiz

Um die PlayFab Multiplayer-Server verwenden und anzeigen zu können, müssen Sie das Feature aktivieren. Es wird empfohlen, dass Sie die Game Manager-Methode verwenden, um dieses Feature zu aktivieren. Anweisungen finden Sie unter Aktivieren des PlayFab Server-Features.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben.

1. Abrufen Ihrer Titel-ID und ihres geheimen Entwicklerschlüssels

  • Abrufen Ihrer PlayFab-Titel-ID

    • Melden Sie sich am PlayFab.com bei Ihrem Entwicklerkonto an .
    • Wechseln Sie im Game Manager zur Seite Meine Studios und Titel . Suchen Sie nach Ihrem Spieltitel, und rufen Sie die Titel-ID des PlayFab-Spiels ab.

  • Abrufen des geheimen Entwicklerschlüssels für den Titel

    • Wählen Sie in Game Manager Ihre Titeleinstellungen > (Zahnradsymbol) aus.
    • Wählen Sie Titeleinstellungen und dann die Registerkarte Geheime Schlüssel aus, um den geheimen Entwicklerschlüssel abzurufen.

Weitere Informationen zu geheimen Schlüsseln finden Sie unter Verwaltung geheimer Schlüssel.

2. Installieren des PlayFab Multiplayer PowerShell-Moduls

Öffnen Sie Windows PowerShell als Administrator, und führen Sie den folgenden Befehl aus, um das PlayFabMultiplayer-API-Modul zu installieren. Dieses neue PlayFabMultiplayer-API-Modul ersetzt das veraltete Multiplayer-PowerShell-Modul.

Wenn Sie das PlayFab Multiplayer PowerShell-Modul bereits installiert haben, deinstallieren Sie es mit dem folgenden Befehl. Informationen für diejenigen, die auf das neue Modul umsteigen, finden Sie unter Zuordnungsbefehle , um die neuen entsprechenden Befehle zu finden.

Uninstall-Package PlayFabMultiplayer

Sowohl die Befehle als auch die Argumente unterscheiden sich in diesem neuen Modul. Eine ausführliche Dokumentation zu den einzelnen Befehlen finden Sie in der Cmdlet-Dokumentation.

Install-Module -Name PlayFabMultiplayerApi

Tipp

Vor der Installation des Moduls müssen Sie möglicherweise zuerst Ihre Ausführungsrichtlinie mit Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser festlegen. Weitere Informationen finden Sie unter PowerShell-Ausführungsrichtlinien.

3. Abrufen eines EntityTokens für Ihren Titel

Führen Sie im PowerShell-Fenster den folgenden Befehl mit Ihrer Titel-ID und dem zugehörigen Entwicklerschlüssel aus:

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

4. Hochladen von Ressourcen

Wenn Sie Windows-Server bereitstellen, verwenden Sie den verwalteten Windows-Container. Sie müssen nur den PlayFab Multiplayer Game Server Build als Ressource hochladen.

Aktualisieren Sie den Wert des FilePath-Flags mit dem lokalen Dateispeicherort vonwinrunnerSample.zip. Wenn Sie nicht wissen, wo sich diese Datei befindet, folgen Sie den Anweisungen hier , um die Datei abzurufen.

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

5. Erstellen eines Builds

Nachdem das Medienobjekt hochgeladen wurde, können wir einen Build erstellen. Führen Sie die folgenden Befehle aus.

Im folgenden Code wird die Standard_D2as_v4 VM in der Region EastUS verwendet. Ersetzen Sie Zeichenfolgen entsprechend dem virtuellen Computer und der Region, die Sie verwenden möchten.

$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

Überprüfen, ob der Build erfolgreich war

In wenigen Sekunden wird der Build über die PowerShell - oder ListBuildSummaries-API erstellt.

Sie können auch den folgenden Befehl ausführen, um zu überprüfen, ob der Build erfolgreich bereitgestellt wurde.

Get-PfBuild | ConvertTo-Json -depth 5

Weitere Informationen