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

ゲーム クライアントへの FlexMatch の追加

このトピックでは、クライアント側ゲームサービスに FlexMatch マッチメーキングのSupportを追加する方法について説明しています。FlexMatch を Amazon GameLift マネージド ホスティング、または別のホスティングソリューションで使用している場合でも、プロセスは基本的に同じです。FlexMatch とゲームのカスタムマッチメーカーのセットアップ方法の詳細はこちらのトピックを参照してください。

FlexMatch マッチメーキングをゲームで有効にするには、以下の機能を追加する必要があります。

プレイヤーによるマッチメーキングのリクエスト準備

ゲームクライアントがクライアント側のゲームサービスを通してマッチメーキングリクエストを作成することを強くお勧めします。信頼されたソースを使用することで、ハッキングの試みや偽のプレイヤーデータからより簡単に保護できます。ゲームがセッションディレクトリサービスを使用している場合、これはマッチメーキングリクエストを処理するための優れたオプションです。

クライアントサービスを準備するには、次のタスクを実行します。

プレイヤーのマッチメーキングのリクエスト

クライアントサービスにコードを追加し、 FlexMatch マッチメーカーへのマッチメーキングリクエストを作成して管理します。FlexMatch マッチメーキングをリクエストするプロセスは、Amazon GameLiftManaged ホスティングで FlexMatch を使用するゲームと、スタンドアロンソリューションとして FlexMatch を使用するゲームでも同じです。

マッチメーキングイベントの追跡

マッチメーキングプロセスに関して Amazon GameLift がマッチメーキングプロセスのために発行するイベントを追跡するために通知を設定します。SNS トピックを作成するか、 Amazon EventBridge を使用することで、通知を直接設定できます。通知の設定の詳細については、「FlexMatch イベント通知をセットアップする」を参照してください。通知を設定したら、必要に応じてイベントと応答を検出するために、クライアントサービスでリスナーを追加します。

また、通知なしでかなりの期間が経過した場合に、ステータスの更新を定期的にポーリングして、通知をバックアップすることをお勧めします。マッチメーキングのパフォーマンスへの影響を最小限に抑えるには、マッチメーキングチケットが送信されてから 30 秒以上待ってからか、最後に受信した通知の後にのみポーリングしてください。

[DescribeMatchmaking]（マッチメーキングの説明）をリクエストのチケット ID とともに呼び出して、現在のステータスを含むマッチメーキングリクエストチケットを取得します。最大で 10 秒に 1 回ポーリングすることをお勧めします。この方法は、使用量が少ない開発シナリオでのみ使用します。

プレイヤーの承諾をリクエスト

プレイヤーの承諾が有効になっているマッチメーカーを使用している場合、クライアントサービスにコードを追加し、プレイヤーの承諾プロセスを管理します。プレイヤーの承諾をマネージドするプロセスは、Amazon GameLift マネージドホスティングで FlexMatch を使用するゲームと、スタンドアロンソリューションとして FlexMatch を使用するゲームでも同じです。

試合にConnectする

正常に完了したマッチング (ステータス COMPLETED またはイベント MatchmakingSucceeded) を処理するために、クライアントサービスにコードを追加します。これにはマッチングのプレイヤーへの通知と、ゲームクライアントへ接続情報の提供が含まれます。

Amazon GameLift マネージドホスティングを使用するゲームでは、マッチメーキングリクエストが正常に実行されると、ゲームセッション接続情報がマッチメーキングチケットに追加されます。DescribeMatchmaking を呼び出して、完了したマッチメーキングチケットを取得します。接続情報には、ゲームセッションの IP アドレスとポート、および各プレイヤー ID に対するプレイヤーセッション ID が含まれます。詳細については、「GameSessionConnectionInfo」を参照してください。ゲームクライアントはこの情報を使用して、試合をホストしているゲームセッションに直接Connectします。接続リクエストには、プレイヤーセッション ID とプレイヤー ID が含まれている必要があります。このデータは接続されたプレイヤーを、チームの割り当てを含むゲームセッションのマッチングデータに関連付けます (「GameSession」を参照)。

Amazon GameLift FleetIQ など、他のホスティングソリューションを使用するゲームでは、試合のプレイヤーが適切なゲームセッションに接続を有効にできるようメカニズムを構築する必要があります。

マッチメーキングリクエストのサンプル

これらのコードスニペットは、さまざまなマッチメーカーに対するマッチメーキングリクエストを構築します。説明されているように、リクエストではマッチメーカーのルールセットの定義に従い、使用されているマッチメーカーで必要なプレイヤー属性を提供する必要があります。提供された属性では、ルールセット内で定義されている同じデータ型、数値 (N)、または文字列 (S) を使用する必要があります。

# Uses matchmaker for two-team game mode based on player skill level
def start_matchmaking_for_cowboys_vs_aliens(config_name, ticket_id, player_id, skill, team):
    response = gamelift.start_matchmaking(
        ConfigurationName=config_name,
        Players=[{
            "PlayerAttributes": {
                "skill": {"N": skill}
            },
            "PlayerId": player_id,
            "Team": team
        }],
        TicketId=ticket_id)

# Uses matchmaker for monster hunter game mode based on player skill level
def start_matchmaking_for_players_vs_monster(config_name, ticket_id, player_id, skill, is_monster):
    response = gamelift.start_matchmaking(
        ConfigurationName=config_name,
        Players=[{
            "PlayerAttributes": {
                "skill": {"N": skill},
                "desiredSkillOfMonster": {"N": skill},
                "wantsToBeMonster": {"N": int(is_monster)}
            },
            "PlayerId": player_id
        }],
        TicketId=ticket_id)

# Uses matchmaker for brawler game mode with latency
def start_matchmaking_for_three_team_brawler(config_name, ticket_id, player_id, skill, role):
    response = gamelift.start_matchmaking(
        ConfigurationName=config_name,
        Players=[{
            "PlayerAttributes": {
                "skill": {"N": skill},
                "character": {"S": [role]},
            },
            "PlayerId": player_id,
            "LatencyInMs": { "us-west-2": 20}
        }],
        TicketId=ticket_id)

# Uses matchmaker for multiple game modes and maps based on player experience
def start_matchmaking_for_multi_map(config_name, ticket_id, player_id, skill, maps, modes):
    response = gamelift.start_matchmaking(
        ConfigurationName=config_name,
        Players=[{
            "PlayerAttributes": {
                "experience": {"N": skill},
                "gameMode": {"SL": modes},
                "mapPreference": {"SL": maps}
            },
            "PlayerId": player_id
        }],
        TicketId=ticket_id)