使用 Amazon GameLift Local 测试您的集成

Amazon GameLift Local

打开命令提示符窗口，导航到包含 GameLiftLocal.jar 文件的目录并运行它。默认情况下，Local 在端口 8080 上侦听来自游戏客户端的请求。要指定不同的端口号，请使用 -p 参数，如以下示例所示：

java -jar GameLiftLocal.jar -p 9080

Local 启动之后，您可以查看日志，其中指示两个本地服务器已启动，一个列出您的游戏服务器，另一个列出您的游戏客户端或 Amazon CLI。日志继续报告两个本地服务器上的活动，包括往返于游戏组件之间的通信。

启动游戏服务器。

在本地启动您的 集成游戏服务器。您无需更改游戏服务器的终端节点。

在 Local 命令提示符窗口中，日志消息指示您的游戏服务器已连接至 Local 服务。这意味着游戏服务器已成功初始化 服务器开发工具包（使用 ）。它使用所示的日志路径调用 ProcessReady()，如果成功，则已准备好托管游戏会话。在游戏服务器运行期间， 记录来自各游戏服务器的各个运行状况报告。以下日志消息示例显示了成功集成的游戏服务器：

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

潜在的错误和警告消息包括以下内容：

启动 Amazon CLI。

在您的游戏服务器成功调用 ProcessReady() 之后，您可以开始进行客户端调用。打开另一个命令提示符窗口并启动 Amazon CLI 工具。默认情况下，Amazon CLI 使用 Amazon GameLift Web 服务端点。您必须在使用 --endpoint-url 参数的每个请求中，使用 Local 终端节点覆盖此项，如以下示例请求中所示。

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

在 Amazon CLI 命令提示符窗口中，Amazon gamelift 命令会生成 Amazon CLI 命令参考中所示的响应。

创建游戏会话。

使用 Amazon CLI 提交 CreateGameSession() 请求。该请求应采用预期的语法。对于 Local，FleetId 参数可以设置为任意有效字符串 (^fleet-\S+)。

Amazon 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"

在 Amazon CLI 窗口中，Amazon GameLift 使用包含游戏会话 ID 的游戏会话对象进行响应。请注意，新游戏会话的状态为“Activating”。游戏会话调用 ActivateGameSession 后，状态将更改为“Active”。如果您希望查看更改后的状态，请使用 Amazon 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 启动之后，您可以查看日志，其中显示两个本地服务器已启动，一个列出您的游戏服务器，另一个列出您的游戏客户端或 Amazon CLI。

启动游戏服务器。

在本地启动您的 Amazon GameLift 集成游戏服务器。有关消息日志的详细信息，请参阅测试游戏服务器。

为 Local 配置您的游戏客户端并启用它。

要将您的游戏客户端与 Amazon GameLift Local 服务一起使用，您必须对游戏客户端的设置进行以下更改，如在后端服务 GameLift 上设置 Amazon中所述：

在 Local 命令提示符窗口中，在您启动游戏客户端之后，日志消息应指示它已初始化 ，并且已成功与 服务通信。

测试游戏客户端对 服务的调用。

验证您的游戏客户端已成功进行任意或所有以下 API 调用：

在 Local 命令提示符窗口中，只有对 CreateGameSession() 的调用才会产生日志消息。日志消息显示 Amazon GameLift Local 何时提示您的游戏服务器启动游戏会话（onStartGameSession 回调）并在您的游戏服务器调用它时获取成功的 ActivateGameSession。在 Amazon CLI 窗口中，记录导致响应或错误消息的所有 API 调用。

确保您的游戏服务器正在验证新玩家连接。

创建游戏会话和玩家会话之后，建立与游戏会话的直接连接。

在 Local 命令提示符窗口中，日志消息应显示游戏服务器已发送 AcceptPlayerSession() 请求来验证新玩家连接。如果您使用 Amazon CLI 调用 DescribePlayerSessions()，玩家会话状态应从“Reserved”更改为“Active”。

验证您的游戏服务器正在将游戏和玩家状态报告给 Amazon GameLift 服务。

要让 Amazon GameLift 管理玩家需求并正确报告指标，您的游戏服务器必须将各种状态报告回 Amazon GameLift。验证 Local 正在记录与以下操作相关的事件。您可能还希望使用 Amazon CLI 跟踪状态更改。