Referensi GameLift server Amazon SDK (Go): Tipe data - Amazon GameLift
LogParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPemainDescribePlayerSessionsRequestStopMatchBackfillRequestGetFleetRoleCredentialsRequest

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

Referensi GameLift server Amazon SDK (Go): Tipe data

Anda dapat menggunakan SDK referensi server Amazon GameLift Go ini untuk membantu Anda mempersiapkan game multipemain untuk digunakan dengan Amazon GameLift. Untuk detail tentang proses integrasi, lihatTambahkan Amazon GameLift ke server game Anda.

LogParameters

Objek yang mengidentifikasi file yang dihasilkan selama sesi permainan yang Anda GameLift ingin Amazon unggah dan simpan setelah sesi permainan berakhir. Server game menyediakan LogParameters ke Amazon GameLift sebagai bagian dari ProcessParameters objek dalam ProcessReady() panggilan.

Sifat-sifat

 Deskripsi
LogPaths

Daftar jalur direktori ke file log server game yang Anda ingin Amazon simpan GameLift untuk akses masa depan. Proses server menghasilkan file-file ini selama setiap sesi permainan. Anda menentukan jalur dan nama file di server game Anda dan menyimpannya di direktori build game root.

Jalur log harus absolut. Misalnya, jika build game Anda menyimpan log sesi game di jalur sepertiMyGame\sessionLogs\, maka jalurnya akan berada c:\game\MyGame\sessionLogs di instance Windows.

Jenis: []string

Wajib: Tidak

ProcessParameters

Objek yang menggambarkan komunikasi antara proses server dan Amazon GameLift. Proses server memberikan informasi ini ke Amazon GameLift dengan panggilan keProcessReady().

Sifat-sifat

 Deskripsi
LogParameters Objek dengan jalur direktori ke file yang dihasilkan selama sesi permainan. Amazon GameLift menyalin dan menyimpan file untuk akses future.

Jenis: LogParameters

Wajib: Tidak
OnHealthCheck Fungsi callback yang GameLift dipanggil Amazon untuk meminta laporan status kesehatan dari proses server. Amazon GameLift memanggil fungsi ini setiap 60 detik dan menunggu 60 detik untuk respons. Proses server kembali TRUE jika sehat, FALSE jika tidak sehat. Jika tidak ada respons yang dikembalikan, Amazon GameLift mencatat proses server sebagai tidak sehat.

Jenis: OnHealthCheck func() bool

Wajib: Tidak
OnProcessTerminate Fungsi callback yang GameLift dipanggil Amazon untuk memaksa proses server dimatikan. Setelah memanggil fungsi ini, Amazon GameLift menunggu 5 menit hingga proses server dimatikan dan merespons dengan ProcessEnding() panggilan sebelum mematikan proses server.

Jenis: OnProcessTerminate func()

Wajib: Ya
OnStartGameSession Fungsi callback yang GameLift dipanggil Amazon untuk meneruskan objek sesi game yang diperbarui ke proses server. Amazon GameLift memanggil fungsi ini ketika permintaan pengisian ulang kecocokan telah diproses untuk menyediakan data mak comblang yang diperbarui. Ini melewati GameSession objek, pembaruan status (updateReason), dan ID tiket isi ulang pertandingan.

Jenis: OnStartGameSession func (model.GameSession )

Wajib: Ya
OnUpdateGameSession Fungsi callback yang GameLift dipanggil Amazon untuk meneruskan informasi sesi game yang diperbarui ke proses server. Amazon GameLift memanggil fungsi ini setelah memproses permintaan pengisian ulang kecocokan untuk menyediakan data mak comblang yang diperbarui.

Jenis: OnUpdateGameSession func (model.UpdateGameSession)

Wajib: Tidak
Port Nomor port yang didengarkan oleh 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: int

Wajib: Ya

UpdateGameSession

Pembaruan untuk objek sesi permainan, yang mencakup alasan bahwa sesi permainan diperbarui, dan ID tiket isi ulang terkait jika pengisian ulang digunakan untuk mengisi sesi pemain dalam sesi permainan.

Properti Deskripsi
GameSession Sebuah objek GameSession. GameSessionObjek berisi properti yang menggambarkan sesi permainan.

Jenis: GameSession GameSession()

Wajib: Ya
UpdateReason Alasan bahwa sesi permainan sedang diperbarui.

Jenis: UpdateReason UpdateReason()

Wajib: Ya
BackfillTicketId ID tiket isi ulang yang mencoba memperbarui sesi permainan.

Jenis: String

Wajib: Tidak

GameSession

Detail sesi permainan.

Properti Deskripsi
GameSessionId

Pengenal unik untuk sesi permainan. Sesi permainan Amazon Resource Name (ARN) memiliki format berikut:arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.

Jenis: String

