Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Integra il gateway del giocatore in un gioco

Dopo aver creato una flotta di giocatori abilitata al gateway per i giocatori, devi aggiornare il client di gioco e il backend di gioco per integrarli con Player Gateway. Il backend di gioco recupera gli endpoint relay e i token del gateway del giocatore, quindi li fornisce ai client di gioco. I client di gioco inviano tutto il traffico UDP a questi endpoint di inoltro.

L'integrazione segue questo percorso di chiamata:

Integrazione con il backend

Il backend del gioco deve chiamare l'GetPlayerConnectionDetailsAPI per recuperare gli endpoint di inoltro e i token di accesso ai giocatori. Il backend fornisce quindi queste informazioni ai client di gioco.

GetPlayerConnectionDetails API

L'GetPlayerConnectionDetailsAPI restituisce i dettagli di connessione per i giocatori in una sessione di gioco:

Il client di gioco deve essere progettato per gestire entrambi i tipi di connessione.

Esempio di chiamata 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
    }
}

Vedi GetPlayerConnectionDetailsnell'Amazon GameLift ServersAPI Reference.

Aggiorna gli endpoint del relè

Chiama GetPlayerConnectionDetails periodicamente per fornire ai giocatori gli endpoint aggiornati quando gli endpoint delle staffette non funzionano correttamente. Consigliamo di chiamare l'API ogni 60 secondi per tutti i giocatori in una sessione di gioco. Per ottimizzare l'utilizzo dell'API, raggruppa più giocatori IDs in un'unica chiamata API.

Integrazione con i client

Il client di gioco deve anteporre i token del gateway del giocatore a tutti i pacchetti UDP in uscita e inviare i pacchetti agli endpoint di inoltro forniti. Il Amazon GameLift Servers client SDK for C++ e Unreal Engine fornisce utilità per semplificare questa integrazione.

Requisiti del cliente

Per indirizzare il traffico attraverso il gateway del giocatore, il client di gioco deve:

Client SDK

Il Amazon GameLift Servers client SDK for C++ e Unreal Engine fornisce utilità per semplificare l'integrazione del player gateway:

Algoritmi di selezione degli endpoint

L'SDK del client fornisce due algoritmi integrati per la selezione dell'endpoint di inoltro da utilizzare:

Puoi anche implementare algoritmi personalizzati estendendo la classe di algoritmi base dell'SDK.

Risorse Client SDK

Per istruzioni complete sull'integrazione e codice di esempio, consulta le seguenti risorse:

Metti alla prova la tua integrazione

Prima di passare a una flotta, verifica l'integrazione del player gateway a livello locale utilizzando lo strumento di test player gateway. Questo strumento simula l'infrastruttura proxy UDP del gateway del giocatore e ti aiuta a verificare che il tuo client di gioco inserisca correttamente i token del gateway del giocatore, instrada il traffico attraverso più endpoint e gestisca il degrado della rete.

Per istruzioni di configurazione e utilizzo, consulta l'app Player Gateway Testing su. GitHub

Best practice

Segui queste best practice per integrare player gateway: