本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon GameLift Servers 主控台中的遊戲和玩家工作階段
<a name="gamelift-console-game-player-sessions-metrics"></a>

您可以使用 Amazon GameLift Servers主控台來使用遊戲工作階段和玩家工作階段。如需遊戲工作階段和玩家工作階段的詳細資訊，請參閱 [Amazon GameLift Servers 和玩家體驗](game-sessions-intro.md)。Amazon GameLift Servers 主控台提供的資訊和工具可協助您調查遊戲工作階段的問題。

您可以做什麼：
+ 探索在特定機群上託管的遊戲工作階段和玩家工作階段活動。
+ 查詢多個機群中特定玩家的遊戲工作階段活動。
+ 關閉特定遊戲工作階段。

## 檢視遊戲工作階段詳細資訊
<a name="game-sessions"></a>

遊戲工作階段和玩家工作階段資料是由託管遊戲工作階段的機群所組織。

**存取遊戲工作階段和玩家工作階段資訊**

1. 在 [Amazon GameLift Servers主控台](https://console.aws.amazon.com/gamelift/)中，開啟左側導覽窗格。選取託管解決方案類型並開啟**機群**頁面。例如：
   + **託管**、**隨處**、**機群**
   + **託管**、**受管 EC2**、**機群**
   + **託管**、**受管容器**、**機群**

1. 每個**機群**頁面會顯示目前所選機群的清單 AWS 區域。選擇您要檢視遊戲工作階段資料的機群。

1. 在機群的詳細資訊頁面中，開啟**遊戲工作階段**索引標籤。此索引標籤會列出在機群上託管的所有遊戲工作階段，以及摘要資訊。您可以使用**偏好設定**工具視需要調整資料表內容 （請參閱資料表右上角的![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_tw/gameliftservers/latest/developerguide/images/settings.png)圖示）。自訂偏好設定會儲存到您的帳戶 AWS 使用者，並會在您檢視此頁面時自動套用。

1. 從清單中選擇遊戲工作階段，以檢視其他資訊。

1. 如果遊戲工作階段包含玩家工作階段資料，請選擇**檢視玩家工作階段**，以自動填入遊戲工作階段 ID 來開啟玩家工作階段查詢工具。

**遊戲工作階段**詳細資訊包含下列資訊：
+ **狀態** – 遊戲工作階段狀態。
  + **啟用中** – 執行個體正在啟動遊戲工作階段。
  + **作用中** – 根據工作階段的玩家[建立政策，遊戲工作階段正在執行並可用於接收玩家](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html)。
  + **已終止** – 遊戲工作階段已結束。
+ **ARN** – 遊戲工作階段的 Amazon Resource Name。
+ **名稱** – 為遊戲工作階段產生的名稱。
+ **位置** – Amazon GameLift Servers託管遊戲工作階段的位置。
+ **建立時間** – Amazon GameLift Servers建立串流工作階段的日期和時間。
+ **結束時間** – 遊戲工作階段結束的日期和時間。
+ **DNS 名稱** – 遊戲工作階段的主機名稱。
+ **IP 地址** – 為遊戲工作階段指定的 IP 地址。
+ **連接埠 ** – 用來連線至遊戲工作階段的連接埠號碼。
+ **建立者 ID** – 啟動遊戲工作階段之玩家的唯一識別符。
+ **玩家工作階段建立政策** – 指出遊戲工作階段是否接受新的玩家。
+ **遊戲擴展保護政策** – 在機群中Amazon GameLift Servers啟動的所有新執行個體上設定的遊戲工作階段保護類型。

**遊戲資料**  
遊戲屬性資料，格式為字串，可在開始時傳送至您的遊戲工作階段。

**遊戲屬性**  
遊戲屬性資料，格式為金鑰/值對，可在開始時傳送至您的遊戲工作階段。

**配對資料**  
如果遊戲工作階段是使用 建立FlexMatch，配對資料會描述配對組態和規則集的相關資訊。這包括每個配對的玩家屬性和團隊指派。資料為 JSON 格式。如需FlexMatch配對的詳細資訊，請參閱[建置配對建構器](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/matchmaker-build.html)。

# 查詢玩家工作階段資料
<a name="player-sessions"></a>

如果您的遊戲託管解決方案使用玩家工作階段並提供唯一的玩家 IDs，您可以探索玩家特定活動，以了解跨多個機群過去或現在的遊戲工作階段。使用下列其中一種方法開啟玩家工作階段查詢工具：
+ 在 Amazon GameLift Servers 主控台中，開啟左側導覽窗格，然後選擇**玩家工作階段查詢**，然後選取要使用的篩選條件類型。
+ 檢視機群的遊戲工作階段詳細資訊時，請選擇**檢視玩家工作階段**。查詢工具會開啟，遊戲工作階段會預先選取遊戲工作階段 ID 篩選條件，並填入遊戲工作階段值。

使用查詢工具時，您可以提供下列任何資訊：
+ 取得特定玩家工作階段相關資訊的玩家工作階段 ID。
+ 取得所請求遊戲工作階段之所有玩家工作階段相關資訊的遊戲工作階段 ID。結果代表所有預留位置或連線到遊戲工作階段的玩家。您可以依照玩家工作階段狀態選擇性地篩選結果。
+ 玩家 ID，以取得所請求玩家之所有玩家工作階段的資訊。結果代表玩家參與的所有遊戲工作階段。

**注意**  
查詢工具會搜尋目前選取的所有玩家工作階段活動 AWS 區域。如果您在 區域中有多個機群，則結果會包含所有機群的玩家工作階段活動。對於多位置機群，結果也包含機群遠端位置的玩家工作階段活動。

 

為每個遊戲工作階段收集的玩家工作階段資料如下：
+ **玩家工作階段 ID** – 指派給玩家工作階段的識別符。
+ **玩家 ID** – 玩家的唯一識別符。選擇此 ID 以取得其他玩家資訊。
+ **遊戲工作階段 ID** – 指派給遊戲工作階段的識別符。
+ **機群 ID** – 指派給託管遊戲工作階段之機群的識別符。
+ **狀態** – 玩家工作階段的狀態。以下是可能的狀態：
  + **預留** – 已預留玩家工作階段，但玩家未連線。
  + **作用中** – 播放器工作階段已連線至遊戲伺服器。
  + **已完成** – 播放器工作階段已結束；播放器不再連線。
  + **逾時** – 播放器無法連線。
+ **建立時間** – 玩家連線到遊戲工作階段的時間。
+ **結束時間** – 玩家與遊戲工作階段中斷連線的時間。
+ **連線資料** – 播放器用來連線至遊戲工作階段的 IP 地址、DNS 名稱和連接埠。
+ **玩家資料** – 在玩家工作階段建立期間提供的玩家相關資訊。

# 關閉遊戲工作階段
<a name="terminate-sessions"></a>

使用Amazon GameLift Servers主控台關閉特定遊戲工作階段。此功能為您提供一種簡單快速的方法，可讓您尋找遊戲工作階段並傳送訊號來終止它。另一種終止方法要求您找到遊戲工作階段正在執行的機群執行個體、遠端存取執行個體，以及手動關閉遊戲工作階段。

您可以因任何原因關閉遊戲工作階段。最常見的原因是解決無法自然關閉的遊戲工作階段。因此，遊戲工作階段的託管資源無法釋出來託管新的遊戲工作階段，而且機群的託管容量會降低。

**注意**  
此功能依賴於託管解決方案的特定組態設定。它有下列限制：  
遊戲工作階段必須託管在執行適用於 Amazon GameLift Servers v5 或更高版本之伺服器 SDK 的遊戲伺服器組建的機群上。如果您的遊戲伺服器是以較舊的版本部署，您需要使用遠端存取來刪除遊戲工作階段。
如果遊戲工作階段託管在 Anywhere 機群上，機群必須使用 Amazon GameLift Servers 代理程式來管理遊戲伺服器程序。

**終止遊戲工作階段**

1. 在 [Amazon GameLift Servers主控台](https://console.aws.amazon.com/gamelift/)中，開啟左側導覽窗格。選取託管解決方案類型並開啟**機群**頁面。例如：
   + **託管**、**隨處**、**機群**
   + **託管**、**受管 EC2**、**機群**
   + **託管**、**受管容器**、**機群**

1. 每個**機群**頁面會顯示目前所選機群的清單 AWS 區域。選擇託管您要終止之遊戲工作階段的機群。

1. 在機群的詳細資訊頁面中，開啟**遊戲工作階段**索引標籤。在遊戲工作階段清單中，選取您要終止的工作階段，然後選擇**終止**按鈕。

1. 在**終止遊戲工作階段？** 視窗中，確認您已關閉正確的遊戲工作階段，並選擇終止方法。
   + 正常遊戲工作階段關閉 – 此選項會將訊號傳送至託管遊戲工作階段以關閉的伺服器程序。如果您的遊戲伺服器建置已針對 正確整合Amazon GameLift Servers，伺服器程序會啟動其遊戲工作階段關閉順序，Amazon GameLift Servers並通知其即將結束，然後停止。根據您的遊戲設計，關機順序可能包含正常完成遊戲工作階段的步驟，例如儲存資料和通知作用中玩家。此方法可能需要一小段延遲才能完成遊戲工作階段關閉序列。
   + 立即關閉遊戲工作階段 – 此選項會將訊號傳送至程序管理員，以關閉託管遊戲工作階段的伺服器程序。此選項會略過正常的遊戲工作階段關閉。即使伺服器程序無法回應，也可以終止遊戲工作階段。

1. 確認遊戲工作階段終止。您可以在**遊戲工作階段**主控台頁面上追蹤關機進度。遊戲工作階段狀態會變更為「終止」，然後在關閉完成時變更為「終止」。

**相關主題**
+ 您也可以使用 AWS SDK 和 關閉遊戲工作階段 AWS CLI。如需詳細資訊和範例，請參閱 Amazon GameLift Servers API 參考主題 [TerminateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_TerminateGameSession.html)。
+ 如需遊戲伺服器整合以及伺服器程序如何回應來自 Amazon GameLift Servers 服務之訊號的詳細資訊，請參閱 [使用伺服器 SDK 將 Amazon GameLift Servers新增至您的遊戲伺服器](gamelift-sdk-server-api.md)。