使用亞馬遜GameLift本地測試您的整合

啟動亞馬遜GameLift本地。

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

java -jar GameLiftLocal.jar -p 9080

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

啟動遊戲伺服器。

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

在 [本機命令提示字元] 視窗中，記錄訊息指出您的遊戲伺服器已連線至 Amazon GameLift 本機服務。這表示您的遊戲伺服器成功初始化了 Amazon GameLift 伺服器 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默認情況下使用亞馬遜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

在 [本機命令提示字元] 視窗中，記錄訊息指出 Amazon L GameLift ocal 已傳送您的遊戲伺服器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
    }
}

啟動亞馬遜GameLift本地。

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

./gamelift-local -p 9080

一旦 Local 啟動，您會看到記錄顯示兩個本機伺服器已經啟動，一個接聽遊戲伺服器，一個接聽遊戲用戶端或 AWS CLI。

啟動遊戲伺服器。

在本機啟動GameLift整合 Amazon 的遊戲伺服器。如需更多訊息記錄的詳細資訊，請參閱 測試遊戲伺服器。

設定 Local 遊戲用戶端並啟動。

若要將遊戲用戶端與 Amazon L GameLift ocal 服務搭配使用，您必須對遊戲用戶端的設定進行下列變更，如中所述在後端服務 GameLift 上設置 Amazon：

在 [本機命令提示字元] 視窗中，一旦啟動遊戲用戶端，記錄訊息應指出它已初始化，GameLiftClient並且已成功與 Amazon GameLift 服務通訊。

測試遊戲用戶端對 Amazon GameLift 服務的呼叫。

驗證您的遊戲用戶端是否成功進行任何或所有下列 API 呼叫：

在 Local 命令提示字元視窗中，只有呼叫 CreateGameSession() 才會產生記錄訊息。Amazon L GameLift ocal 提示您的遊戲伺服器啟動遊戲工作階段 (onStartGameSession回呼)，並在遊戲伺服器叫用時取得成功ActivateGameSession時，記錄訊息會顯示。在 AWS CLI 視窗中，所有 API 呼叫都會產生回應或錯誤訊息做為記錄。

驗證您的遊戲伺服器正在驗證新玩家連接。

建立遊戲工作階段和玩家工作階段之後，與遊戲工作階段建立直接連接。

在 Local 命令提示字元視窗中，記錄訊息應顯示遊戲伺服器已傳送 AcceptPlayerSession() 請求，以驗證新玩家連接。如果您透過 AWS CLI 來呼叫 DescribePlayerSessions()，玩家工作階段的狀態應該會從 Reserved (保留) 變更為 Active (作用中)。

確認您的遊戲伺服器正在向 Amazon GameLift 服務回報遊戲和玩家狀態。

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