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

GameLift Server Amazon SDK untuk Unreal Engine: Tindakan

Gunakan GameLift server Amazon SDK untuk referensi Unreal untuk mengintegrasikan game multipemain Anda untuk hosting dengan Amazon. GameLift Untuk panduan tentang proses integrasi, lihatTambahkan Amazon GameLift ke server game Anda.

Ini API didefinisikan dalam GameLiftServerSDK.h danGameLiftServerSDKModels.h.

Untuk menyiapkan plugin Unreal Engine dan melihat contoh kode Integrasikan Amazon GameLift ke dalam proyek Unreal Engine.

GameLift Server Amazon SDK untuk Unreal Engine: Tipe data

AcceptPlayerSession()

Memberi tahu GameLift layanan Amazon bahwa pemain dengan ID sesi pemain yang ditentukan telah terhubung ke proses server dan memerlukan validasi. Amazon GameLift memverifikasi bahwa ID sesi pemain valid—yaitu, ID pemain telah memesan slot pemain di sesi permainan. Setelah divalidasi, Amazon GameLift mengubah status slot pemain dari RESERVED keACTIVE.

Sintaks

FGameLiftGenericOutcome AcceptPlayerSession(const FString& playerSessionId)

Parameter

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

ActivateGameSession()

Memberi tahu GameLift layanan Amazon bahwa proses server telah mengaktifkan sesi permainan dan sekarang siap menerima koneksi pemain. Tindakan ini harus dipanggil sebagai bagian dari fungsi callback onStartGameSession(), setelah semua inisialisasi sesi game selesai.

Sintaks

FGameLiftGenericOutcome ActivateGameSession()

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

DescribePlayerSessions()

Mengambil data sesi pemain, termasuk pengaturan, metadata sesi, dan data pemain. Gunakan tindakan ini untuk mendapatkan informasi untuk satu sesi pemain, untuk semua sesi pemain dalam sesi game, atau untuk semua sesi pemain yang terkait dengan ID pemain tunggal.

Sintaks

FGameLiftDescribePlayerSessionsOutcome DescribePlayerSessions(const FGameLiftDescribePlayerSessionsRequest &describePlayerSessionsRequest)

Parameter

Nilai yang dikembalikan

Jika berhasil, ini mengembalikan objek FDescribePlayerSessionsRequest yang berisi satu set objek sesi pemain yang sesuai dengan parameter permintaan. Objek sesi pemain memiliki struktur yang identik dengan tipe GameLift API PlayerSessiondata AWS SDK Amazon.

GetGameSessionId()

Mengambil ID dari sesi game yang saat ini sedang di-host oleh proses server, jika proses server aktif.

Sintaks

FGameLiftStringOutcome GetGameSessionId()

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Jika berhasil, ini mengembalikan ID sesi game sebagai objek FGameLiftStringOutcome. Jika tidak berhasil, ini mengembalikan pesan kesalahan.

GetInstanceCertificate()

Mengambil lokasi file dari TLS sertifikat pem-encoded yang terkait dengan armada dan instance-nya. AWS Certificate Manager menghasilkan sertifikat ini saat Anda membuat armada baru dengan konfigurasi sertifikat yang disetel keGENERATED. Gunakan sertifikat ini untuk membuat koneksi yang aman dengan client game dan untuk mengenkripsi komunikasi client/server.

Sintaks

FGameLiftGetInstanceCertificateOutcome GetInstanceCertificate()

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Jika berhasil, mengembalikan GetInstanceCertificateOutcome objek yang berisi lokasi file TLS sertifikat armada dan rantai sertifikat, yang disimpan pada instance. File sertifikat root, diekstrak dari rantai sertifikat, juga disimpan pada instance. Jika tidak berhasil, ini mengembalikan pesan kesalahan.

Untuk informasi selengkapnya tentang sertifikat dan data rantai sertifikat, lihat Elemen GetCertificate Respons dalam AWS Certificate Manager API Referensi.

GetSdkVersion()

Mengembalikan nomor versi saat ini dari SDK dibangun ke dalam proses server.

Sintaks

FGameLiftStringOutcome GetSdkVersion();

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Jika berhasil, mengembalikan SDK versi saat ini sebagai FGameLiftStringOutcome objek. String yang dikembalikan mencakup nomor versi saja (mis. "3.1.5"). Jika tidak berhasil, ini mengembalikan pesan kesalahan.

Contoh

Aws::GameLift::AwsStringOutcome SdkVersionOutcome = 
    Aws::GameLift::Server::GetSdkVersion(); 

Init SDK ()

Menginisialisasi Amazon GameLift SDK. Metode ini harus dipanggil saat peluncuran, sebelum inisialisasi GameLift terkait Amazon lainnya terjadi.

