翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ゲームクライアントへの FlexMatch の追加
<a name="match-client"></a>

このトピックでは、ゲームクライアントサービスに FlexMatch マッチメーキング機能を追加する方法について説明します。

ゲームクライアントがバックエンドのゲームサービスを通してゲームクライアントのマッチメーキングリクエストを行うことを強くお勧めします。Amazon GameLift Servers サービスとの通信にこの信頼できるソースを使用することで、ハッキングの試みや不正なプレイヤーデータからより簡単に保護できます。ゲームがセッションディレクトリサービスを使用している場合、これはマッチメーキングリクエストを処理するための優れたオプションです。Amazon GameLift Servers ホスティング FlexMatch およびスタンドアロンサービスとして Amazon GameLift Servers を使用する場合、サービスへのすべての呼び出しにバックエンドゲームサービスを使用することがベストプラクティスです。

Amazon GameLift Servers マネージドホスティングで FlexMatch を使用している場合も、別のホスティングソリューションでスタンドアロンサービスとして を使用している場合も、クライアント側の更新が必要です。 AWS SDK の一部である のサービス API を使用してAmazon GameLift Servers、次の機能を追加します。
+ 1 人以上のプレイヤーのマッチメーキングのリクエストを準備します (必須)。マッチメーキングルールセットによっては、このリクエストでプレイヤー属性やレイテンシーなど、特定のプレイヤー固有のデータが必要になる場合があります。
+ マッチメーキングリクエストのステータスを追跡します (必須)。一般的に、このタスクではイベント通知を設定する必要があります。
+ プレイヤーによる試合案 (オプション) の承諾をリクエストします。この機能では、マッチングの詳細を表示し、マッチングを承認または拒否するには、プレイヤーとの追加のインタラクションが必要です。
+ ゲームセッション接続情報を取得して、ゲームに参加します (必須)。新しいマッチングのゲームセッションが開始されたら、ゲームセッションの接続情報を取得し、それを使用してゲームセッションに接続します。

## 前提条件となるクライアント側のタスク
<a name="match-client-setup"></a>

ゲームにクライアント側の機能を追加する前に、以下のタスクを実行する必要があります。
+ ** AWS SDK をバックエンドサービスに追加します。**バックエンドサービスは AWS SDK の一部である Amazon GameLift Servers API の機能を使用します。[Amazon GameLift Servers SDKs「 SDK for client services](https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-supported.html#gamelift-supported-clients)」を参照してください。 AWS API の説明と機能については、「[Amazon GameLift Servers FlexMatch API リファレンス (AWS SDK)](reference-awssdk-flex.md)」を参照してください。
+ **マッチメーキングチケットシステムをセットアップします。**すべてのマッチメーキングリクエストに一意のチケット ID を割り当てる必要があります。一意のチケット ID を生成し、それを新しいマッチリクエストに割り当てるメカニズムが必要です。チケット ID には、最大 128 文字の文字列形式を使用できます。
+ **マッチメーカーに関する情報を収集します。**マッチメーキング設定とルールセットから次の情報を取得します。
  + マッチメーキング設定リソースの名前。
  + ルールセットで定義されているプレイヤー属性のリスト。
+ **プレイヤーデータを取得します。**マッチメーキングリクエストに含める各プレイヤーの関連データを取得する方法を設定します。プレイヤー ID とプレイヤー属性値が必要です。ルールセットにレイテンシルールが含まれている場合、またはゲームセッション配置時にレイテンシデータを使用する場合は、プレイヤーがゲームに配置される可能性のある各地理的ロケーションのレイテンシデータを収集してください。正確なレイテンシー測定値を取得するには、Amazon GameLift Servers の UDP ping ビーコンを使用します。これらのエンドポイントを使用すると、プレイヤーデバイスと潜在的な各ホスティングロケーション間の実際の UDP ネットワークレイテンシーを測定できるため、ICMP ping を使用するよりも正確な配置決定を行うことができます。UDP ping ビーコンを使用してレイテンシーを測定する方法の詳細については、「[UDP ping ビーコン](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/reference-udp-ping-beacons.html)」を参照してください。