> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クラウドホスト型 Unreal サーバーへの接続

> 標準的な割り当てをバイパスする開発ユーティリティを使用して、Unreal Engine クライアントを PlayFab Multiplayer Servers (MPS) にホストされた専用サーバービルドに接続します。

# MPS ホスト型ビルドへの接続

この記事では、ユーティリティツールを使用してクライアントを PlayFab Multiplayer Servers (MPS) にホストされたサーバーに接続する方法について説明します。このツールは、サーバーのプロビジョニングとアクティブ化に関する通常の手順をバイパスするために開発中に使用します。このサンプルシーケンスの前のステップでは、標準の ThirdPersonMP チュートリアルプロジェクトに Unreal GSDK を追加する方法を扱いました。それにより、サーバー接続側は設定しましたが、適切なクライアント接続シーケンスは無視していました。PlayFab では、クライアントが接続する前にサーバーがプロビジョニングされアクティブ化されている必要があります。ここではそのプロセスは扱いませんが、詳細については [MPS ドキュメント](/services/playfab/multiplayer/servers/connecting-clients-to-game-servers) を参照してください。代わりに、この例では、これらの複雑な手順をバイパスし、手動のユーティリティを使用してクライアントとサーバー間の接続を迅速にテストします。

## 前提条件

* [MpsSamples リポジトリ](https://github.com/PlayFab/MpsSamples) をクローンまたはダウンロードします
* 「Deployed」ステータスで完全にデプロイされた ThirdPersonMP サーバーで、少なくとも 1 つのサーバーが完全に準備完了し「Standby」モードになっているもの
  * ThirdPersonMP は、このガイドの前のページで [ビルド](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project) および [デプロイ](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment) したサンプルプロジェクトです。
  * ビルドのステータスは、接続を受け付ける準備が整ったサーバーが含まれると「Deployed」になります。これらのサーバーは「Standby」状態にあると見なされます
* 接続準備完了の [ビルド済みゲームクライアント](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project)
* .NET Core 3.1 がインストールされた Visual Studio (Visual Studio Installer のオプションのチェックボックスとして利用可能)

## クライアントをサーバーに自動的に接続する方法

ビルド済みのゲームクライアントは通常 **ThirdPersonMP.exe** で、プロジェクト内またはその近くにあります。ThirdPersonMP を開始テンプレートとして使用しなかった場合、ビルド済みのゲームクライアントは **\{YourProjectName}.exe** となり、同様に Unreal プロジェクト内またはその近くに配置されます。このファイルを見つけてください。

* `ThirdPersonMP.exe` を見つけます
* 隣に新しいファイル `RunCloud.bat` を作成します
* 任意のテキストエディタでこのファイルを開き、次の内容を設定します:

```Batch theme={null}
ThirdPersonMP {IP-ADDRESS}:{PORT} -log
```

注: 必要に応じて `ThirdPersonMP` をプロジェクト名に置き換えてください。

* 現時点では IP-ADDRESS や PORT がまだわからないため、保存してエディタは開いたままにしておきます。
* ファイル `{MpsSamples Repo}/MpsAllocatorSample/MpsAllocatorSample.csproj` を見つけます
* Visual Studio でこのファイルを開きます
* このプログラムを実行します
* 画面の指示に従い、プロンプトで以下の値を入力します:
  * \{Your PlayFab TitleId}
  * \{Any valid and active secret key for your PlayFab Title}
  * **RequestMultiplayerServer** を実行するために **1** を選択します
  * テストしたい **Deployed** ステータスのサーバービルドの \{BuildId} を入力します
    * これは、すべてのビルドの一覧で名前の横、特定のビルドの **Details** タブ、またはビルド固有のページのいずれかの URL で確認できます
  * 複数のリージョンが定義されている場合、いずれかを選択するように求められます。そうでない場合、利用可能なリージョンが 1 つだけであれば自動的に選択されます。
  * Player ID には、実在するか架空の 16 進数値を入力できます
    * ThirdPersonMP のセットアップに従ったユーザーは、1337、abc123 などの任意の 16 進数値を選択できます
    * 少なくとも 1 つの数字を入力し、その後もう一度 Enter キーを押して完了します
* 次のようなレスポンスが返されるはずです:

```json theme={null}
{
  "ConnectedPlayers": [],
  "FQDN": "...",
  "IPV4Address": "52.180.68.101",
  "LastStateTransitionTime": "2021-12-06T22:12:46.212Z",
  "Ports": [
    {
      "Name": "gameport",
      "Num": 30000,
      "Protocol": "UDP"
    }
  ],
  "Region": "WestUs",
  "ServerId": "...",
  "SessionId": "...",
  "State": "Active",
  "VmId": "..."
}
```

* 注: この例で重要でない値は `...` に置き換えられています
* レスポンスの中で **IPV4Address** と **Ports.Num** を探します
  * 上記の例では、これらの値はそれぞれ `52.180.68.101` と `30000` です
  * 実際の値は異なる場合があります
* `RunCloud.bat` ファイルに戻り、IP-ADDRESS と PORT にこれらの値を入力します。例:

```Batch theme={null}
ThirdPersonMP 52.180.68.101:30000 -log
```

* Windows エクスプローラーからこの .bat ファイルをダブルクリックしてゲームクライアントを実行し、少し待ってから再度ダブルクリックします
* これにより、ゲームクライアントの 2 つのインスタンスが起動し、両方がクラウドホストされたゲームサーバーに接続されます
* ここから、両方のゲーム内で動き回ることができ、両方のユーザーの動きと動作が両方のゲームクライアントで両プレイヤーに反映されていることが確認できるはずです
  * 成功です！ これが見られれば、セットアップ/ビルド/デプロイ/接続の全プロセスが完了しています

## ナビゲーション

一部のユーザーにとって、このガイドシーケンスはこれで完了です。メインの [Unreal GSDK Plugin](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk) ガイドに戻ることができます。

Windows サーバーでテストを実行した場合は、より高度な [Linux サーバー](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab) デプロイガイドを試すこともできます。


## Related topics

- [Linux Unreal サーバーの MPS クラウドへのデプロイ](/ja-jp/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab.md)
- [ゲーム サーバーへのクライアントの接続](/ja-jp/services/playfab/multiplayer/servers/connecting-clients-to-game-servers.md)
- [ゲーム サーバーのローカル デバッグと PlayFab との統合](/ja-jp/services/playfab/multiplayer/servers/locally-debugging-game-servers-and-integration-with-playfab.md)
- [GSDK プロジェクトのクラウドデプロイメント](/ja-jp/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment.md)
- [XR-074 XBOX およびパートナー サービスへの接続喪失](/ja-jp/publishing/certification/xr/xr-074.md)