Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Intégrer Amazon GameLift Servers FleetIQ dans un client de jeu
<a name="gsg-integrate-gameclient"></a>

Cette rubrique décrit les tâches nécessaires pour préparer votre client de jeu ou votre service de matchmaking à communiquer Amazon GameLift Servers FleetIQ afin d'acquérir un serveur de jeu pour héberger une session de jeu.

Créez une méthode qui permet à votre client de jeu ou au matchmaker de demander une ressource de serveur de jeux pour les joueurs. Voici quelques options pour y parvenir : 
+ Amazon GameLift ServersFleetIQChoisissez un serveur de jeu disponible. Cette option tire parti des Amazon GameLift Servers FleetIQ optimisations visant à utiliser des instances Spot à faible coût et à effectuer un dimensionnement automatique.
+ Demander tous les serveurs de jeux disponibles et sélectionner un serveur à utiliser (processus souvent appelé « répertorier et sélectionner »).

**Topics**
+ [Amazon GameLift ServersFleetIQChoisissez un serveur de jeu](gsg-integrate-gameclient-automatic.md)
+ [Choisissez votre propre serveur de jeu](gsg-integrate-gameclient-optimized.md)

# Amazon GameLift ServersFleetIQChoisissez un serveur de jeu
<a name="gsg-integrate-gameclient-automatic"></a>

Pour avoir Amazon GameLift Servers FleetIQ choisi un serveur de jeu disponible, appelez [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) sans spécifier d'identifiant de serveur de jeu. Dans ce scénario, Amazon GameLift Servers FleetIQ utilise sa logique pour trouver un serveur de jeu sur une instance viable pour l'hébergement de jeux et optimisé pour le dimensionnement automatique.

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

En réponse à une demande de réclamation, Amazon GameLift Servers FleetIQ identifie la `GameServer` ressource, les informations de connexion et les données de jeu que les clients peuvent utiliser pour se connecter au serveur de jeu. L'état de la demande du serveur de jeux est défini sur CLAIMED (DEMANDÉ) pendant 60 secondes. Votre serveur de jeu ou votre service client doit mettre à jour le statut du serveur de jeu une Amazon GameLift Servers FleetIQ fois que les joueurs se connectent ou que le jeu commence. Cela garantit qu'il Amazon GameLift Servers FleetIQ ne fournit pas ce serveur de jeu en réponse aux demandes ultérieures de capacité du serveur de jeu. Mettez à jour l'état du serveur de jeu en appelant [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
```

# Choisissez votre propre serveur de jeu
<a name="gsg-integrate-gameclient-optimized"></a>

Avec la méthode « list and pick », votre client de jeu ou votre système de matchmaking demande une liste des serveurs de jeu disponibles en appelant [ListGameServers()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ListGameServers.html). Vous pouvez utiliser les données du serveur de jeux pour fournir des informations supplémentaires que les joueurs ou votre matchmaker peuvent utiliser lors de la sélection d'un serveur de jeux. Pour contrôler la manière dont les résultats sont renvoyés, vous pouvez demander des résultats paginés et trier les serveurs de jeu par date d'enregistrement. La requête suivante renvoie 20 serveurs de jeu actifs et disponibles dans le groupe de serveurs de jeu spécifié, triés par heure d'enregistrement, les serveurs de jeu les plus récents étant répertoriés en premier.

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

Sur la base de la liste des serveurs de jeu disponibles, le client ou le service de matchmaking sélectionne un serveur de jeu et le revendique en appelant [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) avec l'identifiant de serveur de jeu spécifique. Dans ce scénario, Amazon GameLift Servers FleetIQ n'applique aucune de ses logiques d'optimisation du type d'instance, comme décrit dans[Amazon GameLift ServersFleetIQlogique](gsg-howitworks-logic.md).

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