View a markdown version of this page

Bermigrasi ke server SDK 5.x untuk GameLift Server Amazon - GameLift Server Amazon

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

Bermigrasi ke server SDK 5.x untuk GameLift Server Amazon

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

catatan

Jika Anda perlu terus menggunakan SDK server versi 4.x atau yang lebih lama, lihat dokument Server SDK untuk GameLift Server Amazon versi 4 dan sebelumnya asi dan informasi unduhan. Untuk SDK versi 4.0.2 khusus, Anda dapat mengunduhnya dari GitHub rilis https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/releases resmi.

  1. Dapatkan SDK server terbaru untuk Amazon GameLift Servers paket untuk lingkungan pengembangan Anda [Unduh situs]. Ikuti petunjuk instalasi dalam Readme file untuk paket dan versi yang Anda unduh. Lihat petunjuk ini untuk menggunakan SDK server 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 menerapkan build server game ke armada EC2 Amazon GameLift Servers terkelola atau armada Anywhere dengan Amazon GameLift Servers Agen:

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

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

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

  3. Jika build server game Anda atau aplikasi yang dihosting lainnya berkomunikasi dengan AWS sumber daya lain saat berjalan, Anda harus mengubah cara aplikasi mendapatkan akses ke sumber daya tersebut. Ganti penggunaan AssumeRoleCredentials dengan tindakan SDK server baru GetFleetRoleCredentials() (untuk server game) atau gunakan kredenSIAL bersama (untuk aplikasi lain). Untuk lebih lanjut tentang cara menerapkan perubahan ini, lihatHubungkan Anda GameLift Server Amazon server game yang di-host ke yang lain AWS sumber daya.

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

  5. Saat mengunggah build game Anda ke Amazon GameLift Servers (seperti dengan upload-build atau CreateBuild ()), atur 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 Buat build server game untuk GameLift Peladen Amazon.

    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 yang dikelola, perbarui skrip untuk menggunakan proses baru, seperti yang dijelaskan dalamSambungkan ke instans armada.