Migrasi ke server SDK 5.x untuk Amazon GameLift Servers - Amazon GameLift Servers

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

Migrasi ke server SDK 5.x untuk Amazon GameLift Servers

Untuk memperbarui proyek game agar menggunakan server SDK versi 5.x, buat perubahan berikut:

  1. Dapatkan SDK server terbaru untuk Amazon GameLift Servers paket untuk lingkungan pengembangan Anda [Unduh situs]. Ikuti petunjuk penginstalan dalam Readme file untuk paket dan versi yang Anda unduh. Lihat petunjuk ini untuk menggunakan server SDKs dengan proyek game Anda.

  2. Perbarui kode server Anda sebagai berikut:

    • Ubah fungsi callback kode server onCreateGameSession() menjadionStartGameSession().

    • Perbarui InitSDK() input yang sesuai:

      • Jika Anda berencana untuk menyebarkan build server game ke armada Amazon GameLift Servers terkelola atau EC2 armada Anywhere dengan Amazon GameLift Servers Agen:

        Panggilan InitSDK() tanpa parameter (C ++) (C #) (Tidak nyata). Panggilan ini mengatur lingkungan komputasi dan WebSocket koneksi ke Amazon GameLift Servers layanan.

      • Jika Anda berencana untuk menyebarkan build server game ke armada Anywhere tanpa Amazon GameLift Servers Agen:

        Panggilan InitSDK() dengan parameter server (C ++) (C #) (Tidak nyata). Proses server game menggunakan parameter ini untuk membuat koneksi dengan Amazon GameLift Servers layanan.

  3. Jika build server game atau aplikasi host lainnya berkomunikasi dengan AWS sumber daya lain saat berjalan, Anda harus mengubah cara aplikasi mendapatkan akses ke sumber daya tersebut. Ganti penggunaan AssumeRoleCredentials dengan aksi SDK server baru GetFleetRoleCredentials() (untuk server game) atau gunakan kredensyal bersama (untuk aplikasi lain). Untuk informasi lebih lanjut tentang cara menerapkan perubahan ini, lihatBerkomunikasi dengan AWS sumber daya lain dari armada Anda.

  4. Jika proyek Anda memanggil tindakan SDK server GetInstanceCertificate() untuk mengambil sertifikat TLS, ubah kode Anda untuk menggunakan new GetComputeCertificate() (C++) (C#) (Unreal) sebagai gantinya.

  5. Saat mengunggah build game Anda Amazon GameLift Servers (seperti dengan upload-build atau CreateBuild()), setel ServerSdkVersion parameter ke versi 5.x yang Anda gunakan (parameter ini saat ini default ke 4.0.2). Parameter ini harus cocok dengan pustaka SDK server yang sebenarnya di build server game. Jika Anda menentukan versi yang salah untuk build server game yang diunggah, armada apa pun yang Anda buat dengan build tersebut akan gagal. Lihat Menerapkan build server khusus untuk Amazon GameLift Servers mengadakan.

    Contoh berikut menggambarkan cara menentukan versi SDK server: 

    aws gamelift upload-build \
    --operating-system AMAZON_LINUX_2023 \
    --server-sdk-version "5.0.0" \
    --build-root "~/mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2

  6. Jika Anda menggunakan skrip untuk terhubung dari jarak jauh ke armada terkelola, perbarui skrip untuk menggunakan proses baru, seperti yang dijelaskan dalam. Terhubung dari jarak jauh ke Amazon GameLift Servers contoh armada