Amazon GameLift Local を使用して統合をテストする

Amazon GameLift Local を起動します。

コマンドプロンプトウィンドウを開き、GameLiftLocal.jar ファイルがあるディレクトリに移動して実行します。デフォルトでは、Local はポート 8080 でゲームクライアントからのリクエストをリッスンします。別のポート番号を指定するには、以下の例に示すように -p パラメータを使用します。

java -jar GameLiftLocal.jar -p 9080

Local が起動すると、2 つのローカルサーバー (ゲームサーバーをリッスンしているサーバーとゲームクライアントまたは AWS CLIをリッスンしているサーバー) が起動したことがログに示されます。ログは、ゲームコンポーネントとの通信など、2 つのローカルサーバーでのアクティビティを報告し続けます。

ゲームサーバーを起動します。

Amazon GameLift統合ゲームサーバーをローカルで起動します。ゲームサーバーのエンドポイントを変更する必要はありません。

Local コマンドプロンプトウィンドウでは、ログメッセージはゲームサーバーが Amazon GameLift Local サービスに接続したことを示します。これは、ゲームサーバーが Amazon GameLift Server SDK ( を含む) を正常に初期化したことを意味しますInitSDK()。示されたログパスを使用して ProcessReady() を呼び出し、成功した場合はゲームセッションをホストする準備が完了します。ゲームサーバーの実行中に、Amazon はゲームサーバーから各ヘルスステータスレポートを GameLift ログに記録します。次のログメッセージの例は、正常に統合されたゲームサーバーを示しています。

16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK connected: /127.0.0.1:64247 
16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - SDK pid is 17040, sdkVersion is 3.1.5 and sdkLanguage is CSharp
16:50:53,217  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - NOTE: Only SDK versions 3.1.5 and above are supported in GameLiftLocal!
16:50:53,451  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady received from: /127.0.0.1:64247 and ackRequest requested? true
16:50:53,543  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onProcessReady data: logPathsToUpload: "C:\\game\\logs"
logPathsToUpload: "C:\\game\\error"
port: 1935
        
16:50:53,544  INFO || - [HostProcessManager] nioEventLoopGroup-3-1 - Registered new process true, true,
16:50:53,558  INFO || - [SDKListenerImpl] nioEventLoopGroup-3-1 - onReportHealth received from /127.0.0.1:64247 with health status: healthy

考えられるエラーおよび警告メッセージには次のものがあります。

を起動します AWS CLI。

ゲームサーバーが ProcessReady() を正常に呼び出したら、クライアント呼び出しを開始できます。別のコマンドプロンプトウィンドウを開き、 AWS CLI ツールを開始します。 AWS CLI デフォルトでは、 は Amazon GameLift ウェブサービスエンドポイントを使用します。これは、次のリクエスト例に示すように、--endpoint-url パラメータを使用して各リクエストで Local エンドポイントによって上書きする必要があります。

AWS gamelift describe-game-sessions --endpoint-url http://localhost:9080  --fleet-id fleet-123

AWS CLI コマンドプロンプトウィンドウでは、 AWS gamelift コマンドAWS CLI リファレンス に記載されているように、コマンドはレスポンスを生成します。

ゲームセッションの作成。

で AWS CLI、 CreateGameSession() リクエストを送信します。リクエストは予期される構文に従う必要があります。Local では、FleetId パラメーターを任意の文字列 (^fleet-\S+) に設定できます。

AWS gamelift create-game-session --endpoint-url http://localhost:9080 --maximum-player-session-count 2 --fleet-id
    fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Local コマンドプロンプトウィンドウでは、Amazon GameLift Local がゲームサーバーにonStartGameSessionコールバックを送信したことを示すログメッセージが表示されます。ゲームセッションが正常に作成された場合、ゲームサーバーは ActivateGameSession を呼び出すことで応答します。