Wajib: Tidak
Nama

Label deskriptif dari sesi permainan.

Jenis: String

Wajib: Tidak
FleetId

Pengenal unik untuk armada tempat sesi permainan berjalan.

Jenis: String

Wajib: Tidak
MaximumPlayerSessionCount

Jumlah maksimum koneksi pemain ke sesi permainan.

Jenis: Integer

Wajib: Tidak
Port

Nomor port untuk sesi permainan. Untuk terhubung ke server GameLift game Amazon, aplikasi memerlukan alamat IP dan nomor port.

Jenis: Integer

Wajib: Tidak
IpAddress

Alamat IP dari sesi game. Untuk terhubung ke server GameLift game Amazon, aplikasi memerlukan alamat IP dan nomor port.

Jenis: String

Wajib: Tidak
GameSessionData

Set properti sesi game khusus, diformat sebagai nilai string tunggal.

Jenis: String

Wajib: Tidak
MatchmakerData

Informasi tentang proses perjodohan yang digunakan untuk membuat sesi permainan, dalam JSON sintaks, diformat sebagai string. Selain konfigurasi perjodohan yang digunakan, ini berisi data tentang semua pemain yang ditugaskan untuk pertandingan, termasuk atribut pemain dan tugas tim.

Jenis: String

Wajib: Tidak
GameProperties

Satu set properti kustom untuk sesi permainan, diformat sebagai pasangan key:value. Properti ini diteruskan dengan permintaan untuk memulai sesi permainan baru.

Jenis: map[string] string

Wajib: Tidak
DnsName

DNSPengenal yang ditetapkan ke instance yang menjalankan sesi permainan. Nilai memiliki format berikut:

  • TLS-armada yang diaktifkan:. <unique identifier>.<region identifier>.amazongamelift.com

  • Armada TLS yang tidak diaktifkan:. ec2-<unique identifier>.compute.amazonaws.com

Saat menghubungkan ke sesi permainan yang berjalan pada armada TLS yang diaktifkan, Anda harus menggunakan DNS nama, bukan alamat IP.

Jenis: String

Wajib: Tidak

ServerParameters

Informasi yang digunakan untuk menjaga koneksi antara GameLift Anywhere server Amazon dan GameLift layanan Amazon. Informasi ini digunakan saat meluncurkan proses server baru denganInitSDK(). Untuk server yang dihosting di EC2 instans GameLift terkelola Amazon, gunakan objek kosong.

Properti Deskripsi
WebSocketURL

GameLiftServerSdkEndpointAmazon GameLift kembali ketika Anda RegisterComputeuntuk sumber daya GameLift Anywhere komputasi Amazon.

Jenis: string

Wajib: Ya
ProcessID

Pengenal unik yang terdaftar pada proses server yang menghosting game Anda.

Jenis: string

Wajib: Ya
HostID

Pengidentifikasi unik dari sumber daya komputasi yang menghosting proses server baru.

HostIDIni adalah yang ComputeName digunakan saat Anda mendaftarkan komputasi Anda. Untuk informasi lebih lanjut, lihat RegisterCompute.

Jenis: string

Wajib: Ya
FleetID Pengidentifikasi unik armada tempat komputasi terdaftar. Untuk informasi lebih lanjut, lihat RegisterCompute.

Jenis: string

Wajib: Ya
AuthToken Token otentikasi yang dihasilkan oleh Amazon GameLift yang mengautentikasi server Anda ke Amazon. GameLift Untuk informasi lebih lanjut, lihat GetComputeAuthToken.

Jenis: string

Wajib: Ya

StartMatchBackfillRequest

Informasi yang digunakan untuk membuat permintaan pengisian ulang perjodohan. Server game mengkomunikasikan informasi ini ke Amazon GameLift dalam satu StartMatchBackfill() panggilan.

Properti Deskripsi
GameSessionArn

Pengidentifikasi sesi permainan yang unik. APIOperasi GetGameSessionId mengembalikan pengenal dalam ARN format.

Jenis: String

Wajib: Ya
MatchmakingConfigurationArn

Pengidentifikasi unik (dalam bentukARN) untuk mak comblang untuk digunakan untuk permintaan ini. Mak comblang ARN untuk sesi permainan asli ada di objek sesi permainan di properti data mak comblang. Untuk informasi selengkapnya tentang data mak comblang, lihat Bekerja dengan data mak comblang.

Jenis: String

Wajib: Ya
Pemain

Satu set data yang mewakili semua pemain yang saat ini dalam sesi permainan. Matchmaker menggunakan informasi ini untuk mencari pemain baru yang cocok untuk pemain saat ini.

Jenis: []model.Player

Wajib: Ya
TicketId

