Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
SDK Server (Tidak Nyata) untuk GameLift Server Amazon - Tipe data
Gunakan SDK Amazon GameLift Servers server untuk referensi Unreal untuk mengintegrasikan game multipemain Anda untuk hosting. Amazon GameLift Servers Untuk panduan tentang proses integrasi, lihatTambahkan GameLift Server Amazon ke server game Anda dengan SDK server.
catatan
Referensi ini untuk versi sebelumnya dari SDK server untukAmazon GameLift Servers. Untuk versi terbaru, lihatSDK server C++ (Unreal) 5.x untuk GameLift Server Amazon - Tipe data.
API ini didefinisikan dalam GameLiftServerSDK.h dan GameLiftServerSDKModels.h.
Untuk menyiapkan plugin Unreal Engine dan melihat contoh kode Mengintegrasikan GameLift Server Amazon menjadi proyek Unreal Engine.
SDK Server (Tidak Nyata) untuk GameLift Server Amazon -- Tindakan
Topik
FDescribePlayerSessionsRequest
Jenis data ini digunakan untuk menentukan sesi pemain untuk diambil. Anda bisa menggunakannya sebagai berikut:
-
Ber PlayerSessionId ikan permintaan sesi pemain tertentu.
-
Berikan GameSessionId permintaan semua sesi pemain dalam sesi permainan yang ditentukan.
-
Berikan PlayerId permintaan semua sesi pemain untuk pemain yang ditentukan.
Untuk koleksi sesi pemain yang besar, gunakan parameter pemberian nomor halaman untuk mengambil hasil dalam blok berurutan.
Daftar Isi
- GameSessionId
-
Pengidentifikasi sesi game yang unik. Gunakan parameter ini untuk meminta semua sesi pemain untuk sesi game yang ditentukan. Format ID sesi game adalah sebagai berikut:
arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. Nilai <ID string> adalah string ID kustom atau (jika salah satu ditentukan saat sesi game dibuat) string yang dihasilkan.Tipe: String
Wajib: Tidak
- Kuota
-
Jumlah hasil maksimum yang akan dikembalikan. Gunakan parameter ini dengan NextToken untuk mendapatkan hasil sebagai satu set halaman berurutan. Jika ID sesi pemain ditentukan, parameter ini diabaikan.
Jenis: Integer
Wajib: Tidak
- NextToken
-
Token yang menunjukkan awal dari halaman berurutan berikutnya dari hasil. Gunakan token yang dikembalikan dengan panggilan sebelumnya untuk tindakan ini. Untuk menentukan awal set hasil, jangan menentukan nilai. Jika ID sesi pemain ditentukan, parameter ini diabaikan.
Tipe: String
Wajib: Tidak
- PlayerId
-
Pengidentifikasi unik untuk pemain. ID Pemain ditentukan oleh developer. Lihat Hasilkan pemain IDs.
Tipe: String
Wajib: Tidak
- PlayerSessionId
-
Pengidentifikasi unik untuk sesi pemain.
Tipe: String
Wajib: Tidak
- PlayerSessionStatusFilter
-
Status sesi pemain untuk mem-filter hasil. Kemungkinan status sesi pemain meliputi:
-
RESERVED — Permintaan sesi pemain telah diterima, tetapi pemain belum terhubung ke proses server yang and/or divalidasi.
-
ACTIVE — Pemain telah divalidasi oleh proses server dan saat ini terhubung.
-
COMPLETED — Sambungan pemain telah terputus.
-
TIMEDOUT — Permintaan sesi pemain diterima, tetapi pemain tidak terhubung and/or tidak divalidasi dalam batas waktu tunggu (60 detik).
Tipe: String
Wajib: Tidak
-
FProcessParameters
Tipe data ini berisi kumpulan parameter yang dikirim ke Amazon GameLift Servers layanan dalam ProcessReady() panggilan.
Daftar Isi
- port
-
Nomor port yang akan didengarkan proses server untuk koneksi pemain baru. Nilai harus masuk ke dalam kisaran port yang dikonfigurasi untuk setiap armada yang men-deploy build server game ini. Nomor port ini termasuk dalam sesi game dan objek sesi pemain, yang digunakan sesi game saat menghubungkan ke proses server.
Jenis: Integer
Wajib: Ya
- logParameters
-
Obyek dengan daftar jalur direktori untuk file log sesi game.
Jenis: TArray <FString>
Wajib: Tidak
- pada StartGameSession
-
Nama fungsi panggilan balik yang dipang Amazon GameLift Servers gil layanan untuk mengaktifkan sesi game baru. Amazon GameLift Serversmemanggil fungsi ini sebagai respons terhadap permintaan klien CreateGameSession. Fungsi callback mengambil GameSession objek (didefinisikan dalam Referensi API Amazon GameLift Servers Layanan).
Tipe: FOnStartGameSession
Wajib: Ya
- pada ProcessTerminate
-
Nama fungsi callback yang dipang Amazon GameLift Servers gil layanan untuk memaksa proses server dimatikan. Setelah memanggil fungsi iniAmazon GameLift Servers, tunggu lima menit hingga proses server dimatikan dan merespons dengan ProcessEnding() panggilan sebelum mematikan proses server.
Tipe: FSimpleDelegate
Wajib: Tidak
- pada HealthCheck
-
Nama fungsi panggilan balik yang dipang Amazon GameLift Servers gil layanan untuk meminta laporan status kesehatan dari proses server. Amazon GameLift Serversmemanggil fungsi ini setiap 60 detik. Setelah memanggil fungsi ini Amazon GameLift Servers menunggu 60 detik untuk respons, dan jika tidak ada yang diterima, merekam proses server sebagai tidak sehat.
Tipe: FOnHealthCheck
Wajib: Tidak
- pada UpdateGameSession
-
Nama fungsi panggilan balik yang dipang Amazon GameLift Servers gil layanan untuk meneruskan objek sesi game yang diperbarui ke proses server. Amazon GameLift Serversmemanggil fungsi ini ketika permintaan isi ulang kecocokan telah diproses untuk memberikan data matchmaker yang diperbarui. Ini melewati GameSession objek, pembaruan status (
updateReason), dan ID tiket isi ulang pertandingan.Tipe: FOnUpdateGameSession
Wajib: Tidak
FStartMatchBackfillRequest
Jenis data ini digunakan untuk mengirim permintaan backfill matchmaking. Informasi dikomunikasikan ke Amazon GameLift Servers layanan dalam StartMatchBackfill() panggilan.
Daftar Isi
- GameSessionArn
-
Pengidentifikasi sesi game yang unik. Tindakan API GetGameSessionId() mengembalikan pengidentifikasi dalam format ARN.
Jenis: String
Wajib: Ya
- MatchmakingConfigurationArn
-
Pengidentifikasi unik, dalam bentuk ARN, yang akan digunakan matchmaker untuk permintaan ini. Untuk menemukan matchmaker yang digunakan untuk membuat sesi game asli, lihat di objek sesi game, di properti data matchmaker. Pelajari selengkapnya tentang data matchmaker di Bekerja dengan data matchmaker.
Jenis: String
Wajib: Ya
- Pemain
-
Satu set data yang mewakili semua pemain yang saat ini dalam sesi game. Matchmaker menggunakan informasi ini untuk mencari pemain baru yang cocok untuk pemain saat ini. Lihat Panduan Referensi Amazon GameLift Servers API untuk deskripsi format objek Player. Untuk menemukan atribut pemain, ID, dan tugas tim, lihat di objek sesi game, di properti data matchmaker. Jika latensi digunakan oleh matchmaker, kumpulkan latensi yang diperbarui untuk wilayah saat ini dan sertakan dalam data masing-masing pemain.
Jenis: TArray<FPlayer>
Wajib: Ya
- TicketId
-
Pengidentifikasi unik untuk tiket permintaan matchmaking atau backfill match. Jika tidak ada nilai yang diberikan di sini, Amazon GameLift Servers akan menghasilkan satu dalam bentuk UUID. Gunakan pengidentifikasi ini untuk melacak status tiket backfill match atau membatalkan permintaan jika diperlukan.
Jenis: String
Wajib: Tidak
FStopMatchBackfillRequest
Jenis data ini digunakan untuk membatalkan permintaan backfill matchmaking. Informasi dikomunikasikan ke Amazon GameLift Servers layanan dalam StopMatchBackfill() panggilan.
Daftar Isi
- GameSessionArn
-
Pengidentifikasi sesi game unik yang terkait dengan permintaan yang dibatalkan.
Jenis: String
Wajib: Ya
- MatchmakingConfigurationArn
-
Pengidentifikasi unik dari matchmaker sebagai tujuan pengiriman permintaan ini.
Jenis: String
Wajib: Ya
- TicketId
-
Pengidentifikasi unik dari tiket backfill match yang akan dibatalkan.
Jenis: String
Wajib: Ya
