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

# Amazon GameLift ServersFleetIQ 整合至遊戲伺服器
<a name="gsg-integrate-gameserver"></a>

本主題說明準備遊戲伺服器專案與之通訊所需的任務Amazon GameLift ServersFleetIQ。如需其他指引[Amazon GameLift ServersFleetIQ 最佳實務](gsg-best-practices.md)，請參閱 。



# 註冊遊戲伺服器
<a name="gsg-integrate-gameserver-register"></a>

當遊戲伺服器程序啟動並準備好託管即時遊戲時，必須透過呼叫 [RegisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_RegisterGameServer.html) Amazon GameLift ServersFleetIQ向 註冊。註冊Amazon GameLift ServersFleetIQ可讓 在請求伺服器容量資訊或申請遊戲伺服器時回應配對系統或其他用戶端服務。註冊時，遊戲伺服器可以Amazon GameLift ServersFleetIQ提供相關的遊戲伺服器資料和連線資訊，包括用於傳入用戶端連線的連接埠和 IP 地址。

```
AWS gamelift register-game-server \
    --game-server-id UniqueId-1234 \
    --game-server-group-name MyLiveGroup \
    --instance-id i-1234567890 \
    --connection-info "1.2.3.4:123" \
    --game-server-data "{\"key\": \"value\"}"
```

# 更新遊戲伺服器狀態
<a name="gsg-integrate-gameserver-update"></a>

註冊遊戲伺服器後，應定期報告運作狀態和使用率狀態，以保持伺服器容量的狀態同步Amazon GameLift ServersFleetIQ。呼叫 [UpdateGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameServer.html) 來報告運作狀態和使用狀態。在下面的範例中，遊戲伺服器回報其運作狀態良好，且目前並未被託管玩家或遊戲佔用。

```
AWS gamelift update-game-server \
    --game-server-group-name MyLiveGroup \
    --game-server-id UniqueId-1234 \
    --health-check HEALTHY \
    --utilization-status AVAILABLE
```

**運作狀態**

如果您的遊戲伺服器具有追蹤運作狀態的機制，您可以使用此機制來觸發遊戲伺服器運作狀態更新Amazon GameLift ServersFleetIQ。

**使用狀態**

報告遊戲伺服器使用率狀態會隨時Amazon GameLift ServersFleetIQ掌握哪些遊戲伺服器目前是理想的，並可用於新的遊戲工作階段。您的遊戲伺服器必須具有觸發使用狀態更新的機制Amazon GameLift ServersFleetIQ。例如，您可能會在玩家連線到遊戲伺服器或遊戲工作階段開始時觸發更新。

啟動遊戲工作階段時，用戶端或配對服務會宣告可用的遊戲伺服器 （透過呼叫 [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html))、提示玩家連線到遊戲伺服器，並觸發遊戲伺服器開始遊戲。此程序說明於 [Amazon GameLift Servers FleetIQ 整合至遊戲用戶端](gsg-integrate-gameclient.md)。遊戲伺服器「宣告」有效期為 60 秒，遊戲伺服器必須能夠使用此時段更新使用率狀態。如果使用率狀態未更新， 會Amazon GameLift ServersFleetIQ移除宣告、假設遊戲伺服器可用，並可能將遊戲伺服器保留給另一個用戶端宣告請求。

```
AWS gamelift update-game-server \
    --game-server-group-name MyLiveGroup \
    --game-server-id UniqueId-1234 \
    --health-check HEALTHY \
    --utilization-status UTILIZED
```

# 取消註冊遊戲伺服器
<a name="gsg-integrate-gameserver-deregister"></a>

當遊戲結束時，遊戲伺服器必須使用 Amazon GameLift ServersFleetIQ [DeregisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeregisterGameServer.html) 取消註冊。

```
AWS gamelift deregister-game-server \
    --game-server-group-name MyLiveGroup \
    --game-server-id UniqueId-1234
```