Pengenal unik untuk tiket permintaan pencocokan atau pencocokan isi ulang. Jika Anda tidak memberikan nilai, Amazon GameLift menghasilkannya. Gunakan pengidentifikasi ini untuk melacak status tiket backfill match atau membatalkan permintaan jika diperlukan.

Jenis: String

Wajib: Tidak

Pemain

Objek yang mewakili pemain dalam perjodohan. Ketika permintaan perjodohan dimulai, pemain memiliki ID pemain, atribut, dan mungkin data latensi. Amazon GameLift menambahkan informasi tim setelah pertandingan dibuat.

Properti Deskripsi
LatencyInMS

Satu set nilai yang dinyatakan dalam milidetik yang menunjukkan jumlah latensi yang dialami pemain saat terhubung ke suatu lokasi.

Jika properti ini digunakan, pemain hanya cocok untuk lokasi yang terdaftar. Jika mak comblang memiliki aturan yang mengevaluasi latensi pemain, pemain harus melaporkan latensi untuk dicocokkan.

Jenis: map[string] int

Wajib: Tidak
PlayerAttributes

Kumpulan pasangan kunci:value yang berisi informasi pemain untuk digunakan dalam perjodohan. Kunci atribut pemain harus cocok dengan yang PlayerAttributes digunakan dalam set aturan perjodohan.

Untuk informasi selengkapnya tentang atribut pemain, lihat AttributeValue.

Jenis: map[string] AttributeValue

Wajib: Tidak
PlayerId

Pengenal unik untuk pemain.

Jenis: String

Wajib: Tidak
Tim

Nama tim yang ditugaskan pemain dalam pertandingan. Anda menentukan nama tim dalam set aturan perjodohan.

Jenis: String

Wajib: Tidak

DescribePlayerSessionsRequest

Objek yang menentukan sesi pemain mana yang akan diambil. Proses server menyediakan informasi ini dengan DescribePlayerSessions() panggilan ke Amazon GameLift.

Properti Deskripsi
GameSessionID

Pengidentifikasi sesi permainan yang unik. Gunakan parameter ini untuk meminta semua sesi pemain untuk sesi game yang ditentukan.

Format ID sesi game adalaharn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. GameSessionIDIni adalah string ID kustom atau string yang dihasilkan.

Jenis: String

Wajib: Tidak
PlayerSessionID

Pengenal unik untuk sesi pemain. Gunakan parameter ini untuk meminta satu sesi pemain tertentu.

Jenis: String

Wajib: Tidak
PlayerID

Pengenal unik untuk pemain. Gunakan parameter ini untuk meminta semua sesi pemain untuk pemain tertentu. Lihat Hasilkan ID pemain.

Jenis: String

Wajib: Tidak
PlayerSessionStatusFilter

Status sesi pemain untuk memfilter hasil. Status sesi pemain yang mungkin meliputi:

  • RESERVED— Permintaan sesi pemain diterima, tetapi pemain belum terhubung ke proses server atau telah divalidasi.

  • ACTIVE— Pemain divalidasi oleh proses server dan terhubung.

  • COMPLETED— Koneksi pemain terputus.

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

Jenis: String

Wajib: Tidak
NextToken

Token yang menunjukkan awal halaman hasil berikutnya. Untuk menentukan awal kumpulan hasil, jangan berikan nilai. Jika Anda memberikan ID sesi pemain, parameter ini diabaikan.

Jenis: String

Wajib: Tidak
Limit

Jumlah hasil maksimum yang akan dikembalikan. Jika Anda memberikan ID sesi pemain, parameter ini diabaikan.

Jenis: int

Wajib: Tidak

StopMatchBackfillRequest

Informasi yang digunakan untuk membatalkan permintaan pengisian ulang perjodohan. Server game mengkomunikasikan informasi ini ke GameLift layanan Amazon dalam StopMatchBackfill() panggilan.

Properti Deskripsi
GameSessionArn

Pengidentifikasi sesi permainan unik dari permintaan yang dibatalkan.

Jenis: string

Wajib: Tidak
MatchmakingConfigurationArn

Pengidentifikasi unik dari mak comblang permintaan ini dikirim ke.

Jenis: string

Wajib: Tidak
TicketId

Pengenal unik dari tiket permintaan isi ulang yang akan dibatalkan.

Jenis: string

Wajib: Tidak

GetFleetRoleCredentialsRequest

Kredensi peran yang memperluas akses terbatas ke AWS sumber daya Anda ke server game. Untuk informasi lebih lanjut lihat,Menyiapkan peran layanan IAM untuk Amazon GameLift.

Properti Deskripsi
RoleArn Peran layanan yang memperluas akses terbatas ke AWS sumber daya Anda. ARN

Jenis: string

Wajib: Ya
RoleSessionName Nama sesi yang menjelaskan penggunaan kredensi peran.

Jenis: string

Wajib: Ya