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

# 建立遊戲工作階段佇列
<a name="queues-creating"></a>

佇列用於跨多個機群和位置放置新的遊戲工作階段。您的遊戲會透過向佇列提交放置請求來啟動新的遊戲工作階段。佇列已設定有關如何處理請求的指示。進一步了解如何在 中啟動遊戲工作階段置放請求[建立遊戲工作階段](gamelift-sdk-client-api.md#gamelift-sdk-client-api-create)。

**建立遊戲工作階段佇列**

這些指示說明如何以最少的組態設定和預設設定建立簡單的工作佇列。有多種選項可自訂佇列組態。這些選項可協助您根據遊戲的需求進行最佳的配置。若要進一步了解如何自訂遊戲的佇列，請參閱 [自訂遊戲工作階段佇列](queues-design.md)。您可以隨時更新大多數佇列組態設定。

您可以使用Amazon GameLift Servers主控台或 AWS CLI 建立遊戲工作階段佇列。

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

在 [Amazon GameLift Servers主控台](https://console.aws.amazon.com/gamelift/)中，選取要使用的 AWS 區域。開啟主控台的左側導覽列，然後選擇**佇列**。

1. 在**佇列**頁面上，選擇**建立佇列**以啟動工作流程。

1. 在**佇列設定**下，輸入下列設定：

   1. 輸入佇列名稱。此名稱對於您要建立佇列 AWS 區域 的 必須是唯一的。

   1. 保留預設**逾時**設定，即 600 秒 （或 10 分鐘）。此值控制Amazon GameLift Servers在停止之前嘗試放置新遊戲工作階段的時間長度。 Amazon GameLift Servers會搜尋可用的資源，直到請求逾時為止。您可以隨時更新佇列的逾時設定。

   1. 略過**玩家延遲政策**區段。佇列只會在接收包含玩家延遲資料的置放請求時使用延遲政策。您可以隨時將延遲政策新增至佇列。如需建立延遲政策的詳細資訊，請參閱 [建立玩家延遲政策](queues-design-latency.md)。

1. 略過**遊戲工作階段置放位置**區段，以使用**所有位置**的預設設定。此設定可讓您建立允許清單，列出佇列可以進行置放的位置 （也稱為篩選條件組態）。如需依位置和篩選條件組態排定優先順序的詳細資訊，請參閱 [依位置排定置放的優先順序](queues-design-priority.md#queues-design-priority-custom-location)。

1. 在**目的地順序**下，將一或多個機群新增至佇列。您可以使用機群 IDs 或 ARNs，或使用機群別名來識別機群。新增多個機群時，請記住它們都應該執行類似的遊戲組建，並與使用此佇列的任何遊戲用戶端相容。此外，佇列中的所有機群都必須具有相同的憑證組態。

   1. 選取建立機群或別名**的區域**。對於多位置機群，這是「首頁」區域。

   1. 針對目的地**類型**，選取機群或別名。

   1. 您的區域和類型選擇會填入現有機群或別名的下拉式清單。選擇一個 以指定為佇列目的地。

   1. 若要為佇列指定其他機群或別名，請選擇**新增目的地**並重複上述步驟。

   1. 新增目的地清單後，請使用drag-and-drop功能來重新排序目的地。 會在依目的地排定置放的優先順序時Amazon GameLift Servers使用此順序。

1. 略過**遊戲工作階段置放優先順序**區段，以保留預設優先順序。此設定可讓您自訂 如何Amazon GameLift Servers選擇尋找新遊戲工作階段置放可用託管資源的位置。如需排定置放優先順序的詳細資訊，請參閱 [排定遊戲工作階段放置的優先順序](queues-design-priority.md)。您可以隨時更新佇列的置放優先順序。

1. 在**位置順序**下，保留預設值。依機群位置排定優先順序時，會使用此設定。它提供要使用的位置順序。使用預設優先順序設定時，當偏好的目的地是具有多個位置的機群時，位置會用作繫結器。

1. 略過選用**的事件通知設定**區段。處理大量置放請求的佇列需要事件通知。對於處理低磁碟區的佇列，例如用於開發或測試目的，您可以透過輪詢 [DescribeGameSessionPlacement](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeGameSessionPlacement.html) 來追蹤置放請求的狀態。如需詳細資訊，請參閱[設定遊戲工作階段放置的事件通知](queue-notification.md)。您可以隨時更新佇列的事件通知設定。

1. 選擇**建立**以產生最少自訂的新佇列。

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

**Example 建立佇列**  
下列範例會建立具有這些組態的遊戲工作階段佇列：  
+ 五分鐘逾時。
+ 兩個機群目的地。
+ 篩選以僅允許置放在這些位置：`us-east-1`、`us-east-2`. `us-west-2`和 `ca-central-1`。
+ 根據成本和指定順序中位置的優先順序。

```
aws gamelift create-game-session-queue \
    --name "sample-test-queue" \
    --timeout-in-seconds 300 \
    --destinations DestinationArn="arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-772266ba-8c82-4a6e-b620-a74a62a93ff8" DestinationArn="arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-33f28fb6-aa8b-4867-85b4-ceb217bf5994" \
    --filter-configuration "AllowedLocations=us-east-1, ca-central-1, us-east-2, us-west-2" \
    --priority-configuration PriorityOrder="COST","LOCATION",LocationOrder="us-east-1","us-east-2","ca-central-1","us-west-2" \
    --notification-target "arn:aws:sns:us-east-1:111122223333:gamelift-test.fifo"
```

**注意**  
您可以使用機群或別名 ID 來呼叫 [describe-fleet-attributes](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-fleet-attributes.html) 或 [describe-alias](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-alias.html) 以取得機群與別名 ARN 值。

如果 `create-game-session-queue` 請求成功，Amazon GameLift Servers 即會傳回 [GameSessionQueue](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSessionQueue.html) 物件，其中包含新的佇列組態。您現在可以使用 [StartGameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartGameSessionPlacement.html) 來提交請求到佇列。

**Example 使用玩家延遲政策建立佇列**  
下列範例會建立具有這些組態的遊戲工作階段佇列：  
+ 10 分鐘逾時
+ 三個機群目的地
+ 一組玩家延遲政策

```
aws gamelift create-game-session-queue \
    --name "matchmaker-queue" \
    --timeout-in-seconds 600 \
    --destinations DestinationArn=arn:aws:gamelift:us-east-1::alias/alias-a1234567-b8c9-0d1e-2fa3-b45c6d7e8910 \
               DestinationArn=arn:aws:gamelift:us-west-2::alias/alias-b0234567-c8d9-0e1f-2ab3-c45d6e7f8901 \
               DestinationArn=arn:aws:gamelift:us-west-2::fleet/fleet-f1234567-b8c9-0d1e-2fa3-b45c6d7e8912 \
    --player-latency-policies "MaximumIndividualPlayerLatencyMilliseconds=50,PolicyDurationSeconds=120" \
               "MaximumIndividualPlayerLatencyMilliseconds=100,PolicyDurationSeconds=120" \
               "MaximumIndividualPlayerLatencyMilliseconds=150" \
```

如果 `create-game-session-queue` 請求成功，Amazon GameLift Servers 即會傳回 [GameSessionQueue](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSessionQueue.html) 物件，其中包含新的佇列組態。

------