View a markdown version of this page

Go server SDK untuk GameLift Server Amazon - Tipe data - GameLift Server Amazon
LogParametersMetricsParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPemainDescribePlayerSessionsRequestStopMatchBackfillRequestGetFleetRoleCredentialsRequest

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

Go server SDK untuk GameLift Server Amazon - Tipe data

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

GameLiftServerAPI.gomendefinisikan tindakan SDK server Go.

Go server SDK untuk GameLift Server Amazon -- Tindakan

LogParameters

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

Sifat-sifat

 Deskripsi
LogPaths

Daftar jalur direktori ke file log server game yang ingin Anda simpan Amazon GameLift Servers untuk akses di masa mendatang. 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 mutlak. Misalnya, jika build game Anda menyimpan log sesi game di jalur sepertiMyGame\sessionLogs\, maka jalur tersebut akan berada c:\game\MyGame\sessionLogs di instance Windows.

Jenis: []string

Wajib: Tidak

MetricsParameters

Objek mengkomunikasikan parameter konfigurasi untuk menginisialisasi sistem metrik. Konfigurasi ini digunakan untuk mengatur perilaku pelaporan StatsD, pelaporan kerusakan, dan pemrosesan metrik. Server permainan menyediakan MetricsParameters Amazon GameLift Servers sebagai bagian dari InitMetrics() panggilan.

Sifat-sifat

 Deskripsi
StatsdHost

Host server StatsD untuk pelaporan metrik (misalnya, “localhost”).

Jenis: string

Wajib: Ya
StatsdPort

Port server StatSD untuk pelaporan metrik (misalnya, 8125).

Jenis: int

Wajib: Ya
CrashReporterHost

Host reporter kecelakaan untuk pelacakan kerusakan dan pemantauan proses.

Jenis: string

Wajib: Ya
CrashReporterPort

Port reporter kecelakaan untuk pelacakan kerusakan dan pemantauan proses.

Jenis: int

Wajib: Ya
FlushIntervalMs

Interval flush metrik dalam milidetik. Mengontrol seberapa sering metrik dikirim ke StatsD.

Jenis: int

Wajib: Ya
MaxPacketSize

Ukuran paket maksimum untuk metrik dalam byte. Membatasi ukuran paket UDP yang dikirim ke StatSD.

Jenis: int

Wajib: Ya

ProcessParameters

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

Sifat-sifat

 Deskripsi
LogParameters Objek dengan jalur direktori ke file yang dihasilkan selama sesi permainan. Amazon GameLift Serversmenyalin dan menyimpan file untuk akses di masa mendatang.

Jenis: LogParameters

Wajib: Tidak
OnHealthCheck Fungsi callback yang memang Amazon GameLift Servers gil untuk meminta laporan status kesehatan dari proses server. Amazon GameLift Serversmemanggil 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 dikem Amazon GameLift Servers balikan, catat proses server sebagai tidak sehat.

Jenis: OnHealthCheck func() bool

Wajib: Tidak
OnProcessTerminate Fungsi callback yang memang Amazon GameLift Servers gil untuk memaksa proses server dimatikan. Setelah memanggil fungsi iniAmazon GameLift Servers, tunggu 5 menit hingga proses server dimatikan dan merespons dengan ProcessEnding() panggilan sebelum mematikan proses server.

Jenis: OnProcessTerminate func()

Wajib: Ya
OnStartGameSession Fungsi callback yang memang Amazon GameLift Servers gil 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.

Jenis: OnStartGameSession func (model.GameSession )

Wajib: Ya
OnUpdateGameSession Fungsi callback yang memang Amazon GameLift Servers gil untuk meneruskan informasi sesi game yang diperbarui ke proses server. Amazon GameLift Serversmemanggil fungsi ini setelah memproses permintaan isi ulang kecocokan untuk memberikan data matchmaker 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 objek sesi game, yang mencakup alasan sesi game diperbarui, dan ID tiket isi ulang terkait jika isi ulang digunakan untuk mengisi sesi pemain dalam sesi permainan.

Sifat-sifat Deskripsi
GameSession Sebuah objek GameSession. Ob GameSession jek 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

Rincian sesi permainan.

Sifat-sifat Deskripsi
GameSessionId

