Amazon GameLift server SDK 4.x untuk C #: Tipe data - Amazon GameLift

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

Amazon GameLift server SDK 4.x untuk C #: Tipe data

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

catatan

Referensi ini untuk versi GameLift server Amazon yang lebih lamaSDK. Untuk versi terbaru, lihatAmazon GameLift server SDK 5.x untuk C # dan Unity: Tipe data.

Amazon GameLift server SDK 4.x untuk C #: Tindakan

LogParameters

Tipe data ini digunakan untuk mengidentifikasi file mana yang dihasilkan selama sesi permainan yang Anda GameLift ingin Amazon unggah dan simpan setelah sesi permainan berakhir. Informasi ini dikomunikasikan ke GameLift layanan Amazon melalui ProcessReady() panggilan.

Daftar Isi

logPaths

Daftar jalur direktori ke file log server game yang Anda ingin Amazon simpan GameLift untuk akses masa depan. File-file ini dihasilkan oleh proses server selama setiap sesi game; jalur file dan nama didefinisikan dalam server game Anda dan disimpan dalam direktori build root game. Jalur log harus absolut. Misalnya, jika build game Anda menyimpan log sesi game di jalur seperti MyGame\sessionlogs\, maka jalur log akan menjadi c:\game\MyGame\sessionLogs (di instans Windows) atau /local/game/MyGame/sessionLogs (di instans Linux).

Jenis: Daftar<String>

Wajib: Tidak

DescribePlayerSessionsRequest

Jenis data ini digunakan untuk menentukan sesi pemain untuk diambil. Ini dapat digunakan dalam beberapa cara: (1) menyediakan PlayerSessionId untuk meminta sesi pemain tertentu; (2) menyediakan GameSessionId untuk meminta semua sesi pemain dalam sesi permainan yang ditentukan; atau (3) menyediakan PlayerId untuk meminta semua sesi pemain untuk pemain yang ditentukan. Untuk koleksi sesi pemain yang besar, gunakan parameter pemberian nomor halaman untuk mengambil hasil dalam halaman 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 (jika salah satu ditentukan saat sesi game dibuat) atau 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. Pemain IDs ditentukan oleh pengembang. 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, tetapi pemain belum terhubung ke proses server dan/atau telah divalidasi.

  • ACTIVE— Pemain telah divalidasi oleh proses server dan saat ini terhubung.

  • COMPLETED— Koneksi pemain telah terputus.

  • TIMEDOUT— Permintaan sesi pemain diterima, tetapi pemain tidak terhubung dan/atau tidak divalidasi dalam batas waktu habis (60 detik).

Tipe: 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.

Jenis: Integer

Wajib: Ya

logParameters

Obyek dengan daftar jalur direktori untuk file log sesi game.

Tipe: Aws::GameLift::Server::LogParameters

Wajib: Ya

onStartGameSesi

Nama fungsi callback yang dipanggil GameLift layanan Amazon untuk mengaktifkan sesi permainan baru. Amazon GameLift memanggil fungsi ini sebagai tanggapan atas permintaan klien CreateGameSession. Fungsi callback mengambil GameSessionobjek (didefinisikan dalam APIReferensi GameLift Layanan Amazon).

Tipe: void OnStartGameSessionDelegate(GameSession gameSession)

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 sebelum mematikan proses server.

Tipe: void OnProcessTerminateDelegate()

Wajib: Ya

onHealthCheck

Nama fungsi callback yang dipanggil GameLift layanan Amazon untuk meminta laporan status kesehatan dari proses server. Amazon GameLift menyebut 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: bool OnHealthCheckDelegate()

Wajib: Ya

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 pengisian ulang kecocokan telah diproses untuk memberikan data mak comblang yang diperbarui. Ini melewati GameSessionobjek, pembaruan status (updateReason), dan ID tiket isi ulang pertandingan.

Tipe: void OnUpdateGameSessionDelegate ( UpdateGameSession updateGameSession )

Wajib: Tidak

StartMatchBackfillRequest

Jenis data ini digunakan untuk mengirim permintaan backfill matchmaking. Informasi tersebut dikomunikasikan ke GameLift layanan Amazon dalam satu StartMatchBackfill() panggilan.

Daftar Isi

GameSessionArn

Pengidentifikasi sesi game yang unik. SDKMetode GetGameSessionId() mengembalikan identifier dalam ARN format.

Tipe: String

Diperlukan: Ya

MatchmakingConfigurationArn

Pengidentifikasi unik, dalam bentukARN, untuk mak comblang untuk digunakan 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

Diperlukan: 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 GameLift API Referensi Amazon untuk deskripsi format objek Player. Untuk menemukan atribut pemainIDs, dan tugas tim, lihat objek sesi permainan, di properti data mak comblang. Jika latensi digunakan oleh matchmaker, kumpulkan latensi yang diperbarui untuk wilayah saat ini dan sertakan dalam data masing-masing pemain.

Jenis: Pemain[ ]

Wajib: Ya

TicketId

Pengidentifikasi unik untuk tiket permintaan matchmaking atau backfill match. Jika tidak ada nilai yang diberikan di sini, Amazon GameLift akan menghasilkan satu dalam bentukUUID. 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 satu StopMatchBackfill() panggilan.

Daftar Isi

GameSessionArn

Pengidentifikasi sesi game unik yang terkait dengan permintaan yang dibatalkan.

Tipe: String

Diperlukan: Ya

MatchmakingConfigurationArn

Pengidentifikasi unik dari matchmaker sebagai tujuan pengiriman permintaan ini.

Tipe: String

Diperlukan: Ya

TicketId

Pengidentifikasi unik dari tiket backfill match yang akan dibatalkan.

Tipe: String

Diperlukan: Ya