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

プレイヤーゲートウェイをゲームに統合する

プレイヤーゲートウェイ対応フリートを作成したら、ゲームクライアントとゲームバックエンドを更新してプレイヤーゲートウェイと統合する必要があります。ゲームバックエンドはリレーエンドポイントとプレイヤーゲートウェイトークンを取得し、ゲームクライアントに提供します。ゲームクライアントは、すべての UDP トラフィックをこれらのリレーエンドポイントに送信します。

統合は次の呼び出しパスに従います。

バックエンド統合

ゲームバックエンドは GetPlayerConnectionDetails API を呼び出して、プレイヤーのリレーエンドポイントとプレイヤーゲートウェイトークンを取得する必要があります。その後、バックエンドはこの情報をゲームクライアントに提供します。

GetPlayerConnectionDetails API

GetPlayerConnectionDetails API は、ゲームセッションのプレイヤーの接続の詳細を返します。

ゲームクライアントは、両方の接続タイプを処理するように設計されている必要があります。

API コールの例:

// C++ example using AWS SDK
Aws::GameLift::GameLiftClient client;
Aws::GameLift::Model::GetPlayerConnectionDetailsRequest request;
request.SetGameSessionId(gameSessionId);
request.SetPlayerIds(playerIds);  // Vector of player IDs

auto outcome = client.GetPlayerConnectionDetails(request);
if (outcome.IsSuccess()) {
    auto result = outcome.GetResult();
    auto connectionDetails = result.GetPlayerConnectionDetails();
    
    // Process each player's connection details
    for (const auto& detail : connectionDetails) {
        std::string playerId = detail.GetPlayerId();
        
        // Get relay endpoints (IP address and port)
        auto endpoints = detail.GetEndpoints();
        for (const auto& endpoint : endpoints) {
            std::string ipAddress = endpoint.GetIpAddress();
            int port = endpoint.GetPort();
        }
        
        // Get player gateway token
        auto token = detail.GetPlayerGatewayToken();
        
        // Get expiration time
        auto expiration = detail.GetExpiration();
        
        // Send endpoints and token to game client
    }
}

Amazon GameLift Servers API リファレンスのGetPlayerConnectionDetails」を参照してください。

リレーエンドポイントを更新する

リレーエンドポイントが異常になったときにGetPlayerConnectionDetails、定期的に を呼び出して更新されたエンドポイントをプレイヤーに提供します。ゲームセッションのすべてのプレイヤーに対して 60 秒ごとに API を呼び出すことをお勧めします。API の使用を最適化するには、1 回の API コールで複数のプレイヤー IDs をバッチ処理します。

クライアント統合

ゲームクライアントは、すべての送信 UDP パケットにプレイヤーゲートウェイトークンを付加し、提供されたリレーエンドポイントにパケットを送信する必要があります。Amazon GameLift Servers クライアント SDK for C++ および Unreal Engine は、この統合を簡素化するためのユーティリティを提供します。

クライアント要件

プレイヤーゲートウェイを介してトラフィックをルーティングするには、ゲームクライアントが以下を行う必要があります。

クライアント SDK

Amazon GameLift Servers クライアント SDK for C++ および Unreal Engine は、プレイヤーゲートウェイの統合を簡素化するユーティリティを提供します。

エンドポイント選択アルゴリズム

クライアント SDK には、使用するリレーエンドポイントを選択するための 2 つの組み込みアルゴリズムが用意されています。

SDK のベースアルゴリズムクラスを拡張することで、カスタムアルゴリズムを実装することもできます。

クライアント SDK リソース

完全な統合手順とサンプルコードについては、次のリソースを参照してください。

統合をテストする

フリートにデプロイする前に、プレイヤーゲートウェイテストツールを使用してプレイヤーゲートウェイの統合をローカルでテストします。このツールは、プレイヤーゲートウェイ UDP プロキシインフラストラクチャをシミュレートし、ゲームクライアントがプレイヤーゲートウェイトークンの先頭を正しく付加し、複数のエンドポイントを介してトラフィックをルーティングし、ネットワークの低下を処理することを確認するのに役立ちます。

セットアップと使用方法については、GitHub のプレイヤーゲートウェイテストアプリを参照してください。

ベストプラクティス

プレイヤーゲートウェイを統合するときは、次のベストプラクティスに従ってください。