13:57:36,129  INFO || - [SDKInvokerImpl]
        Thread-2 - Finished sending event to game server to start a game session:
        arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6.
        Waiting for ack response.13:57:36,143  INFO || - [SDKInvokerImpl]
        Thread-2 - Received ack response: true13:57:36,144  INFO || -
        [CreateGameSessionDispatcher] Thread-2 - GameSession with id:
        arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-ab423a4b-b827-4765-aea2-54b3fa0818b6
        created13:57:36,227  INFO || - [SDKListenerImpl]
        nioEventLoopGroup-3-1 - onGameSessionActivate received from: /127.0.0.1:60020 and ackRequest
        requested? true13:57:36,230  INFO || - [SDKListenerImpl]
        nioEventLoopGroup-3-1 - onGameSessionActivate data: gameSessionId:
        "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890"

AWS CLI ウィンドウで、Amazon はゲームセッション ID を含むゲームセッションオブジェクトで GameLift 応答します。新しいゲームセッションのステータスが [Activating] になっていることに注目してください。ゲームサーバーが を呼び出すと、ステータスはアクティブに変わります ActivateGameSession。変更されたステータスを表示したい場合は、 を使用して AWS CLI を呼び出しますDescribeGameSessions()。

{
    "GameSession": {
      "Status": "ACTIVATING",
      "MaximumPlayerSessionCount": 2,
      "FleetId": "fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "GameSessionId": "arn:aws:gamelift:local::gamesession/fleet-1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d/gsess-abcdef12-3456-7890-abcd-ef1234567890",
      "IpAddress": "127.0.0.1",
      "Port": 1935
    }
}

Amazon GameLift Local を起動します。

コマンドプロンプトウィンドウを開き、GameLiftLocal.jar ファイルがあるディレクトリに移動して実行します。デフォルトでは、Local はポート 8080 でゲームクライアントからのリクエストをリッスンします。別のポート番号を指定するには、以下の例に示すように -p パラメーターを使用します。

./gamelift-local -p 9080

Local が起動すると、2 つのローカルサーバー (ゲームサーバーをリッスンしているサーバーとゲームクライアントまたは AWS CLIをリッスンしているサーバー) が起動したことがログに示されます。

ゲームサーバーを起動します。

Amazon GameLift統合ゲームサーバーをローカルで起動します。メッセージログの詳細については、「ゲームサーバーのテスト」を参照してください。

Local のゲームクライアントを設定して起動します。

Amazon GameLift Local サービスでゲームクライアントを使用するには、「」で説明されているように、ゲームクライアントの設定に以下の変更を加える必要がありますバックエンドサービス GameLift で Amazon を設定する。

ローカルコマンドプロンプトウィンドウでは、ゲームクライアントを起動すると、ログメッセージに が初期化GameLiftClientされ、Amazon GameLift サービスと正常に通信されたことを示す必要があります。

Amazon GameLift サービスへのゲームクライアントの呼び出しをテストします。

ゲームクライアントが次のAPI呼び出しのいずれかまたはすべてを正しく実行していることを確認します。

Local のコマンドプロンプトウィンドウでは、CreateGameSession() を呼び出した場合のみログメッセージが生成されます。ログメッセージは、Amazon GameLift Local がゲームサーバーにゲームセッション (onStartGameSession コールバック) を開始するように促し、ゲームサーバーActivateGameSessionがゲームセッションを呼び出すときに が成功したときに表示されます。 AWS CLI ウィンドウでは、すべてのAPI呼び出しで、文書化されたレスポンスまたはエラーメッセージが発生します。

ゲームサーバーが新しいプレイヤー接続を検証していることを確認します。

ゲームセッションとプレイヤーセッションを作成したら、ゲームセッションへの直接接続を確立します。

Local のコマンドプロンプトウィンドウでは、ゲームサーバーが AcceptPlayerSession() リクエストを送信して新しいプレイヤー接続を検証したことが表示されます。を使用して AWS CLI を呼び出す場合DescribePlayerSessions()、プレイヤーセッションのステータスはリザーブドからアクティブに変わります。

ゲームサーバーが Amazon GameLift サービスにゲームとプレイヤーのステータスを報告していることを確認します。

Amazon GameLift がプレイヤーの需要を管理し、メトリクスを正しくレポートするには、ゲームサーバーがさまざまなステータスを Amazon に報告する必要があります GameLift。Local が以下のアクションに関連するイベントを記録していることを確認します。また、 AWS CLI を使用してステータスの変更を追跡することもできます。