Sintaks

FGameLiftGenericOutcome InitSDK()

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

ProcessEnding()

Memberitahu GameLift layanan Amazon bahwa proses server dimatikan. Metode ini harus dipanggil setelah semua tugas pembersihan lainnya, termasuk mematikan semua sesi game aktif. Metode ini harus keluar dengan kode keluar 0; sebuah kode non-nol menghasilkan pesan kejadian bahwa proses tidak keluar dengan bersih.

Sintaks

FGameLiftGenericOutcome ProcessEnding()

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

ProcessReady()

Memberitahu GameLift layanan Amazon bahwa proses server siap untuk meng-host sesi game. Panggil metode ini setelah berhasil meminta Init SDK () dan menyelesaikan tugas penyiapan yang diperlukan sebelum proses server dapat menjadi host sesi game. Metode ini harus dipanggil hanya satu kali per proses.

Sintaks

FGameLiftGenericOutcome ProcessReady(FProcessParameters &processParameters)

Parameter

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

Contoh

Lihat kode sampel di Menggunakan Plugin Unreal Engine.

RemovePlayerSession()

Memberitahu GameLift layanan Amazon bahwa pemain dengan ID sesi pemain yang ditentukan telah terputus dari proses server. Sebagai tanggapan, Amazon GameLift mengubah slot pemain menjadi tersedia, yang memungkinkannya ditugaskan ke pemain baru.

Sintaks

FGameLiftGenericOutcome RemovePlayerSession(const FString& playerSessionId)

Parameter

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

StartMatchBackfill()

Mengirim permintaan untuk menemukan pemain baru untuk slot terbuka dalam sesi permainan yang dibuat dengan FlexMatch. Lihat juga AWS SDK aksi StartMatchBackfill(). Dengan tindakan ini, permintaan backfill match dapat dimulai dengan proses server game yang menjadi host sesi game. Pelajari lebih lanjut tentang fitur FlexMatch isi ulang.

Tindakan ini asinkron. Jika pemain baru berhasil dicocokkan, GameLift layanan Amazon mengirimkan data mak comblang yang diperbarui menggunakan fungsi panggilan balik. OnUpdateGameSession()

Proses server hanya dapat melakukan satu permintaan backfill match yang aktif dalam satu waktu. Untuk mengirim permintaan baru, panggil StopMatchBackfill() terlebih dahulu untuk membatalkan permintaan asli.

Sintaks

FGameLiftStringOutcome StartMatchBackfill (FStartMatchBackfillRequest &startBackfillRequest);

Parameter

Nilai yang dikembalikan

Jika berhasil, mengembalikan tiket backfill match sebagai objek FGameLiftStringOutcome. Jika tidak berhasil, ini mengembalikan pesan kesalahan. Status tiket dapat dilacak menggunakan AWS SDK action DescribeMatchmaking().

StopMatchBackfill()

Membatalkan permintaan backfill match aktif yang dibuat dengan StartMatchBackfill(). Lihat juga AWS SDK aksi StopMatchmaking(). Pelajari lebih lanjut tentang fitur FlexMatch isi ulang.

Sintaks

FGameLiftGenericOutcome StopMatchBackfill (FStopMatchBackfillRequest &stopBackfillRequest);

Parameter

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

TerminateGameSession()

Metode ini tidak lagi digunakan dengan versi 4.0.1. Sebaliknya, proses server harus memanggil ProcessEnding() setelah sesi permainan berakhir.

Memberitahu GameLift layanan Amazon bahwa proses server telah mengakhiri sesi permainan saat ini. Tindakan ini dipanggil ketika proses server akan tetap aktif dan siap untuk menjadi host sesi game baru. Ini harus dipanggil hanya setelah prosedur penghentian sesi permainan Anda selesai, karena memberi sinyal ke Amazon GameLift bahwa proses server segera tersedia untuk meng-host sesi permainan baru.

Tindakan ini tidak dipanggil jika proses server akan dimatikan setelah sesi game berhenti. Sebagai gantinya, panggil ProcessEnding() untuk memberi tahu bahwa sesi game dan proses server akan berakhir.

Sintaks

FGameLiftGenericOutcome TerminateGameSession()

Parameter

Tindakan ini tidak memiliki parameter.

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

UpdatePlayerSessionCreationPolicy()

Memperbarui kemampuan sesi game saat ini untuk menerima sesi pemain baru. Sesi game dapat diatur untuk menerima atau menolak semua sesi pemain baru. (Lihat juga UpdateGameSession()tindakan di APIReferensi GameLift Layanan Amazon).

Sintaks

FGameLiftGenericOutcome UpdatePlayerSessionCreationPolicy(EPlayerSessionCreationPolicy policy)

Parameter

Nilai yang dikembalikan

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.