Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Integración de Amazon GameLift Servers FleetIQ en un servidor de juegos
<a name="gsg-integrate-gameserver"></a>

En este tema se describen las tareas necesarias para preparar su proyecto de servidor de juegos para la comunicación con Amazon GameLift Servers FleetIQ. Consulte [prácticas recomendadas de Amazon GameLift Servers FleetIQ](gsg-best-practices.md) para obtener instrucciones adicionales.



# Registro de servidores de juegos
<a name="gsg-integrate-gameserver-register"></a>

Cuando se inicia un proceso de servidor de juegos y está listo para alojar el juego en directo, este debe registrarse en Amazon GameLift Servers FleetIQ mediante una llamada a [RegisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_RegisterGameServer.html). El registro permite a Amazon GameLift Servers FleetIQ responder a los sistemas de emparejamiento u otros servicios de cliente cuando estos solicitan información sobre la capacidad del servidor o reclaman un servidor de juegos. Al registrarse, el servidor de juegos puede proporcionar a Amazon GameLift Servers FleetIQ datos relevantes del servidor de juegos e información de conexión, incluidos el puerto y la dirección IP que utiliza para las conexiones de cliente 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\"}"
```

# Actualización del estado del servidor de juegos
<a name="gsg-integrate-gameserver-update"></a>

Una vez que se ha registrado un servidor de juegos, este debería informar periódicamente sobre su estado y uso para mantener sincronizado el estado de la capacidad del servidor en Amazon GameLift Servers FleetIQ. Notificación del estado y el uso llamando a [UpdateGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameServer.html). En el ejemplo siguiente, el servidor del juego informa de que está en buen estado y de que actualmente no está ocupado con el alojamiento de jugadores o juegos.

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

**Estado**

Si el servidor de juegos tiene un mecanismo para rastrear el estado, puede utilizar ese mecanismo para activar una actualización del estado del servidor de juegos en Amazon GameLift Servers FleetIQ. 

**Estado de uso**

Al notificar el estado de uso del servidor de juegos, se mantiene a Amazon GameLift Servers FleetIQ informado sobre qué servidores de juegos son actualmente idóneos y están disponibles para nuevas sesiones de juego. El servidor de juegos debe tener un mecanismo que active una actualización del estado de uso de Amazon GameLift Servers FleetIQ. Por ejemplo, puede activar la actualización cuando los jugadores se conecten al servidor del juego o cuando comience una sesión de juego. 

Al iniciar una sesión de juego, el cliente o los servicios de emparejamiento reclaman un servidor de juegos disponible [llamando a [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html)], solicitan a los jugadores que se conecten al servidor del juego y activan el servidor del juego para iniciar la partida. Este proceso se describe en [Integración de Amazon GameLift Servers FleetIQ en un cliente de juego](gsg-integrate-gameclient.md). La “reclamación” del servidor de juegos es válida durante 60 segundos, y el servidor de juegos debe poder actualizar el estado de uso dentro de ese periodo. Si el estado de uso no se actualiza, Amazon GameLift Servers FleetIQ retira la reclamación y presupone que el servidor de juegos está disponible, con la posibilidad de reservar el servidor de juegos para otra solicitud de reclamación de un cliente.

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

# Anulación del registro de servidores de juegos
<a name="gsg-integrate-gameserver-deregister"></a>

Cuando un juego finaliza, el servidor de juegos debe anular el registro de Amazon GameLift Servers FleetIQ mediante [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
```