Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Integrasikan gateway pemain ke dalam game

Setelah membuat armada yang mendukung gateway pemain, Anda harus memperbarui klien game dan backend game Anda untuk diintegrasikan dengan gateway pemain. Backend game Anda mengambil titik akhir relay dan token gateway pemain, lalu menyediakannya ke klien game. Klien game mengirim semua lalu lintas UDP ke titik akhir relai ini.

Integrasi mengikuti jalur panggilan ini:

Integrasi backend

Backend game Anda harus memanggil GetPlayerConnectionDetails API untuk mengambil titik akhir relai dan token gateway pemain untuk pemain. Backend kemudian memberikan informasi ini kepada klien game.

GetPlayerConnectionDetails API

GetPlayerConnectionDetailsAPI mengembalikan detail koneksi untuk pemain dalam sesi game:

Klien game Anda harus dirancang untuk menangani kedua jenis koneksi.

Contoh panggilan 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
    }
}

Lihat GetPlayerConnectionDetailsdi Referensi Amazon GameLift Servers API.

Segarkan titik akhir relai

Panggil GetPlayerConnectionDetails secara berkala untuk memberi pemain titik akhir yang diperbarui saat titik akhir relay menjadi tidak sehat. Kami merekomendasikan memanggil API setiap 60 detik untuk semua pemain dalam sesi permainan. Untuk mengoptimalkan penggunaan API, gabungkan beberapa pemain IDs dalam satu panggilan API.

Integrasi klien

Klien game Anda harus menambahkan token gateway pemain ke semua paket UDP keluar dan mengirim paket ke titik akhir relai yang disediakan. Amazon GameLift ServersKlien SDK for C++ dan Unreal Engine menyediakan utilitas untuk menyederhanakan integrasi ini.

Persyaratan klien

Untuk merutekan lalu lintas melalui gateway pemain, klien game Anda harus:

SDK Klien

Amazon GameLift ServersKlien SDK for C++ dan Unreal Engine menyediakan utilitas untuk menyederhanakan integrasi gateway pemain:

Algoritma pemilihan titik akhir

SDK klien menyediakan dua algoritma bawaan untuk memilih titik akhir relai mana yang akan digunakan:

Anda juga dapat menerapkan algoritma kustom dengan memperluas kelas algoritma dasar SDK.

Sumber daya SDK klien

Untuk instruksi integrasi lengkap dan kode contoh, lihat sumber daya berikut:

Uji integrasi Anda

Sebelum menerapkan ke armada, uji integrasi gateway pemain Anda secara lokal menggunakan alat pengujian gateway pemain. Alat ini mensimulasikan infrastruktur proxy UDP gateway pemain dan membantu Anda memverifikasi bahwa klien game Anda dengan benar menambahkan token gateway pemain, merutekan lalu lintas melalui beberapa titik akhir, dan menangani degradasi jaringan.

Untuk petunjuk penyiapan dan penggunaan, lihat aplikasi pengujian gateway pemain aktif GitHub.

Praktik terbaik

Ikuti praktik terbaik ini saat mengintegrasikan gateway pemain: