使用 Amazon GameLift Local 測試您的整合

啟動 Amazon GameLift Local。

開啟命令提示字元視窗，導覽到 GameLiftLocal.jar 檔案所在的目錄並執行。在預設情況下，Local 會接聽連接埠 8080 上的遊戲用戶端請求。若要指定不同的連接埠號碼，請使用 -p 參數，如下例所示：

java -jar GameLiftLocal.jar -p 9080

一旦 Local 啟動，您會看到記錄顯示兩個本機伺服器已經啟動，一個接聽遊戲伺服器，一個接聽遊戲用戶端或 AWS CLI。記錄會持續報告兩個本機伺服器上的活動，包括與遊戲元件的往來通訊。

啟動遊戲伺服器。

在本機啟動 Amazon GameLift整合的遊戲伺服器。您不需要變更遊戲伺服器的端點。

在本機命令提示字元視窗中，日誌訊息表示您的遊戲伺服器已連線至 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 Web 服務端點。您必須使用 --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

在本機命令提示字元視窗中，日誌訊息指出 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 會以遊戲工作階段物件 GameLift 回應，包括遊戲工作階段 ID。請注意，新遊戲工作階段的狀態為 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 啟動，您會看到記錄顯示兩個本機伺服器已經啟動，一個接聽遊戲伺服器，一個接聽遊戲用戶端或 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 服務回報遊戲和玩家狀態。

若要 GameLift 讓 Amazon 管理玩家需求並正確報告指標，您的遊戲伺服器必須將各種狀態回報給 Amazon GameLift。驗證 Local 是否正在記錄與下列動作相關的事件。您也可以使用 AWS CLI 來追蹤狀態變更。