

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 教程：为 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 Notiﬁcation Service (Amazon 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 保留了两个玩家位置，以便以后添加玩家，并提供一些游戏会话数据。

```
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"
```

如果配对配置创建请求成功，则Amazon GameLift Servers返回一个包含您为匹配器请求的设置的[MatchmakingConfiguration](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_MatchmakingConfiguration.html)对象。新对战构建器已准备好接受对战请求。

------