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

# Amazon GameLift Servers FleetIQ をゲームクライアントに統合する
<a name="gsg-integrate-gameclient"></a>

このトピックでは、ゲームセッションをホストするゲームサーバーを取得するために Amazon GameLift Servers FleetIQ と通信するためのゲームクライアントまたはマッチメイキングサービスを準備するために必要なタスクについて説明します。

ゲームクライアントまたはマッチメーカーがプレイヤーのゲームサーバーリソースをリクエストできるようにするメソッドを作成します。作成する方法にはいくつかのオプションがあります。
+ Amazon GameLift Servers FleetIQ が利用可能なゲームサーバーを選択します。このオプションは、Amazon GameLift Servers FleetIQ 最適化を利用して、低コストのスポットインスタンスを使用し、オートスケーリングを行います。
+ 利用可能なすべてのゲームサーバーをリクエストし、使用するサーバーを選択します (「リスト＆ピック」とも呼ばれます)。

**Topics**
+ [Amazon GameLift Servers FleetIQ にゲームサーバーを選択させる](gsg-integrate-gameclient-automatic.md)
+ [自分のゲームサーバーを選択する](gsg-integrate-gameclient-optimized.md)

# Amazon GameLift Servers FleetIQ にゲームサーバーを選択させる
<a name="gsg-integrate-gameclient-automatic"></a>

Amazon GameLift Servers FleetIQ に使用可能なゲームサーバーを選択させるには、ゲームサーバー ID を指定せずに [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) を呼び出します。このシナリオでは、Amazon GameLift Servers FleetIQ は、ゲームホスティング用に有効で、自動スケーリング用に最適化されたインスタンス上のゲームサーバーを検出するロジックを実行します。

```
AWS gamelift claim-game-server \
    --game-server-group-name MyLiveGroup
```

クレームリクエストへの応答で、Amazon GameLift Servers FleetIQ は、クライアントがゲームサーバーに接続するために使用できる `GameServer` リソース、接続情報、ゲームデータを特定します。ゲームサーバーの要求ステータスは、60 秒間 [クレーム済み] に設定されます。プレイヤーの接続またはゲームプレイのスタート後に、ゲームサーバーまたはクライアントサービスが Amazon GameLift Servers FleetIQ のゲームサーバーのステータスを更新する必要があります。このメカニズムは、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 UTILIZED
```

# 自分のゲームサーバーを選択する
<a name="gsg-integrate-gameclient-optimized"></a>

「リスト&ピック」メソッドを使用するには、[ListGameServers()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ListGameServers.html) を呼び出して、ゲームクライアントまたはマッチメーカーが利用可能なゲームサーバーのリストを要求するようにします。ゲームサーバーのデータを使用して、プレイヤーやマッチメーカーがゲームサーバーを選択する際に使用できる追加情報を提供することができます。ページ分割された結果をリクエストし、ゲームサーバーを登録日順にソートし、結果を返す方法を制御できます。次のリクエストは、指定されたゲームサーバーグループ内のアクティブで利用可能な20台のゲームサーバーを、最新のゲームサーバーが最初に来るように登録時間順にソートされた状態で返します。

```
AWS gamelift list-game-servers \
    --game-server-group-name MyLiveGroup \
    --limit 20 \
    --sort-order DESCENDING
```

利用可能なゲームサーバーのリストに基づいて、クライアントまたはマッチメイキングサービスはゲームサーバーを選択し、特定のゲームサーバー ID 付きの[ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) を呼び出してクレームします。このシナリオでは、Amazon GameLift Servers FleetIQ は、[Amazon GameLift Servers FleetIQ ロジック](gsg-howitworks-logic.md) に説明されているようなインスタンスタイプの最適化ロジックを実行しません。

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