ゲームセッションキューを作成する

キューを使用して、複数のフリートおよびリージョン間で最適なホスティングリソースに新規のゲームセッションを配置します。ゲームのキューを構築する方法の詳細については、「ゲームセッションキューの設計」を参照してください。

ゲームクライアントで、配置リクエストを使用して、新規のゲームセッションがキューで開始されます。ゲームセッションの配置の詳細については、ゲームセッションを作成する を参照してください。

キュー内のキューの送信先を更新する場合には、短い移行期間（最大 30 秒）があり、その間にキューの送信先に配置されたゲームセッションが古いフリートに残ってしまう可能性があります。

Console

1. [Amazon GameLift コンソール] のナビゲーションペインで、[キュー] を選択します。

2. [Queues] (キュー) ページで、[Create queue] (新しいキューの作成) を選択します。

3. [キューの作成] ページの [キュー設定] で、次の操作を行います。

   1. [名前] にキューの名前を入力します。

   2. [タイムアウト] には、Amazon GameLift がゲームセッションを停止するまで待機させたい時間を入力します。Amazon GameLift は、リクエストがタイムアウトするまで、あらゆるフリートの使用可能なリソースの検索します。

   3. (オプション) [プレイヤーレイテンシーポリシー] には、Amazon GameLift が定義された最大レイテンシー内でリソースを検索する時間を入力します。ポリシーを追加して、最大レイテンシーを徐々に緩和します。ポリシーを追加するには、[ポリシーを追加] を選択します。

4. [ゲームセッションの配置場所] で、キューに追加するロケーションを選択します。デフォルトでは [すべてのロケーション] が含まれます。キュー内のすべてのフリートに対して同じ証明書設定が必要です。すべてのフリートは、キューを使用するゲームクライアントと互換性があるゲームビルドを実行している必要があります。

5. [送信先] で、キューに 1 つ以上の送信先を追加します。

   1. 送信先の追加を選択します。

   2. 送信先がある [ロケーション] を選択します。

   3. 送信先のタイプを選択します。

   4. 表示されたフリートまたはエイリアス名のリストから、追加するフリートまたはエイリアスを選択します。

   5. 送信先が複数ある場合、送信先の左側の 6 つの点アイコンをドラッグしてデフォルトの順序を設定します。Amazon GameLift は、新規のゲームセッションを配置するのに使用可能なリソースの送信先を検索する際にこの順序を使用します

6. [ゲームセッションの配置優先順位] では、[レイテンシー]、[コスト]、[送信先]、[ロケーション] の値を追加してドラッグし、Amazon GameLift がキュー内のフリートに優先順位を付ける方法を定義します。フリートの優先順位の詳細については、「ゲームセッションプレイスメントに優先順位を付ける」を参照してください。

7. ロケーションを [ロケーションの順序] に追加し、キューが使用する優先度までドラッグします。[ロケーション] がゲームセッション配置の最優先順位である場合、Amazon GameLift はそれをタイブレーカーとして使用します。

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

   1. プレースメント関連のイベント通知を受信する SNS トピックを選択または作成します。 イベント通知の詳細については、「ゲームセッション配置のイベン通知を設定」を参照してください。

   2. このキューで作成されたイベントに追加する [カスタムイベントデータ] を追加します。

9. (オプション) [タグ] を追加します。タグ付けの詳細については、「AWS リソースのタグ付け」を参照してください。

10. [Create] (作成) を選択します。

AWS CLI

例 キューを作成する

次の例では、これらの設定を使用してゲームセッションキューを作成します。

• 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="LOCATION","DESTINATION",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 または describe-alias を呼び出します。

create-game-session-queue リクエストが成功すると、Amazon GameLift は新しいキュー設定を含む GameSessionQueue オブジェクトを返します。これで、StartGameSessionPlacement を使用してリクエストをキューに送信できます。

例 プレイヤーレイテンシーポリシーを使用してキューを作成する

次の例では、これらの設定を使用してゲームセッションキューを作成します。

• 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 は新しいキュー設定を含む GameSessionQueue オブジェクトを返します。