Integrar o Amazon GameLift FleetIQ a um servidor de jogos

Este tópico descreve as tarefas necessárias para preparar o projeto de servidor de jogos para se comunicar com o Amazon GameLift FleetIQ. Consulte Melhores práticas do Amazon GameLift FleetIQ para obter orientação adicional.

Registrar servidores de jogos

Quando um processo de servidor de jogos é iniciado e está pronto para hospedar a jogabilidade ao vivo, ele deve registrar com o Amazon GameLift FleetIQ chamando RegisterGameServer(). O registro permite que o Amazon GameLift FleetIQ responda aos sistemas de criação de jogos 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 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

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 FleeTiQ. Relate a integridade e o status de utilização chamando UpdateGameServer(). 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 FleetIQ.

Status de utilização

Relatar o status de utilização do servidor de jogos mantém o Amazon GameLift 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 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 jogos reivindicam um servidor de jogos disponível (chamando ClaimGameServer(), solicitam que os jogadores se conectem ao servidor de jogos e acionam o servidor de jogos para iniciar o jogo. Esse processo é descrito em Integre o Amazon GameLift FleetIQ a um cliente de jogo. 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 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

Quando um jogo termina, o servidor de jogos deve cancelar o registro do Amazon GameLift FleetIQ usando DeregisterGameServer().

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