

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon GameLift Servers FleetIQ をゲームサーバーに統合する
<a name="gsg-integrate-gameserver"></a>

このトピックでは、Amazon GameLift Servers FleetIQ と通信するゲームサーバープロジェクトを準備するために必要なタスクについて説明します。「[Amazon GameLift Servers FleetIQ のベストプラクティス](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 Servers FleetIQ に登録する必要があります。登録すると、Amazon GameLift Servers FleetIQ がサーバー容量に関する情報を要求したり、ゲームサーバーをクレームしたりするときに、マッチメーキングシステムやその他のクライアントサービスに応答できます。登録時、ゲームサーバーは、受信クライアント接続に使用するポートや IP アドレスなど、関連するゲームサーバーのデータと接続情報を Amazon GameLift Servers FleetIQ に提供できます。

```
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 Servers FleetIQ でサーバー容量の状態を同期させるために、定期的にヘルスおよび使用状況を報告する必要があります。ヘルスと使用率のステータスを報告するには、[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 Servers FleetIQ のゲームサーバーのヘルスアップデートをトリガーできます。

**使用率ステータス**

ゲームサーバーの使用状況を報告すると、Amazon GameLift Servers FleetIQ はどのゲームサーバーが現在理想的で、新しいゲームセッションに利用できるかを把握します。ゲームサーバーには、Amazon GameLift Servers FleetIQ の使用状況の更新をトリガーするメカニズムが必要です。例えば、プレイヤーがゲームサーバーにConnectしたり、ゲームセッションの開始時に更新をトリガーしたりできます。

ゲームセッションを開始するとき、クライアントまたはマッチメーキングサービスは、利用可能なゲームサーバーをクレームし、[ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) を呼び出して、プレイヤーにゲームサーバーへの接続を促し、ゲームサーバーをトリガーしてゲームプレイをスタートします。このプロセスは、「[Amazon GameLift Servers FleetIQ をゲームクライアントに統合する](gsg-integrate-gameclient.md)」で説明されています。ゲームサーバーの「クレーム」は 60 秒間有効であり、ゲームサーバーはこのウィンドウ内で使用状況を更新できる必要があります。使用状況が更新されない場合、Amazon GameLift Servers FleetIQ はクレームを削除し、ゲームサーバーが利用可能であると仮定し、別のクライアント要求のためにゲームサーバーを予約することができます。

```
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>

ゲームが終了すると、ゲームサーバーは [DeregisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeregisterGameServer.html) を使用して Amazon GameLift Servers FleetIQ から登録解除する必要があります。

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