As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Integrar o Amazon GameLift Servers FleetIQ em um servidor de jogos
<a name="gsg-integrate-gameserver"></a>

Este tópico descreve as tarefas necessárias para preparar o projeto de servidor de jogos para se comunicar com o Amazon GameLift Servers FleetIQ. Consulte [Práticas recomendadas Amazon GameLift Servers FleetIQ](gsg-best-practices.md) para obter orientação adicional.



# Registrar servidores de jogos
<a name="gsg-integrate-gameserver-register"></a>

Quando um processo de servidor de jogos é iniciado e está pronto para hospedar a jogabilidade ao vivo, ele deve registrar com o Amazon GameLift Servers FleetIQ chamando [RegisterGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_RegisterGameServer.html). O registro permite que o Amazon GameLift Servers FleetIQ responda aos sistemas de criação de partidas ou outros serviços ao cliente quando eles solicitam informações sobre a capacidade do servidor ou reivindicam um servidor de jogo. Ao registrar, o servidor de jogos pode fornecer ao Amazon GameLift Servers FleetIQ dados relevantes do servidor de jogos e informações de conexão, incluindo a porta e o endereço IP usados para conexões de cliente de entrada.

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

# Atualizar o status do servidor de jogos
<a name="gsg-integrate-gameserver-update"></a>

Depois que um servidor de jogos é registrado, ele deve relatar regularmente o status de integridade e utilização para manter o estado da capacidade do servidor sincronizado no Amazon GameLift Servers FleetIQ. Relate a integridade e o status de utilização chamando [UpdateGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameServer.html). No exemplo abaixo, o servidor de jogos está relatando que ele é íntegro e não está atualmente ocupado com hospedagem de jogadores ou pela jogabilidade.

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

**Status de integridade**

Se o servidor de jogos tiver um mecanismo para monitorar o status de integridade, você poderá usar esse mecanismo para acionar uma atualização de integridade do servidor de jogos para o Amazon GameLift Servers FleetIQ. 

**Status de utilização**

Relatar o status de utilização do servidor de jogos mantém o Amazon GameLift Servers FleetIQ informado sobre quais servidores de jogos são atualmente ideais e estão disponíveis para novas sessões de jogo. Seu servidor de jogos deve ter um mecanismo que acione uma atualização do status de utilização do Amazon GameLift Servers FleetIQ. Por exemplo, é possível acionar a atualização quando os jogadores se conectam ao servidor de jogos ou quando uma sessão de jogo começa. 

Ao iniciar uma sessão de jogo, o cliente ou os serviços de criação de partidas reivindicam um servidor de jogos disponível (chamando [ClaimGameServer()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_ClaimGameServer.html), solicitam que os jogadores se conectem ao servidor de jogos e acionam o servidor de jogos para iniciar o jogo. Esse processo é descrito em [Integrar o Amazon GameLift Servers FleetIQ em um cliente de jogo](gsg-integrate-gameclient.md). Uma “reivindicação” do servidor de jogos é válida por 60 segundos, e o servidor de jogos deve ser capaz de atualizar o status de utilização nessa janela. Se o status de utilização não for atualizado, o Amazon GameLift Servers FleetIQ remove a reivindicação, presume que o servidor de jogos está disponível e pode reservar o servidor de jogos para outra solicitação de reivindicação do cliente.

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

# Cancelar servidores de jogos
<a name="gsg-integrate-gameserver-deregister"></a>

Quando um jogo termina, o servidor de jogos deve cancelar o registro do Amazon GameLift Servers FleetIQ usando [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
```