# 使用の準備

> Install and configure the Unity Gaming Services Software Development Kit plug-in for Unreal Engine.

Unity Gaming Services SDK プラグインのインストールと設定の手順は以下のとおりです。プロジェクトに Unity Gaming Services SDK をインストールして設定すると、Unity Matchmaker に必要な [C++](./integrate-using-cpp.md) または [ブループリント](./integrate-using-blueprints.md) を使用できるようになります。

### 中身##what's-included

Unity Gaming Services SDK は、Unity の 3 つのサービスを 1 つのプラグインにまとめたものです。

* [Unity Authentication](/authentication.md)
* [Unity Matchmaker](/matchmaker.md)
* [Unity Multiplay Hosting](https://www.rocketscience.gg/multiplay/)

### 要件を把握する##understand-the-requirements

Unreal Engine 用 Matchmaker SDK プラグインは、Unreal Engine バージョン 4.27 から 5.3 までをサポートしています。

> **Warning:**
>
> **重要**: Unity Matchmaker は現在、[Unity Multiplay Hosting](https://www.rocketscience.gg/multiplay/) を使用してホストされている専用サーバーを宛先としたプレイヤーのマッチメイキングのみをサポートしています。Multiplay Hosting の利用には、料金が発生することがあります。料金の詳細については、[料金](https://unity.com/solutions/gaming-services/pricing) のページを参照してください。

> **Warning:**
>
> **重要**: Unity Matchmaker では、サーバーでのイベントを処理するために Centrifuge というプロトコルを使用しています。これは、`MatchmakerServer` というプラグインモジュールの中にあります。Centrifuge は、PC 以外のプラットフォームではサポートされていません。`.uproject` ファイルで複数のゲームモジュールと `TargetAllowList` を使用しているクライアントビルドから、`MatchmakerServer` モジュールを削除してください。

## Matchmaker SDK のダウンロード##download-the-matchmaker-sdk

### Unreal Engine Marketplace ウェブサイトから##from-the-unreal-engine-marketplace-website

1. [Unreal Engine Marketplace](https://www.unrealengine.com/marketplace/en-US/store) にサインインします。

2. [Marketplace の Unity Gaming Services SDK for Unreal Engine](https://www.unrealengine.com/marketplace/en-US/product/unity-gaming-services-sdk-for-unreal-engine) のページにアクセスします。


   **Frame:**
   ![Marketplace の Unity Gaming Services SDK for Unreal Engine のページ](/api/media?file=/matchmaker/media/images/unreal-ugs-marketplace-page.png)

3. **Open in Launcher** (ランチャーで開く) を選択します。

4. [Epic Games Launcher から](#from-the-epic-games-launcher) のステップ 4 までスキップします。

### Epic Games Launcher から##from-the-epic-games-launcher

1. Epic Games Launcher にサインインします。
2. Epic Games Launcher で、**Unity Gaming Services SDK for Unreal Engine** を検索します。


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine の検索](/api/media?file=/matchmaker/media/images/unreal-auth-marketplace-search.png)
3. Unity Gaming Services SDK for Unreal Engine のページにアクセスし、**Free** (無料) を選択します。


   **Frame:**
   ![Launcher の Unity Gaming Services SDK for Unreal Engine のページ](/api/media?file=/matchmaker/media/images/unreal-ugs-epic-launcher-page.png)
4. Epic Games Launcher で **Install to Engine** (エンジンにインストール) を選択します。


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine のインストールボタン](/api/media?file=/matchmaker/media/images/unreal-ugs-marketplace-install.png)
5. 新しいプロジェクトまたは既存のプロジェクトを開きます。
6. Plugins (プラグイン) ウィンドウに移動し、Unity Gaming Services SDK for Unreal Engine の横のチェックボックスをオンにします。


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine プラグインウィンドウ](/api/media?file=/matchmaker/media/images/unreal-ugs-engine-plugin.png)
7. Unreal Engine を再起動します。

> **Note:**
>
> **ノート**: ソースからビルドされたバージョンのエンジンを使用する場合は、以下の手順で Marketplace フォルダーにアクセスできます。
>
> * Windows の場合、デフォルトパスは `C:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Marketplace` です。MacOS と Linux でも同様のパスが使用されます。
> * `UnityGamingServicesSDK` フォルダーをプロジェクトの `Plugins` フォルダーにコピーします。このフォルダーが存在しない場合は、プロジェクトのルートに作成してください。

### Matchmaker SDK の設定##configure-the-matchmaker-sdk

Unity Matchmaker は、Unity Authentication サービスに依存しています (Unity Authentication サービスは、Unity Gaming Services SDK に含まれています)。

Matchmaker API を呼び出し、Matchmaker を使用してプレイヤーを割り当てる前に、[Unity Dashboard](https://cloud.unity.com/) で Unity Matchmaker の設定を調整する必要があります。この手順を経ていないと、マッチメイキングのリクエストがすべて失敗になります。Unity Matchmaker では、[デフォルトプールを備えたキュー](/matchmaker/advanced-topics-queues-pools.md) が少なくとも 1 つ必要です。

#### バックフィルの設定##configure-backfill

バックフィルは、プレイヤー数が最大に満たない既存のマッチにプレイヤーを割り当てられる機能です。詳細は、[バックフィルのドキュメント](/matchmaker/advanced-topics-backfill.md) を参照してください。

バックフィルを使用するにあたっては、Unity Dashboard でキューにバックフィルを有効にしていることを確認する必要があります。

1. [Unity Dashboard](https://cloud.unity.com/) にアクセスし、プロジェクトを選択します。
2. **Multiplayer** (マルチプレイヤー) タブに移動します。
3. **Matchmaker** タブに移動し、**Queues** (キュー) を選択します。
4. 対象の **キュー** を選択します。[プールとキューの作成](/matchmaker/get-started.md#create-a-queue-and-a-pool) を参照してください。
5. **Pools** (プール) タブに移動し、キューで使用するプールを選択します。
6. **Rules** (ルール) タブに移動し、バックフィルを有効にするためのフィールドを見つけたら、**True** (はい) に設定されていることを確認します。

## 次のステップ##what's-next-?

以下のいずれかのインテグレーションに進んでください。

* [C++ インテグレーション](./integrate-using-cpp.md)
* [Blueprint インテグレーション](./integrate-using-blueprints.md)