

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

# マッチメーキング設定の作成
<a name="match-create-configuration"></a>

Amazon GameLift Servers FlexMatch マッチメーカーをセットアップしてマッチメーキングリクエストを処理するには、マッチメーキング設定を作成します。Amazon GameLift Servers コンソールまたは AWS Command Line Interface () を使用しますAWS CLI。マッチメーカーの作成方法の詳細については、「[FlexMatch マッチメーカーの設計](match-configuration.md)」を参照してください。

**Topics**
+ [チュートリアル: Amazon GameLift Servers ホスティングのマッチメーカーを作成する](match-create-configuration-withqueue.md)
+ [チュートリアル: スタンドアロン FlexMatch のマッチメーカーを作成する](match-create-configuration-standalone.md)
+ [チュートリアル: マッチメーキング設定を編集する](match-create-configuration-edit.md)

# チュートリアル: Amazon GameLift Servers ホスティングのマッチメーカーを作成する
<a name="match-create-configuration-withqueue"></a>

マッチメーキング設定を作成する前に、マッチメーカーで使用する[ルールセット](match-create-ruleset.md)とAmazon GameLift Servers[ゲームセッションキュー](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/queues-creating.html)を作成します。

------
#### [ Console ]

1. [[Amazon GameLift Servers コンソール]](https://console.aws.amazon.com/gamelift/) のナビゲーションペインで、**[マッチメーキング設定]** を選択します。

1. マッチメーカーを作成する AWS リージョンに切り替えます。

1. **[マッチメーキング設定]** ページで **[マッチメーキング設定を作成]** を選択します。

1. **[設定の詳細を定義]** ページの **[マッチメーキング設定の詳細]** で、次の操作を行います。

   1. **[名前]** マッチメーカーをリストとメトリクスで簡単に識別するのに役立つ名前を入力します。マッチメーカー名は、ロケーション内で一意である必要があります。マッチメーキングリクエストでは、どのマッチメーカーを使用するかを、その名前とリージョンで判断します。

   1. (オプション) **[説明]** では、マッチメーカーを識別するのに役立つ説明を追加します。

   1. **[ルールセット]** では、このマッチメーカーで使用するルールセットをリストから選択します。現在のロケーションで作成済みのすべてのルールセットが一覧表示されます。

   1. **FlexMatch モード**の場合は、**マネージド**ホスティングのAmazon GameLift Serversマネージドを選択します。このモードでは、指定されたゲームセッションキューに成功したマッチングを渡すよう FlexMatch に要求します。

   1. **[AWS リージョン]** で、マッチメーカーで使用するゲームセッションキューを設定したリージョンを選択します。

   1. **[キュー]** では、このマッチメーカーで使用するゲームセッションキューを選択します。

1. [**次へ**] を選択します。

1. **[設定を構成]** ページの **[マッチメーキング設定]** で、次の操作を行います。

   1. [**リクエストのタイムアウト**] では、マッチメーカーが各リクエストでマッチングを完了するまでの最大時間を秒単位で設定します。FlexMatch は、この時間を超えるマッチメーキングリクエストをキャンセルします。

   1. **[バックフィルモード]** では、マッチバックフィルを処理するモードを選択します。
      + 自動バックフィル機能を有効にするには、**[自動]** を選択します。
      + 独自のバックフィルリクエスト管理を作成する場合や、バックフィル機能を使用しない場合は、**[手動]** を選択します。

   1. (オプション) [**追加プレイヤー数**] では、マッチ中に空けておくプレイヤースロットの数を設定します。FlexMatch は将来的にこれらのスロットにプレイヤーを追加できます。

   1. (オプション) **[マッチングの承諾オプション]** の **[承諾が必要]** では、マッチング案の各プレイヤーに対してマッチングへの参加を積極的に承諾することを要求する場合、**[必須]** を選択します。このオプションを選択した場合は、**[承諾のタイムアウト]** で、マッチングをキャンセルするまでにマッチメーカーがプレイヤーの承諾を待機する時間を指定します。

1. (オプション) **[イベント通知の設定]** で、次の操作を行います。

   1. (オプション) **[SNS トピック]** で、マッチメーキングイベント通知を受信するための Amazon Simple Notification Service (Amazon SNS) トピックを選択します。SNS トピックをまだ設定していない場合は、後でマッチメーキング設定を編集して、これを追加できます。詳細については、「[FlexMatch イベント通知をセットアップする](match-notification.md)」を参照してください。

   1. (オプション) **[カスタムイベントデータ]** では、イベントメッセージングで、このマッチメーカーと関連付けるすべてのイベントFlexMatch に含まれます。

1. (オプション) **[追加のゲームデータ]** を展開し、次の操作を実行します。

   1. (オプション) **[ゲームセッションデータ]** では、このマッチメーキング設定を使用して行われたマッチで開始される新しいゲームセッションに FlexMatch が配信する追加のゲーム関連情報を提供します。

   1. (オプション) **[ゲームプロパティ]** には、新しいゲームセッションに関する情報を含むキーと値のペアのプロパティを追加します。

1. (オプション) **タグ**の下に、 AWS リソースの管理と追跡に役立つタグを追加します。

1. [**次へ**] を選択します。

1. **[確認および作成]** ページで、選択内容を認し、**[データストアを作成]** を選択します。マッチメーカーが正常に作成されると、マッチメーキングリクエストをすぐに受け入れ可能になります。

------
#### [ AWS CLI ]

を使用してマッチメーキング設定を作成するには AWS CLI、コマンドラインウィンドウを開き、[create-matchmaking-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-matchmaking-configuration.html) コマンドを使用して新しいマッチメーカーを定義します。

このコマンド例では、プレイヤーの承諾を要求して自動バックフィルを有効にする、新しいマッチメーキング設定を作成します。また、FlexMatch 用に 2 つのプレイヤースロットを予約して、ゲーム セッションデータを提供します。

```
aws gamelift create-matchmaking-configuration \
    --name "SampleMatchamker123" \
    --description "The sample test matchmaker with acceptance" \
    --flex-match-mode WITH_QUEUE \
    --game-session-queue-arns "arn:aws:gamelift:us-west-2:111122223333:gamesessionqueue/MyGameSessionQueue" \
    --rule-set-name "MyRuleSet" \
    --request-timeout-seconds 120 \
    --acceptance-required \
    --acceptance-timeout-seconds 30 \
    --backfill-mode AUTOMATIC \
    --notification-target "arn:aws:sns:us-west-2:111122223333:My_Matchmaking_SNS_Topic" \
    --additional-player-count 2 \
    --game-session-data "key=map,value=winter444"
```

マッチメーキング設定の作成リクエストが成功すると、マッチメーカーにリクエストした設定が含まれている [MatchmakingConfiguration](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_MatchmakingConfiguration.html) オブジェクトが Amazon GameLift Servers から返されます。新しいマッチメーカーは、マッチメーキングリクエストを受け入れ可能になります。

------

# チュートリアル: スタンドアロン FlexMatch のマッチメーカーを作成する
<a name="match-create-configuration-standalone"></a>

マッチメーキング設定を作成する前に、マッチメーカーで使用する[ルールセットを作成](match-create-ruleset.md)して、マッチメーカーと使用します。

------
#### [ Console ]

1. [https://console.aws.amazon.com/gamelift/home](https://console.aws.amazon.com/gamelift/) でAmazon GameLift Serversコンソールを開きます。

1. マッチメーカーを作成する AWS リージョンに切り替えます。FlexMatch マッチメーキング設定をサポートするリージョンのリストは、「[マッチメーカーのロケーションを選択する](match-configuration-regions.md)」を参照してください。

1. ナビゲーションペインで、[**FlexMatch**]、[**マッチメーキング設定**] を選択します。

1. **[マッチメーキング設定]** ページで **[マッチメーキング設定を作成]** を選択します。

1. **[設定の詳細を定義]** ページの **[マッチメーキング設定の詳細]** で、次の操作を行います。

   1. **[名前]** マッチメーカーをリストとメトリクスで簡単に識別するのに役立つ名前を入力します。マッチメーカー名は、ロケーション内で一意である必要があります。マッチメーキングリクエストでは、どのマッチメーカーを使用するかを、その名前とリージョンで判断します。

   1. (オプション) **[説明]** では、マッチメーカーを識別するのに役立つ説明を追加します。

   1. **[ルールセット]** では、このマッチメーカーで使用するルールセットをリストから選択します。現在のロケーションで作成済みのすべてのルールセットが一覧表示されます。

   1. **FlexMatch モード**の場合は、**スタンドアロン** を選択します。これは、ゲームに Amazon GameLift Servers以外のホスティングソリューションで新しいゲームセッションを開始するためのカスタムメカニズムがあることを示しています。

1. [**次へ**] を選択します。

1. **[設定を構成]** ページの **[マッチメーキング設定]** で、次の操作を行います。

   1. **[リクエストのタイムアウト]** では、マッチメーカーが各リクエストでマッチングを完了するまでの最大時間を秒単位で設定します。この時間を超えたマッチメーキングリクエストは拒否されます。

   1. (オプション) **[マッチングの承諾オプション]** の **[承諾が必要]** では、マッチング案の各プレイヤーに対してマッチングへの参加を積極的に承諾することを要求する場合、**[必須]** を選択します。このオプションを選択した場合は、**[承諾のタイムアウト]** で、マッチングをキャンセルするまでにマッチメーカーがプレイヤーの承諾を待機する時間を指定します。

1. (オプション) **[イベント通知の設定]** で、次の操作を行います。

   1. (オプション) **[SNS トピック]** で、マッチメーキングイベント通知を受信するための Amazon SNS トピックを選択します。SNS トピックをまだ設定していない場合は、後でマッチメーキング設定を編集して、これを追加できます。詳細については、「[FlexMatch イベント通知をセットアップする](match-notification.md)」を参照してください。

   1. (オプション) **[カスタムイベントデータ]** では、イベントメッセージングで、このマッチメーカーと関連付けるすべてのイベントFlexMatch に含まれます。

1. (オプション) **タグ**の下に、 AWS リソースの管理と追跡に役立つタグを追加します。

1. [**次へ**] を選択します。

1. **[確認および作成]** ページで、選択内容を認し、**[データストアを作成]** を選択します。マッチメーカーが正常に作成されると、マッチメーキングリクエストをすぐに受け入れ可能になります。

------
#### [ AWS CLI ]

を使用してマッチメーキング設定を作成するには AWS CLI、コマンドラインウィンドウを開き、[create-matchmaking-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-matchmaking-configuration.html) コマンドを使用して新しいマッチメーカーを定義します。

このコマンド例では、プレイヤーの承諾を要求して自動バックフィルを有効にする、新しいマッチメーキング設定を作成します。

```
aws gamelift create-matchmaking-configuration \
    --name "SampleMatchamker123" \
    --description "The sample test matchmaker with acceptance" \
    --flex-match-mode STANDALONE \
    --rule-set-name "MyRuleSetOne" \
    --request-timeout-seconds 120 \
    --acceptance-required \
    --acceptance-timeout-seconds 30 \
    --notification-target "arn:aws:sns:us-west-2:111122223333:My_Matchmaking_SNS_Topic"
```

マッチメーキング設定の作成リクエストが成功すると、マッチメーカーにリクエストした設定が含まれている [MatchmakingConfiguration](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_MatchmakingConfiguration.html) オブジェクトが Amazon GameLift Servers から返されます。新しいマッチメーカーは、マッチメーキングリクエストを受け入れ可能になります。

------

# チュートリアル: マッチメーキング設定を編集する
<a name="match-create-configuration-edit"></a>

マッチメーキング設定を編集するには、ナビゲーションバーから **[マッチメーキング設定]** を選択し、編集する設定を選択します。既存の設定のフィールドは、名前以外のどのフィールドでも更新できます。

設定ルールセットを更新する際、有効なマッチメーキングチケットが存在する場合、以下の理由により新しいルールセットは互換性がなくなる可能性があります。
+ 新しいチーム名または異なるチーム名、またはチーム数
+ 新しいプレイヤー属性
+ 既存のプレイヤー属性タイプの変更

ルールセットにこれらの変更を加えるには、更新されたルールセットを使って新しいマッチメーキング設定を作成します。