

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

# ゲームセッションキューを作成する
<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. **[送信先の順序]** で、キューに 1 つ以上のフリートを追加します。フリートを識別するには、フリート ID または ARN、またはフリートエイリアスを使用します。複数のフリートを追加する場合、それらはすべて同様のゲームビルドを実行し、このキューを使用するゲームクライアントと互換性がある必要があることに注意してください。さらに、キュー内のすべてのフリートに対して同じ証明書設定が必要です。

   1. フリートまたはエイリアスが作成された**リージョン**を選択します。マルチロケーションフリートの場合、これは「ホーム」リージョンです。

   1. 送信先**タイプ**で、フリートまたはエイリアスを選択します。

   1. リージョンとタイプの選択により、既存のフリートまたはエイリアスのドロップダウンリストが入力されます。キューの送信先として指定するものを選択します。

   1. キューに別のフリートまたはエイリアスを指定するには、**[送信先の追加]** を選択し、前のステップを繰り返します。

   1. 送信先のリストを追加したら、ドラッグアンドドロップ機能を使用して送信先の順序を変更します。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 キューを作成する**  
次の例では、これらの設定を使用してゲームセッションキューを作成します。  
+ 5 分のタイムアウト。
+ 2 つのフリートの送信先。
+ フィルタリングして、次の場所への配置のみを許可します: `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"
```

**注記**  
フリートおよびエイリアス ARN の値を取得するには、フリートまたはエイリアス 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) を呼び出します。

`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 分のタイムアウト
+ 3 つのフリートの送信先
+ プレイヤーレイテンシーポリシーのセット

```
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) オブジェクトを返します。

------