チュートリアル: PowerShell/API を使用したビルドの展開

[アーティクル]
07/13/2023

このトピックでは、Windows Runner C# サンプルに基づいて、Windows 10 開発デバイス上の PowerShell で Windows OS VM のビルドをデプロイまたは作成する方法について説明します。

注意

PlayFab マルチプレイヤーサーバーを使用して表示するには、機能を有効にする必要があります。ゲームマネージャーメソッドを使用してこの機能を有効にすることをお勧めします。手順については、「PlayFab サーバー機能を有効にする」を参照してください。

前提条件

次の手順が完了していることを確認します。

1. タイトル ID と開発者の秘密鍵を取得する

PlayFab タイトル ID を取得する
- 開発者アカウントで PlayFab.com にログインします。
- ゲームマネージャーで、[My Studios and Titles (自分のスタジオとタイトル)] ページに移動します。ゲームタイトルを探して、PlayFab ゲームタイトル ID を取得する
タイトルの開発者秘密鍵を取得する
- ゲームマネージャーで、[タイトル] > [設定] (歯車アイコン) を選択
- [Title settings (タイトル設定)] を選択して、開発者の秘密鍵を取得するために [Secret Keys (秘密鍵)] タブを選択

秘密鍵については、「秘密鍵の管理」を参照してください。

2. PlayFab マルチプレイヤー PowerShell モジュールをインストールする

管理者として Windows PowerShell を実行し、次のコマンドを実行して PlayFabMultiplayer API モジュールをインストールします。この新しい PlayFabMultiplayer API モジュールは、非推奨のマルチプレイヤー PowerShell モジュールに代わるものとなります。

以前に PlayFab Multiplayer Powershell モジュールをインストールしていた場合は、以下のコマンドでアンインストールしてください。新しいモジュールに移行するために、「マッピングコマンド」を参照して、同等の新しいコマンドをご覧ください。

Uninstall-Package PlayFabMultiplayer

この新しいモジュールでは、コマンドと引数の両方が異なります。各コマンドの詳細については、「Cmdlet documentation (コマンドレットのドキュメント)」参照してください。

Install-Module -Name PlayFabMultiplayerApi

ヒント

モジュールをインストールする前に、まず Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser を使って実行ポリシーを設定する必要があるかもしれません。詳細については、「PowerShell execution policie (powerShell 実行ポリシー)」を参照してください。

3. タイトルの EntityToken を取得する

PowerShell ウィンドウで、タイトル ID とそれに関連付けられているデベロッパーキーを使用して、次のコマンドを実行します。

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

4. Upload assets

Windows サーバーをデプロイする場合は、管理された Windows コンテナーを使用します。必要な操作は、PlayFab マルチプレイヤーゲームサーバービルドをアセットとしてアップロードするだけです。

winrunnerSample.zip のローカルファイルの場所で、FilePath フラグの値を更新します。このファイルがどこにあるかわからない場合は、こちらの手順に従ってファイルを取得します。

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

5. ビルドを作成する

これで、アセットがアップロードされたので、ビルドを作成できます。次のコマンドを実行します。

次のコードは、EastUS リージョンのStandard_D2as_v4 VM を使用しています。使用する VM とリージョンに従って文字列を置き換えます。

$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

ビルドが成功したことを確認する

少し待ってから、PowerShell または ListBuildSummaries API を介して作成されたビルドが表示されます。

次のコマンドを実行して、ビルドが正常にデプロイされたことを確認することもできます。

Get-PfBuild | ConvertTo-Json -depth 5

次の方法で共有