チュートリアル: マッチメーキングルールセットを作成する - Amazon GameLift

チュートリアル: マッチメーキングルールセットを作成する

Amazon GameLift FlexMatch マッチメーカー用のマッチメーキングルールセットを作成する前に、ルールセット構文を確認することをお勧めします。Amazon GameLift コンソールまたは AWS Command Line Interface (AWS CLI) を使用してルールセットを作成すると、それを変更することはできません。

AWS リージョンに設定できるルールセットの最大数にはサービスクォータがあるため、未使用のルールセットは削除することをお勧めします。

トピック
    Console
    ルールセットを作成する

    1. https://console.aws.amazon.com/gamelift/で Amazon GameLift コンソールを開きます。

    2. ルールセットの作成先の AWS リージョンに切り替えます。ルールセットは、ルールセットを使用するマッチメーキング設定と同じリージョンに定義します。

    3. ナビゲーションペインで、[FlexMatch]、[マッチメーキングルールセット] を選択します。

    4. [マッチメーキングルールセット] ページで、[ルールセットを作成] を選択します。

    5. [マッチメーキングルールセットの作成] ページで、次の操作を行います。

      1. [ルールセット設定] の [名前] に、リスト、イベント、メトリクステーブルで識別できる一意のわかりやすい名前を入力します。

      2. [ルールセット] には、JSON 形式のルールセットを入力します。ルール指定に関する情報は、「FlexMatch ルールセットの設計」を参照してください。FlexMatch ルールセットの例 からルールセット例を使用することもできます。

      3. [検証] をクリックし、ルールセットの構文が正しいことを検証します。ルールセットは、作成した後に編集できないため、ルールセットを検証するようお勧めします。

      4. (オプション) [タグ] に、リソースの管理と追跡に役立つタグを追加します。AWS

    6. [Create] (作成) を選択します。正常に作成されたら、そのルールセットをマッチメーカーで使用できます。

    AWS CLI

    ルールセットを作成する

    コマンドラインウィンドウを開き、create-matchmaking-rule-set コマンドを使用します。

    このコマンド例では、1 つのチームをセットアップする簡単なマッチメーキングルールセットを作成します。ルールセットは、それを使用するマッチメーキング設定と同じ AWS リージョンで必ず作成してください。

    aws gamelift create-matchmaking-rule-set \
    --name "SampleRuleSet123" \
    --rule-set-body '{"name": "aliens_vs_cowboys", "ruleLanguageVersion": "1.0", "teams": [{"name": "cowboys", "maxPlayers": 8, "minPlayers":  4}]}'

    作成リクエストが成功すると、指定した設定が含まれている MatchmakingRuleSet オブジェクトが Amazon GameLift から返されます。これでマッチメーカーで新しいルールセットを使用できるようになりました。

    Console
    ルールセットを削除する

    1. https://console.aws.amazon.com/gamelift/で Amazon GameLift コンソールを開きます。

    2. ルールセットを作成したリージョンに切り替えます。

    3. ナビゲーションペインで、[FlexMatch]、[マッチメーキングルールセット] を選択します。

    4. [マッチメーキングルールセット] ページで、削除するルールセットを選択し、[削除] を選択します。

    5. [ルールセットの削除] のダイアログボックスで、[削除] を選択して確認します。

      注記

      マッチメーキング設定がルールセットを使用している場合、Amazon GameLift はエラーメッセージ (ルールセットを削除できません) を表示します。この場合は、別のルールセットを使用するようにマッチメーキング設定を変更してから、もう一度試してください。ルールセットを使用しているマッチメーキング設定を見つけるには、ルールセット名を選択してその詳細ページを表示します。

    AWS CLI

    ルールセットを削除する

    コマンドラインウィンドウを開き、delete-matchmaking-rule-set コマンドを使用してマッチメーキングルールセットを削除します。

    マッチメーキング設定がルールセットを使用している場合、Amazon GameLift はエラーメッセージを返します。この場合は、別のルールセットを使用するようにマッチメーキング設定を変更してから、もう一度試してください。ルールセットを現在使用しているマッチメーキング設定のリストを取得するには、コマンド describe-matchmaking-configurations を使用し、ルールセット名を指定します。

    このコマンド例では、最初にマッチメーキングルールセットの使用状況を確認し、次にルールセットを削除します。

    aws gamelift describe-matchmaking-rule-sets \
    --rule-set-name "SampleRuleSet123" \
    --limit 10

aws gamelift delete-matchmaking-rule-set \
    --name  "SampleRuleSet123"