Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Integrieren Sie das Player-Gateway in ein Spiel

Nachdem du eine Flotte erstellt hast, die für das Player-Gateway aktiviert ist, musst du deinen Spielclient und dein Spiel-Backend aktualisieren, um sie mit dem Player-Gateway zu integrieren. Ihr Spiel-Backend ruft Relay-Endpunkte und Spieler-Gateway-Token ab und stellt sie dann den Spielclients zur Verfügung. Spielclients senden den gesamten UDP-Verkehr an diese Relay-Endpunkte.

Die Integration folgt diesem Aufrufpfad:

Backend-Integration

Ihr Spiel-Backend muss die GetPlayerConnectionDetails API aufrufen, um Relay-Endpunkte und Player-Gateway-Token für Spieler abzurufen. Das Backend stellt diese Informationen dann den Spielclients zur Verfügung.

GetPlayerConnectionDetails API

Die GetPlayerConnectionDetails API gibt Verbindungsdetails für Spieler in einer Spielsitzung zurück:

Dein Spielclient sollte so konzipiert sein, dass er beide Verbindungsarten unterstützt.

Beispiel für einen API-Aufruf:

// 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
    }
}

Siehe GetPlayerConnectionDetailsin der Amazon GameLift ServersAPI-Referenz.

Relay-Endpunkte aktualisieren

Rufen Sie GetPlayerConnectionDetails regelmäßig an, um Spielern aktualisierte Endpunkte zur Verfügung zu stellen, wenn die Relay-Endpunkte nicht mehr richtig funktionieren. Wir empfehlen, die API alle 60 Sekunden für alle Spieler in einer Spielsitzung aufzurufen. Um die API-Nutzung zu optimieren, können Sie mehrere Spieler IDs in einem einzigen API-Aufruf stapeln.

Kundenintegration

Dein Spielclient muss allen ausgehenden UDP-Paketen Spielergateway-Token voranstellen und die Pakete an die bereitgestellten Relay-Endpunkte senden. Das Amazon GameLift Servers Client-SDK SDK for C++ und Unreal Engine bietet Hilfsprogramme, um diese Integration zu vereinfachen.

Anforderungen des Kunden

Um den Traffic über das Spieler-Gateway weiterzuleiten, muss dein Spielclient:

Kunden-SDK

Das Amazon GameLift Servers Client-SDK SDK for C++ und Unreal Engine bietet Hilfsprogramme zur Vereinfachung der Player-Gateway-Integration:

Algorithmen zur Endpunktauswahl

Das Client-SDK bietet zwei integrierte Algorithmen für die Auswahl des zu verwendenden Relay-Endpunkts:

Sie können auch benutzerdefinierte Algorithmen implementieren, indem Sie die Basisalgorithmusklasse des SDK erweitern.

SDK-Ressourcen für Kunden

Vollständige Integrationsanweisungen und Beispielcode finden Sie in den folgenden Ressourcen:

Testen Sie Ihre Integration

Testen Sie Ihre Player-Gateway-Integration vor dem Einsatz in einer Flotte lokal mit dem Player-Gateway-Testtool. Dieses Tool simuliert die UDP-Proxyinfrastruktur des Player-Gateways und hilft dir dabei, zu überprüfen, ob dein Spiele-Client Spieler-Gateway-Token korrekt voranstellt, den Verkehr über mehrere Endpunkte leitet und mit Netzwerkverschlechterungen umgeht.

Anweisungen zur Einrichtung und Verwendung finden Sie in der Player-Gateway-Test-App unter. GitHub

Best Practices

Halten Sie sich bei der Integration von Player Gateway an die folgenden bewährten Methoden: