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 cliente de juego
<a name="gsg-integrate-gameclient"></a>

En este tema se describen las tareas necesarias para preparar el cliente de juego o el servicio de emparejamiento para que se comunique con Amazon GameLift Servers FleetIQ con el fin de adquirir un servidor de juegos para alojar una sesión de juego.

Cree un método que permita a su cliente de juego o emparejador solicitar un recurso de servidor de juegos para los jugadores. Tiene un par de opciones para hacer esto: 
+ Permita que Amazon GameLift Servers FleetIQ elija un servidor de juegos disponible. Esta opción aprovecha las optimizaciones de Amazon GameLift Servers FleetIQ para utilizar instancias de spot de bajo costo y para el escalado automático.
+ Solicite todos los servidores de juegos disponibles y seleccione uno para usarlo (con frecuencia se denomina “lista y selección”).

**Topics**
+ [Elección de un servidor de juegos por parte de Amazon GameLift Servers FleetIQ](gsg-integrate-gameclient-automatic.md)
+ [Elección de su propio servidor de juegos](gsg-integrate-gameclient-optimized.md)

# Elección de un servidor de juegos por parte de Amazon GameLift Servers FleetIQ
<a name="gsg-integrate-gameclient-automatic"></a>

Para Amazon GameLift Servers FleetIQ elegir un servidor de juegos disponible, llama a [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) sin especificar un ID de servidor de juegos. En este escenario, Amazon GameLift Servers FleetIQ ejerce su lógica para encontrar un servidor de juegos en una instancia que sea viable para el alojamiento de juegos y se optimiza para el escalado automático.

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

En respuesta a una solicitud de reclamación, Amazon GameLift Servers FleetIQ identifica el recurso `GameServer`, la información de conexión y los datos del juego, que los clientes pueden utilizar para conectarse al servidor de juegos. El estado de reclamación del servidor de juegos se establece en CLAIMED durante 60 segundos. El servidor de juegos o el servicio de cliente deben actualizar el estado del servidor de juegos en Amazon GameLift Servers FleetIQ después de que los jugadores se conecten o se inicie el juego. Este mecanismo garantiza que Amazon GameLift Servers FleetIQ no proporcione este servidor de juegos en respuesta a solicitudes posteriores de capacidad del servidor de juegos. Actualiza el estado del servidor del juego llamando a [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
```

# Elección de su propio servidor de juegos
<a name="gsg-integrate-gameclient-optimized"></a>

Con el método «lista y elige», tu cliente de juego o emparejador solicita una lista de los servidores de juego disponibles llamando a [ListGameServers()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ListGameServers.html). Es posible que desee utilizar los datos del servidor de juegos para proporcionar información adicional que los jugadores o su emparejador puedan utilizar al seleccionar un servidor de juegos. Para controlar cómo se muestran los resultados, puede solicitar resultados paginados y ordenar los servidores de juegos por fecha de registro. La siguiente solicitud devuelve 20 servidores de juegos activos y disponibles en el grupo de servidores de juegos especificado, ordenados por tiempo de registro, con los servidores de juegos más nuevos en primer lugar.

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

Según la lista de servidores de juego disponibles, el cliente o el servicio de búsqueda de parejas selecciona un servidor de juego y lo reclama llamando a [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html) con el ID de servidor de juego específico. En este escenario, Amazon GameLift Servers FleetIQ no ejerce su lógica de optimización de tipo de instancia, como se describe en [Lógica de Amazon GameLift Servers FleetIQ](gsg-howitworks-logic.md).

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