Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Referensi SDK GameLift server Amazon (C ++): Jenis data
Anda dapat menggunakan referensi SDK server Amazon GameLift C++ ini untuk membantu Anda mempersiapkan game multipemain untuk digunakan dengan Amazon. GameLift Untuk detail tentang proses integrasi, lihatTambahkan Amazon GameLift ke server game Anda.
API ini didefinisikan dalam GameLiftServerAPI.h
, LogParameters.h
, dan ProcessParameters.h
.
-
Jenis Data
DescribePlayerSessionsRequest
Jenis data ini digunakan untuk menentukan sesi pemain untuk diambil. Anda bisa menggunakannya sebagai berikut:
-
Menyediakan PlayerSessionId untuk meminta sesi pemain tertentu.
-
Berikan permintaan GameSessionId untuk semua sesi pemain dalam sesi permainan yang ditentukan.
-
Menyediakan PlayerId untuk meminta semua sesi pemain untuk pemain tertentu.
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 NextTokenuntuk 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 ID pemain.
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, namun pemain belum terhubung ke proses server dan/atau divalidasi.
-
ACTIVE — Pemain telah divalidasi oleh proses server dan saat ini terhubung.
-
COMPLETED — Sambungan pemain telah terputus.
-
TIMEDOUT — Permintaan sesi pemain diterima, namun pemain tidak terhubung dan/atau tidak divalidasi dalam batas waktu (60 detik).
Tipe: String
Wajib: Tidak
-
LogParameters
Tipe data ini digunakan untuk mengidentifikasi file mana yang dihasilkan selama sesi permainan yang Anda inginkan Amazon GameLift untuk mengunggah dan menyimpan setelah sesi permainan berakhir. Informasi ini dikomunikasikan ke GameLift layanan Amazon dalam ProcessReady() panggilan.
Daftar Isi
- logPaths
-
Jalur direktori ke file log server game yang ingin disimpan Amazon GameLift untuk akses di masa mendatang. File-file ini dihasilkan selama setiap sesi game. Jalur file dan nama didefinisikan dalam server game Anda dan disimpan dalam direktori build root game. Jalur log harus mutlak. Misalnya, jika build game Anda menyimpan log sesi game di jalur seperti
MyGame\sessionlogs\
, maka jalur log akan menjadic:\game\MyGame\sessionLogs
(di instans Windows) atau/local/game/MyGame/sessionLogs
(di instans Linux).Jenis: std:vector<std::string>
Wajib: Tidak
ProcessParameters
Tipe data ini berisi kumpulan parameter yang dikirim ke GameLift layanan Amazon 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.
Tipe: Bilangan Bulat
Wajib: Ya
- logParameters
-
Obyek dengan daftar jalur direktori untuk file log sesi game.
Jenis: Aws::GameLift:: Server:: LogParameters
Wajib: Tidak
- onStartGameSesi
-
Nama fungsi callback yang dipanggil GameLift layanan Amazon untuk mengaktifkan sesi game baru. Amazon GameLift memanggil fungsi ini sebagai respons terhadap permintaan klien CreateGameSession. Fungsi callback meneruskan GameSessionobjek (didefinisikan dalam Amazon GameLift Service API Reference).
Tipe:
const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession
Wajib: Ya
- onProcessTerminate
-
Nama fungsi callback yang dipanggil GameLift layanan Amazon untuk memaksa proses server dimatikan. Setelah memanggil fungsi ini, Amazon GameLift menunggu lima menit hingga proses server dimatikan dan merespons dengan ProcessEnding() panggilan. Jika tidak ada respon yang diterima, proses server akan dimatikan.
Tipe:
std::function<void()> onProcessTerminate
Wajib: Tidak
- onHealthCheck
-
Nama fungsi callback yang dipanggil GameLift layanan Amazon untuk meminta laporan status kesehatan dari proses server. Amazon GameLift memanggil fungsi ini setiap 60 detik. Setelah memanggil fungsi ini Amazon GameLift menunggu 60 detik untuk respons, dan jika tidak ada yang diterima. mencatat proses server sebagai tidak sehat.
Tipe:
std::function<bool()> onHealthCheck
Wajib: Tidak
- onUpdateGameSesi
-
Nama fungsi callback yang dipanggil GameLift layanan Amazon untuk meneruskan objek sesi game yang diperbarui ke proses server. Amazon GameLift memanggil fungsi ini ketika permintaan isi ulang pertandingan telah diproses untuk menyediakan data mak comblang yang diperbarui. Ini melewati GameSessionobjek, pembaruan status (
updateReason
), dan ID tiket isi ulang pertandingan.Tipe:
std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession
Wajib: Tidak
StartMatchBackfillRequest
Jenis data ini digunakan untuk mengirim permintaan backfill matchmaking. Informasi tersebut dikomunikasikan ke GameLift layanan Amazon dalam StartMatchBackfill() panggilan.
Daftar Isi
- GameSessionArn
-
Pengidentifikasi sesi game yang unik. Tindakan API GetGameSessionId() mengembalikan pengidentifikasi dalam format ARN.
Tipe: 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.
Tipe: 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 GameLift API Amazon 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: std: vektorhttps://docs.aws.amazon.com/gamelift/latest/apireference/API_Player.html <player>
Wajib: Ya
- TicketId
-
Pengidentifikasi unik untuk tiket permintaan matchmaking atau backfill match. Jika tidak ada nilai yang disediakan di sini, Amazon GameLift akan menghasilkan satu dalam bentuk UUID. Gunakan pengidentifikasi ini untuk melacak status tiket backfill match atau membatalkan permintaan jika diperlukan.
Tipe: String
Wajib: Tidak
StopMatchBackfillRequest
Jenis data ini digunakan untuk membatalkan permintaan backfill matchmaking. Informasi tersebut dikomunikasikan ke GameLift layanan Amazon dalam StopMatchBackfill() panggilan.
Daftar Isi
- GameSessionArn
-
Pengidentifikasi sesi game unik yang terkait dengan permintaan yang dibatalkan.
Tipe: String
Wajib: Ya
- MatchmakingConfigurationArn
-
Pengidentifikasi unik dari matchmaker sebagai tujuan pengiriman permintaan ini.
Tipe: String
Wajib: Ya
- TicketId
-
Pengidentifikasi unik dari tiket backfill match yang akan dibatalkan.
Tipe: String
Wajib: Ya