​

ThirdPersonMP サンプルプロジェクトのローカルデプロイメントとデバッグ

​

目標

• ThirdPersonMP+GSDK プロジェクトのローカルデプロイオプションをテストします。
• LocalMultiplayerAgent を使用して実行したときにサーバーが正しく実行されることを確認します。
• サーバーインスタンスにデバッガーをアタッチできることを確認します。

​

要件

• Visual Studio をダウンロードします。Community 版 は無料です。
  • 必要なワークロード: .NET デスクトップ開発と C++ によるデスクトップ開発
• Unreal Engine のソースコードをダウンロードします。手順については、Unreal Engine ソースコードのダウンロード (外部) を参照してください。
• PlayFab Unreal GSDK をインストールおよび構成した 完了済みの Unreal プロジェクト
• Visual Studio からビルドされたプロジェクトの 「Development Server」 構成
• [オプション] LocalMultiplayerAgent をダウンロードします
  • [オプション] または、LocalMultiplayerAgent ソース をダウンロードします。
• このリポジトリから Visual Studio でビルドされた LocalMultiplayerAgent の「Debug」または「Release」構成
  • Visual Studio を使用して MpsAgent.sln を開き、Debug または Release 構成を選択し、LocalMultiplayerAgent をビルドします。
• [オプション] Docker for Windows をインストールする

​

表記

• {depot}/ThirdPersonMP
• {depot}/MpsAgent
• [オプション] {depot}/gsdk [これには以前 ThirdPersonMP にインストールした PlayFab Unreal GSDK プラグインが含まれます]
• [オプション] {depot}/UnrealMarketplacePlugin [これには PlayFab Unreal Marketplace プラグインが含まれます。このガイドには必要ありませんが、ほとんどの PlayFab 機能に必要です]

​

手順

​

コンテナなしのローカル実行

{
  "RunContainer": false,
  "OutputFolder": "<Local absolute path that will be used to store the required output artifacts>",
  ...
  "AssetDetails": [
    {
      "MountPath": "C:\\Assets",
      "LocalFilePath": "{PATH-TO-ZIP}"
    }
  ],
  ...
  "PortMappingsList": [
    [
      {
        "NodePort": 30000,
        "GamePort": {
          "Name": "gameport",
          "Number": 8888,
          "Protocol": "UDP"
        }
      }
    ]
  ],
  "ProcessStartParameters": {
    "StartGameCommand": "{PATH-TO-EXE} -log"
  },
  "ContainerStartParameters": {
    "StartGameCommand": "C:\\Assets\\ThirdPersonMPServer.exe -log",
    ...
  }
}

• RunContainer: このガイドでは常に false です。true に設定すると Docker が必要になります。
  • true の場合、ProcessStartParameters/StartGameCommand は無視され、代わりに ContainerStartParameters/StartGameCommand が使用されます
  • true の場合、すべてがローカルマシンコンテキストではなく Docker コンテナ内でビルドおよび実行されます
  • このガイドでは、サーバープロセスをより簡単にデバッグできるように RunContainer が false の場合のシナリオを扱います
  • true に設定するには、Shipping Server ビルドと追加の Docker for Windows が必要です
• OutputFolder: "<Local absolute path that will be used to store the required output artifacts>"
  • この場所は完全に定義され、その場所に有効なディレクトリが存在する必要があります。
• AssetDetails/LocalFilePath: {PATH-TO-ZIP}
  • この場所は完全に定義され、その場所に有効な zip ファイルが存在する必要があります
  • この zip ファイルには、完全に構築された「Shipping Server」ビルドが含まれている必要があります
• PortMappingsList:
  • これは Game Manager でポートを定義することの LocalMultiplayerAgent 版に相当します
  • GSDK プラグインは、gameport という名前のポートを探すようにハードコードされています
  • GSDK プラグインの SetDefaultServerHostPort メソッドは、内部の Unreal サーバーホスティングポートをこのポートに合わせるよう内部的にオーバーライドします
  • GSDK プラグインは、LocalMultiplayerAgent を使用するとき、PortMappingsList で構成された gameport という名前のポート のみ を使用します。
  • この json により、MPS からこのポート番号を駆動することをローカルでテストでき、GSDK プラグインが正しく受信することが保証されます
• ContainerStartParameters/StartGameCommand: RunContainer が false の場合、これは使用されません。
  • RunContainer==true の場合、ProcessStartParameters/StartGameCommand に優先します
  • このパスは Docker コンテナ内の内部パスで、AssetDetails/MountPath と AssetDetails/LocalFilePath で定義された zip ファイル内の exe への内部パスの合計になります
  • この例では次のようになります: C:\\Assets\\ThirdPersonMPServer.exe -log
• ProcessStartParameters/StartGameCommand: このコマンドは実質的に exe へのパスと、ゲームサーバーを起動するために使用されるコマンドライン引数になります
  • -log は、ゲームサーバーに実行ログを保存するよう指示する Unreal のコマンドです
  • {PATH-TO-EXE} は次の 2 つの選択肢のいずれかになります:
    • ゲームサーバー (開発ゲームサーバーを含む) の exe への任意の絶対パス、およびサーバーの任意のコマンドラインパラメータ
      • この選択肢では、zip ファイルの内容は無視され、代わりに任意の場所の任意の exe が実行されます
      • これはローカルデバッグオプションで、開発ビルドをデバッグするためのローカルマシンでのみ動作します: MPS にアップロードする zip ファイルの準備ができているかを確認するのには役立ちません
      • この選択肢は、開発サーバーをテストする際に使用し、VS デバッガーをアタッチするのに適しています
      • この例では次のようになります: {depot}\\ThirdPersonMP\\Binaries\\Win64\\ThirdPersonMPServer.exe -log
      • 著者の場合は次のとおりです: M:\\depot\\GSDK\\ThirdPersonMPGSDK\\Binaries\\Win64\\ThirdPersonMPServer.exe -log
    • サーバーを実行するために zip ファイル内への相対パスを示す相対パス
      • これは、MPS クラウドインスタンスでの動作を反映する標準のワークフローです
      • この選択肢は、shipping サーバーをテストする際に使用し、zip が MPS へのアップロード準備完了であることを検証するのに役立ちます
      • この例では次のようになります: ThirdPersonMPServer.exe -log

​

サーバーのデバッグ

​

トラブルシューティング

​

Task Manager に複数の ThirdPersonMPServer インスタンス

​

LocalMultiplayerAgent が 2 つの ThirdPersonMPServer インスタンスを起動する

​

次のステップ