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 serveur de jeu
<a name="gsg-integrate-gameserver"></a>

Cette rubrique décrit les tâches requises pour préparer votre projet de serveur de jeu à communiquer avec Amazon GameLift Servers FleetIQ. Reportez-vous à [Amazon GameLift ServersFleetIQmeilleures pratiques](gsg-best-practices.md) pour obtenir des conseils supplémentaires.



# Enregistrer des serveurs de jeu
<a name="gsg-integrate-gameserver-register"></a>

Lorsqu'un processus de serveur de jeu est lancé et prêt à héberger un jeu en direct, il doit être enregistré auprès Amazon GameLift Servers FleetIQ en appelant [RegisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_RegisterGameServer.html). L'enregistrement permet Amazon GameLift Servers FleetIQ pour répondre aux systèmes de matchmaking ou à d'autres services clients lorsqu'ils demandent des informations sur la capacité du serveur ou réclament un serveur de jeu. Lors de l'inscription, le serveur de jeu peut fournir Amazon GameLift Servers FleetIQ avec les données pertinentes du serveur de jeu et les informations de connexion, y compris le port et l'adresse IP qu'il utilise pour les connexions clients entrantes.

```
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\"}"
```

# Mettre à jour l'état du serveur de jeu
<a name="gsg-integrate-gameserver-update"></a>

Une fois qu'un serveur de jeu est enregistré, il doit régulièrement signaler son état de santé et son état d'utilisation afin de maintenir l'état de la capacité du serveur synchronisé Amazon GameLift Servers FleetIQ. Signalez l'état de santé et l'état d'utilisation en appelant [UpdateGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameServer.html). Dans l'exemple ci-dessous, le serveur de jeu indique qu'il est en bon état et qu'il n'est actuellement pas occupé à héberger des joueurs ou à jouer.

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

**État de santé**

Si votre serveur de jeu dispose d'un mécanisme de suivi de l'état de santé, vous pouvez utiliser ce mécanisme pour déclencher une mise à jour de l'état du serveur de jeu pour Amazon GameLift Servers FleetIQ. 

**État d'utilisation**

Signaler l'état d'utilisation du serveur de jeu Amazon GameLift Servers FleetIQ informé sur les serveurs de jeu actuellement idéaux et disponibles pour les nouvelles sessions de jeu. Votre serveur de jeu doit disposer d'un mécanisme qui déclenche une mise à jour du statut d'utilisation pour Amazon GameLift Servers FleetIQ. Par exemple, vous pouvez déclencher la mise à jour lorsque les joueurs se connectent au serveur de jeu ou lorsqu'une session de jeu démarre. 

Lors du démarrage d'une session de jeu, les services client ou de matchmaking réclament un serveur de jeu disponible [ClaimGameServer(en appelant ()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html)), invitent les joueurs à se connecter au serveur de jeu et déclenchent le serveur de jeu pour démarrer le jeu. Ce processus est décrit dans[Intégrer Amazon GameLift Servers FleetIQ dans un client de jeu](gsg-integrate-gameclient.md). Une « réclamation » de serveur de jeu est valide pendant 60 secondes, et le serveur de jeu doit être en mesure de mettre à jour l'état d'utilisation dans cette fenêtre. Si le statut d'utilisation n'est pas mis à jour, Amazon GameLift Servers FleetIQ supprime la réclamation, suppose que le serveur de jeu est disponible et peut réserver le serveur de jeu pour une autre demande de réclamation du client.

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

# Désenregistrer les serveurs de jeu
<a name="gsg-integrate-gameserver-deregister"></a>

À la fin d'une partie, le serveur de jeu doit se désinscrire de Amazon GameLift Servers FleetIQ en utilisant [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
```