Wrapper サンプル

​

サンプルの内容

• Wrapper—PlayFab Game Server SDK (GSDK) の最新の NuGet パッケージをゲーム サーバーに統合します。このラッパー アプリケーションは 本番使用を目的としたものではありません。
• Fakegame—GSDK に関する知識を持たない基本的なゲーム サーバー。PlayFab Multiplayer Servers を使用する前に持っていた典型的なゲーム サーバーのようなものです。TCP ポート 80 をリッスンする ASP.NET Core Web サーバー Kestrel を起動します。GSDK について全く知識がないゲーム サーバーをシミュレートすることを目的としています。独自のゲーム サーバーをお持ちでない場合に使用できます。使用できる 2 つの GET ルートがあります。/hello は単純な応答を取得するためのもので、/hello/terminate はサーバーを終了できます。

​

要件

• .NET Core 3.1 x64 SDK

​

ウォークスルー

​

Wrapper 実行ファイルの取得とビルド

• 標準の Git メソッドを使用するか zip ファイルとしてダウンロードして、GSDK wrapper サンプル を取得します。
• コマンド プロンプトを開き、cd コマンドで wrapper.csproj ファイルの場所にディレクトリ パスを変更します。例: cd C:/ReplaceWithYourFilePath/wrappingGsdk/wrapper
• 次に、以下の .NET Core CLI コマンドを実行します:

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

​

ゲーム サーバー アセットの作成

​

Fakegame ゲーム サーバーをラッパーと共に使用する

• PowerShell を開きます。
• cd コマンドで build.ps1 スクリプトの場所にディレクトリ パスを変更します。例: cd C:/ReplaceWithYourFilePath/wrappingGsdk/
• \build.ps1 を実行します。
• スクリプトが正常に実行された後、..\wrappingGsdk\drop\ フォルダーに移動します。fake ゲーム サーバー ビルド、ラッパー実行ファイル (前のステップでビルドしたもの)、その他の必要なファイルを含む gameassets.zip ファイルが作成されているのが確認できます。

​

独自のゲーム サーバー ファイルをラッパーと共に使用する

• ラッパー実行ファイルのビルド の手順に従います。
• ラッパーの公開場所 ..\wrappingGsdk\wrapper\bin\Debug\netcoreapp3.1\win-x64\publish に移動します。
• 別のウィンドウで、ゲーム サーバー ビルドとゲーム サーバー ビルドの実行に必要なファイルに移動します。どのファイルが必要か分からない場合は、必要な DLL ファイルの決定 を参照してください。
• ゲーム サーバー ビルドとすべての必要なファイルをラッパーの公開場所にコピーします。
• ラッパーの公開場所のすべてのファイルを選択します。
• すべてのファイルを選択した状態で、右クリックし、送る > 圧縮 (zip) フォルダー を選択します。ラッパーの公開フォルダーを選択して zip に追加しないでください。マッピングが正しくなくなります。

​

Linux コンテナー イメージの作成とアップロード (Linux サーバーのみ)

1. Windows 開発デバイスのセットアップ (任意)
2. PlayFab コンテナー レジストリのサインイン資格情報を取得する
3. 既存の/独自の Dockerfile を使用する この手順は、FakeGame を使用しているか独自のゲーム サーバーを使用しているかによって異なります。
   • FakeGame を使用している場合は、Dockerfile があることを確認します。
   • 独自のゲームを使用している場合や Dockerfile を作成する必要がある場合は、Dockerfile の作成 を参照してください。FakeGame の Dockerfile を出発点として使用できます。
4. Ubuntu など Docker がインストールされた Linux ターミナルを開きます。TAG および ACR 変数の値を実際の値に置き換えます。次に、以下のコマンドを実行します。

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

5. 前のステップで取得したユーザー名とパスワードを入力します。
6. Linux コンテナー イメージをビルドしてアップロードします。

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

​

Game Manager または API を使用してビルドをデプロイする

​

Windows ゲーム サーバーをデプロイする

• Game Manager を使用してサーバーをデプロイおよび構成する
• PowerShell/API を使用してサーバーをデプロイおよび構成する

• 開始コマンド:
  • C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2 を使用します。
  • 独自のゲーム サーバー ビルドを使用している場合は、fakegame.exe をゲーム サーバー実行ファイルの名前に置き換えます。
• ネットワーク構成: 名前: gameport、ポート: 80、プロトコル: TCP
• アセット: FakeGame を使用する場合は、アセットとして gameassets.zip をアップロードします。

​

Linux ゲーム サーバーをデプロイする

• Game Manager を使用してサーバーをデプロイおよび構成する
• PowerShell/API を使用してサーバーをデプロイおよび構成する

• アップロードしたコンテナーを選択します。
• ネットワーク構成: 名前: gameport、ポート: 80、プロトコル: TCP
• アセットのアップロードや Start Command の設定は不要です。

​

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"
                    }
                }
            ]
        ]

​

MPS 上のゲーム サーバーに接続する方法

​

Game Manager を使用する

1. Game Manager にログインします。
2. Multiplayer => Servers ページに移動し、ビルドを選択します。
3. Servers ページに移動し、「Request server」ボタンをクリックします。
4. 次のページで、パブリック IPv4 アドレス と ポート をメモします。
5. curl を使用して http://[IPV4Address]:[Ports->Num]/Hello で接続します。

​

MPS Allocator サンプルを使用する

1. MPS Allocator サンプルをコンパイルして実行します。
2. 「ListBuildSummaries」コマンドを適用して、利用可能なビルドとそれに対応するビルド ID を表示します。
3. 「RequestMultiplayerServer」を呼び出して、ゲーム サーバー インスタンスのリクエストを開始します。
4. 選択したビルド ID を「ListMultiplayerServers」コマンドに入力して、利用可能なサーバーのリストを生成します。
5. アクティブなゲーム サーバー インスタンスを選択し、前のステップで取得したビルドとセッション ID を使用して「GetMultiplayerServerDetails」を実行します。
6. 応答に表示される IPV4Address と Ports->Num をメモします。
7. curl を使用して http://[IPV4Address]:[Ports->Num]/Hello で接続します。

​

関連項目

• 最初のサーバーを作成する
• リソースとサンプル
• PlayFab Multiplayer Server SDK
• API リファレンス