本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：建立用於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供 稍後新增玩家，並提供一些遊戲工作階段資料。

```
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) 物件，其涵蓋您所請求的配對建構器設定。新的配對建構器已準備好接受配對請求。

------