Pengidentifikasi unik untuk sesi permainan. Sesi permainan Nama Sumber Daya Amazon (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

Pengidentifikasi 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 Amazon GameLift Servers game, aplikasi memerlukan alamat IP dan nomor port.

Jenis: Integer

Wajib: Tidak
IpAddress

Alamat IP dari sesi game. Untuk terhubung ke server Amazon GameLift Servers game, 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 game, dalam sintaks JSON, diformat sebagai string. Selain konfigurasi perjodohan yang digunakan, ini berisi data tentang semua pemain yang ditugaskan ke pertandingan, termasuk atribut pemain dan tugas tim.

Jenis: String

Wajib: Tidak
GameProperties

Satu set properti khusus untuk sesi permainan, diformat sebagai pasangan kunci:nilai. Properti ini dilewatkan dengan permintaan untuk memulai sesi permainan baru.

Jenis: map[string] string

Wajib: Tidak
DnsName

Pengidentifikasi DNS yang ditetapkan ke instance yang menjalankan sesi game. Nilai memiliki format berikut:

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

  • Non-TLS-enabled armada:ec2-<unique identifier>.compute.amazonaws.com.

Saat menghubungkan ke sesi game yang berjalan di TLS-enabled armada, Anda harus menggunakan nama DNS, bukan alamat IP.

Jenis: String

Wajib: Tidak

ServerParameters

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

Sifat-sifat Deskripsi
WebSocketURL

Pengem GameLiftServerSdkEndpoint Amazon GameLift Servers balian saat Anda RegisterCompute untuk sumber daya kom Amazon GameLift Servers putasi Anywhere.

Jenis: string

Wajib: Ya
ProcessID

Pengidentifikasi 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.

Ini HostID adalah yang ComputeName digunakan saat Anda mendaftarkan komputasi Anda. Untuk informasi selengkapnya, lihat RegisterCompute.

Jenis: string

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

Jenis: string

Wajib: Ya
AuthToken Token otentikasi yang dihasilkan oleh Amazon GameLift Servers itu mengotentikasi server Anda keAmazon GameLift Servers. Untuk informasi selengkapnya, lihat GetComputeAuthToken.

Jenis: string

Wajib: Ya

StartMatchBackfillRequest

Informasi yang digunakan untuk membuat permintaan isi ulang perjodohan. Server permainan mengkomunikasikan informasi ini Amazon GameLift Servers dalam StartMatchBackfill() panggilan.

Sifat-sifat Deskripsi
GameSessionArn

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

Jenis: String

Wajib: Ya
MatchmakingConfigurationArn

Pengidentifikasi unik (dalam bentuk ARN) untuk matchmaker untuk digunakan untuk permintaan ini. ARN matchmaker untuk sesi game asli ada di objek sesi game di properti data matchmaker. Untuk informasi selengkapnya tentang data matchmaker, lihat Bek erja dengan data matchmaker.

Jenis: String

Wajib: Ya
Pemain

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

Jenis: []model.Player

Wajib: Ya
TicketId

Pengidentifikasi unik untuk tiket perjodohan atau permintaan isi ulang pertandingan. Jika Anda tidak memberikan nilai, Amazon GameLift Servers buat satu. 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 kemungkinan data latensi. Amazon GameLift Serversmenambahkan informasi tim setelah pertandingan dibuat.

Sifat-sifat Deskripsi
LatencyInMS

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

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

Jenis: map[string] int

Wajib: Tidak
PlayerAttributes

Kumpulan pasangan kunci:nilai 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

Pengidentifikasi 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 keAmazon GameLift Servers.

Sifat-sifat Deskripsi
GameSessionID

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

Format ID sesi permainan adalaharn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. Ini GameSessionID adalah string ID khusus atau string yang dihasilkan.

Jenis: String

Wajib: Tidak
PlayerSessionID

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

Jenis: String

Wajib: Tidak
PlayerID

Pengidentifikasi unik untuk pemain. Gunakan parameter ini untuk meminta semua sesi pemain untuk pemain tertentu. Lihat Hasilkan pemain IDs.

Jenis: String

Wajib: Tidak
PlayerSessionStatusFilter

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

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

  • AKTIF — Pemain divalidasi oleh proses server dan terhubung.

  • SELESAI — Koneksi pemain terputus.

  • TIMEDOUT — Permintaan sesi pemain diterima, tetapi pemain tidak terhubung atau tidak divalidasi dalam batas waktu tunggu (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 isi ulang perjodohan. Server game mengkomunikasikan informasi ini ke Amazon GameLift Servers layanan dalam StopMatchBackfill() panggilan.

Sifat-sifat Deskripsi
GameSessionArn

Pengidentifikasi sesi permainan unik dari permintaan yang dibatalkan.

Jenis: string

Wajib: Tidak
MatchmakingConfigurationArn

Pengidentifikasi unik dari matchmaker yang dikirim permintaan ini.

Jenis: string

Wajib: Tidak
TicketId

Pengidentifikasi unik tiket permintaan isi ulang yang akan dibatalkan.

Jenis: string

Wajib: Tidak

GetFleetRoleCredentialsRequest

KredenSIAL peran yang memperluas akses terbatas ke AWS sumber daya Anda ke server game. Untuk informasi selengkapnya, lihat Menyiapkan peran layanan IAM untuk Amazon GameLift Servers.

Sifat-sifat Deskripsi
RoleArn ARN peran layanan yang memperluas akses terbatas ke AWS sumber daya Anda.

Jenis: string

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

Jenis: string

Wajib: Ya