Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Intégrer une passerelle pour les joueurs dans un jeu

Après avoir créé une flotte compatible avec Player Gateway, vous devez mettre à jour votre client de jeu et votre backend de jeu pour les intégrer à Player Gateway. Votre backend de jeu récupère les points de terminaison du relais et les jetons de passerelle pour les joueurs, puis les fournit aux clients du jeu. Les clients du jeu envoient tout le trafic UDP vers ces points de terminaison relais.

L'intégration suit le chemin d'appel suivant :

Intégration du backend

Votre backend de jeu doit appeler l'GetPlayerConnectionDetailsAPI pour récupérer les points de terminaison du relais et les jetons de passerelle pour les joueurs. Le backend fournit ensuite ces informations aux clients du jeu.

GetPlayerConnectionDetails API

L'GetPlayerConnectionDetailsAPI renvoie les informations de connexion pour les joueurs participant à une session de jeu :

Votre client de jeu doit être conçu pour gérer les deux types de connexion.

Exemple d'appel d'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
    }
}

Voir GetPlayerConnectionDetailsla référence de Amazon GameLift Servers l'API.

Actualiser les points de terminaison du relais

Appelez GetPlayerConnectionDetails régulièrement pour fournir aux joueurs des points de terminaison mis à jour lorsque les points de terminaison du relais ne fonctionnent plus correctement. Nous recommandons d'appeler l'API toutes les 60 secondes pour tous les joueurs participant à une session de jeu. Pour optimiser l'utilisation de l'API, regroupez plusieurs joueurs IDs en un seul appel d'API.

Intégration du client

Votre client de jeu doit ajouter les jetons de passerelle du joueur à tous les paquets UDP sortants et envoyer les paquets aux points de terminaison du relais fournis. Le SDK Amazon GameLift Servers client pour C++ et Unreal Engine fournit des utilitaires pour simplifier cette intégration.

Exigences du client

Pour acheminer le trafic via la passerelle des joueurs, votre client de jeu doit :

SDK du client

Le SDK Amazon GameLift Servers client pour C++ et Unreal Engine fournit des utilitaires destinés à simplifier l'intégration de la passerelle des joueurs :

algorithmes de sélection des terminaux

Le SDK client fournit deux algorithmes intégrés permettant de sélectionner le point de terminaison du relais à utiliser :

Vous pouvez également implémenter des algorithmes personnalisés en étendant la classe d'algorithme de base du SDK.

Ressources du SDK client

Pour obtenir des instructions d'intégration complètes et un exemple de code, consultez les ressources suivantes :

Testez votre intégration

Avant le déploiement dans une flotte, testez l'intégration de votre passerelle joueur localement à l'aide de l'outil de test de passerelle joueur. Cet outil simule l'infrastructure du proxy UDP de la passerelle des joueurs et vous aide à vérifier que votre client de jeu ajoute correctement les jetons de passerelle des joueurs, achemine le trafic via plusieurs points de terminaison et gère la dégradation du réseau.

Pour les instructions de configuration et d'utilisation, consultez l'application de test Player Gateway sur GitHub.

Bonnes pratiques

Suivez ces bonnes pratiques lors de l'intégration de Player Gateway :