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á.

Integre o gateway do jogador em um jogo

Depois de criar uma frota habilitada para o Player Gateway, você deve atualizar o cliente e o back-end do jogo para integrá-los ao Player Gateway. O back-end do jogo recupera os endpoints de retransmissão e os tokens do gateway do jogador e os fornece aos clientes do jogo. Os clientes de jogos enviam todo o tráfego UDP para esses endpoints de retransmissão.

A integração segue esse caminho de chamada:

Integração de back-end

O back-end do seu jogo deve chamar a GetPlayerConnectionDetails API para recuperar endpoints de retransmissão e tokens de gateway de jogador para os jogadores. O back-end então fornece essas informações aos clientes do jogo.

GetPlayerConnectionDetails API

A GetPlayerConnectionDetails API retorna detalhes de conexão para jogadores em uma sessão de jogo:

Seu cliente de jogo deve ser projetado para lidar com os dois tipos de conexão.

Exemplo de chamada de API:

// C++ example using AWS SDK
Aws::GameLift::GameLiftClient client;
Aws::GameLift::Model::GetPlayerConnectionDetailsRequest request;
request.SetGameSessionId(gameSessionId);
request.SetPlayerIds(playerIds);  // Vector of player IDs

auto outcome = client.GetPlayerConnectionDetails(request);
if (outcome.IsSuccess()) {
    auto result = outcome.GetResult();
    auto connectionDetails = result.GetPlayerConnectionDetails();
    
    // Process each player's connection details
    for (const auto& detail : connectionDetails) {
        std::string playerId = detail.GetPlayerId();
        
        // Get relay endpoints (IP address and port)
        auto endpoints = detail.GetEndpoints();
        for (const auto& endpoint : endpoints) {
            std::string ipAddress = endpoint.GetIpAddress();
            int port = endpoint.GetPort();
        }
        
        // Get player gateway token
        auto token = detail.GetPlayerGatewayToken();
        
        // Get expiration time
        auto expiration = detail.GetExpiration();
        
        // Send endpoints and token to game client
    }
}

Veja GetPlayerConnectionDetailsna Referência da Amazon GameLift Servers API.

Atualize os endpoints de retransmissão

Ligue GetPlayerConnectionDetails periodicamente para fornecer aos jogadores endpoints atualizados quando os endpoints de retransmissão ficarem insalubres. Recomendamos chamar a API a cada 60 segundos para todos os jogadores em uma sessão de jogo. Para otimizar o uso da API, agrupe vários jogadores IDs em uma única chamada de API.

Integração com o cliente

Seu cliente de jogo deve anexar os tokens do gateway do jogador a todos os pacotes UDP de saída e enviar os pacotes para os terminais de retransmissão fornecidos. O SDK Amazon GameLift Servers do cliente para C++ e Unreal Engine fornece utilitários para simplificar essa integração.

Requisitos do cliente

Para rotear o tráfego pelo gateway do jogador, seu cliente de jogo deve:

SDK do cliente

O SDK Amazon GameLift Servers do cliente para C++ e Unreal Engine fornece utilitários para simplificar a integração do player gateway:

Algoritmos de seleção de terminais

O SDK do cliente fornece dois algoritmos integrados para selecionar qual endpoint de retransmissão usar:

Você também pode implementar algoritmos personalizados estendendo a classe de algoritmo base do SDK.

Recursos do SDK do cliente

Para obter instruções completas de integração e exemplos de código, consulte os seguintes recursos:

Teste a integração

Antes de implantar em uma frota, teste sua integração com o Player Gateway localmente usando a ferramenta de teste Player Gateway. Essa ferramenta simula a infraestrutura de proxy UDP do gateway do player e ajuda você a verificar se o cliente do jogo insere corretamente os tokens do gateway do player, roteia o tráfego por meio de vários endpoints e lida com a degradação da rede.

Para obter instruções de configuração e uso, consulte o aplicativo de teste do player gateway em GitHub.

Práticas recomendadas

Siga estas melhores práticas ao integrar o Player Gateway: