View a markdown version of this page

C++ server SDK 5.x untuk GameLift Server Amazon - Tipe data - GameLift Server Amazon
LogParametersMetricsParametersCustomLoggerConfigurationProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPemainDescribePlayerSessionsRequestStopMatchBackfillRequestAttributeValueGetFleetRoleCredentialsRequestAwsLongOutcomeAwsStringOutcomeDescribePlayerSessionsOutcomeDescribePlayerSessionsResultGenericOutcomeGenericOutcomeCallablePlayerSessionStartMatchBackfillOutcomeStartMatchBackfillResultGetComputeCertificateOutcomeGetComputeCertificateResultGetFleetRoleCredentialsOutcomeGetFleetRoleCredentialsResultListContainersNetworkInfoOutcomeListContainersNetworkInfoResultContainerNetworkInfoInitsdkOutcomeGameLiftErrorEnum

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

C++ server SDK 5.x untuk GameLift Server Amazon - Tipe data

Gunakan referensi Amazon GameLift Servers C++ server SDK 5.x untuk mengintegrasikan game multipemain Anda untuk hosting denganAmazon GameLift Servers. Untuk panduan tentang proses integrasi, lihatTambahkan GameLift Server Amazon ke server game Anda dengan SDK server.

catatan

Topik ini menjelaskan API Amazon GameLift Servers C++ yang dapat Anda gunakan saat membangun dengan C++ Standard Library (std). Secara khusus, dokumentasi ini berlaku untuk kode yang Anda kompilasi dengan -DDGAMELIFT_USE_STD=1 opsi.

C++ server SDK 5.x 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 absolut. 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: std:vector<std::string>

Wajib: Tidak

MetricsParameters

Gunakan tipe data ini untuk mengonfigurasi pengumpulan metrik dan pelaporan kerusakan untuk server game. Server game berkomunikasi MetricsParameters dengan Amazon GameLift Servers dalam InitMetrics() panggilan.

Sifat-sifat

 Deskripsi
StatsdHost

Nama host atau alamat IP server statSD untuk pengumpulan metrik.

Jenis: std::string

Wajib: Tidak
StatsdPort

Nomor port server StatsD untuk pengumpulan metrik.

Jenis: int

Wajib: Tidak
CrashReporterHost

Nama host atau alamat IP server reporter kerusakan.

Jenis: std::string

Wajib: Tidak
CrashReporterPort

Nomor port server reporter kerusakan.

Jenis: int

Wajib: Tidak
FlushIntervalMs

Interval dalam milidetik untuk membilas data metrik ke server.

Jenis: int

Wajib: Tidak
MaxPacketSize

Ukuran maksimum dalam byte untuk paket metrik yang dikirim ke server.

Jenis: int

Wajib: Tidak

CustomLoggerConfiguration

Gunakan tipe data ini untuk merutekan output log SDK server ke callback log kustom. Server game berkomunikasi CustomLoggerConfiguration dengan Amazon GameLift Servers dalam InitCustomLogger() panggilan.

Sifat-sifat

 Deskripsi
panggilan balik

Amazon GameLift Serversmemanggil fungsi callback ini untuk setiap pesan log. Fungsi menerima tingkat log, string pesan yang telah diformat sebelumnya, dan pointer userData konteks. Penunjuk pesan hanya valid selama durasi panggilan balik; salin pesan jika Anda perlu menyimpannya. SDK menyerialkan panggilan balik, tetapi utas apa pun mungkin memanggil panggilan balik. Nilai ini tidak bolehnull; operasi menolak null panggilan balik denganBAD_REQUEST_EXCEPTION.

Jenis: Aws::GameLift::Server::LogCallback (void(*)(LogLevel level, const char* message, void* userData))

Wajib: Ya
userData

Pointer konteks yang disediakan pengguna yang diteruskan Amazon GameLift Servers ke panggilan balik pada setiap pemanggilan. SDK tidak mengelola masa pakainya. Pointer ini harus tetap valid sampai proses berakhir.

Jenis: void*

Wajib: Tidak
minimum LogLevel

Tingkat log minimum untuk SDK. Amazon GameLift Serverstidak akan memanggil panggilan balik yang disediakan untuk log di bawah level ini. Nilai default-nya adalah LogLevel::Info. Untuk menonaktifkan logging, atur nilai ini keLogLevel::Off.

Jenis: nilai Aws::GameLift::Server::LogLevel enum

Wajib: Tidak

ProcessParameters

Tipe data ini berisi kumpulan parameter yang dikirim ke Amazon GameLift Servers dalam aProcessReady().

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: Aws::GameLift::Server::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: std::function<bool()> onHealthCheck

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: std::function<void()> onProcessTerminate

Wajib: Ya
OnStartGameSession Fungsi callback yang memang Amazon GameLift Servers gil untuk mengaktifkan sesi permainan baru. Amazon GameLift Serversmemanggil fungsi ini sebagai respons terhadap permintaan klien CreateGameSession. Fungsi callback meneruskan GameSession objek.

Jenis: const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession

Wajib: Ya
OnUpdateGameSession 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: std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession

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: Integer

Wajib: Ya

UpdateGameSession

Jenis data ini diperbarui ke 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: Aws::GameLift::Server::GameSession

Wajib: Ya
UpdateReason Alasan bahwa sesi permainan sedang diperbarui.

Jenis: Aws::GameLift::Server::UpdateReason

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

Jenis: std::string

Wajib: Tidak

GameSession

Jenis data ini memberikan rincian sesi permainan.

Sifat-sifat Deskripsi
GameSessionId

Pengidentifikasi unik untuk sesi permainan. Sesi permainan ARN memiliki format berikut:arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>.

Jenis: std::string

Wajib: Tidak
Nama

Label deskriptif dari sesi permainan.

Jenis: std::string

Wajib: Tidak
FleetId

Pengidentifikasi unik untuk armada tempat sesi permainan berjalan.

Jenis: std::string

Wajib: Tidak
MaximumPlayerSessionCount

Jumlah maksimum koneksi pemain ke sesi permainan.

Jenis: int

Wajib: Tidak
Port

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

Jenis: in

Wajib: Tidak
IpAddress

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

Jenis: std::string

Wajib: Tidak
GameSessionData

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

Jenis: std::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: std::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: std :: vector < GameProperty >

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: std::string

Wajib: Tidak

ServerParameters

Informasi yang digunakan proses server game untuk membuat koneksi dengan Amazon GameLift Servers layanan. Sertakan parameter ini saat memanggil InitSDK() hanya jika build server game akan dikerahkan ke armada Anywhere atau armada kontainer tanpa Amazon GameLift Servers Agen. Untuk semua skenario penerapan lainnya, panggil InitSDK() tanpa parameter.

Sifat-sifat Deskripsi
web SocketUrl

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

Jenis: std::string

Wajib: Ya

ProsesID

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

Jenis: std::string

Wajib: Ya
Tuan rumah Ini HostID adalah yang ComputeName digunakan saat Anda mendaftarkan komputasi Anda. Untuk informasi selengkapnya, lihat RegisterCompute.

Jenis: std::string

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

Jenis: std::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: std::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: std::string

Wajib: Ya
MatchmakingConfigurationArn

Pengidentifikasi unik, dalam bentuk ARN, untuk digunakan matchmaker untuk permintaan ini. ARN matchmaker untuk sesi game asli ada di objek sesi game di properti data matchmaker. Pelajari selengkapnya tentang data matchmaker di Bekerja dengan data matchmaker.

Jenis: std::string

Wajib: Ya
Pemain

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

Jenis: std::vector<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: std::string

Wajib: Tidak

Pemain

Tipe data ini mewakili pemain dalam perjodohan. Saat memulai permintaan perjodohan, 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: Dictionary<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: std::map<std::string,AttributeValue>

Wajib: Tidak
PlayerId

Pengidentifikasi unik untuk pemain.

Jenis: std::string

Wajib: Tidak
Tim

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

Jenis: std::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 a

Jenis: std::string

Wajib: Tidak
PlayerSessionId

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

Jenis: std::string

Wajib: Tidak
PlayerId

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

Jenis: std::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: std::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: std::string

Wajib: Tidak
Kuota

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: char[]

Wajib: Tidak
MatchmakingConfigurationArn

Pengidentifikasi unik dari matchmaker yang dikirim permintaan ini.

Jenis: char[]

Wajib: Tidak
TicketId

Pengidentifikasi unik tiket permintaan isi ulang yang akan dibatalkan.

Jenis: char[]

Wajib: Tidak

AttributeValue

Gunakan nilai-nilai ini dalam pasangan Pemain kunci-nilai atribut. Objek ini memungkinkan Anda menentukan nilai atribut menggunakan salah satu jenis data yang valid: string, angka, array string, atau peta data. Setiap AttributeValue objek harus menggunakan tepat salah satu properti yang tersedia:S,N,SL, atauSDM.

Sifat-sifat Deskripsi
AttrType

Menentukan jenis nilai atribut. Jenis nilai atribut yang mungkin meliputi:

  • TIDAK ADA

  • TALI

  • GANDA

  • DAFTAR STRING

  • STRING_DOUBLE_MAP

Wajib: Tidak
D

Merupakan nilai atribut string.

Jenis: std::string

Wajib: Tidak
T

Merupakan nilai atribut numerik.

Jenis: double

Wajib: Tidak
SL

Merupakan array nilai atribut string.

Jenis: std::vector<std::string>

Wajib: Tidak
SDM

Merupakan kamus kunci string dan nilai ganda.

Jenis: std::map<std::string, double>

Wajib: Tidak

GetFleetRoleCredentialsRequest

Jenis data ini memberi server game akses terbatas ke AWS sumber daya Anda yang lain. Untuk informasi selengkapnya, lihat Menyiapkan peran layanan IAM untuk Amazon GameLift Servers.

Sifat-sifat Deskripsi
RoleArn Nama Sumber Daya Amazon (ARN) dari peran layanan yang memperluas akses terbatas ke AWS sumber daya Anda.

Jenis: std::string

Wajib: Tidak
RoleSessionName Nama sesi peran yang dapat Anda gunakan untuk mengidentifikasi AWS Security Token Service AssumeRole sesi secara unik. Nama ini diekspos dalam log audit seperti yang ada di CloudTrail.

Jenis: std::string

Wajib: Tidak

AwsLongOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: long

Wajib: Tidak
ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: long&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

AwsStringOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: std::string

Wajib: Tidak
ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: long&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

DescribePlayerSessionsOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: DescribePlayerSessionsResult

Wajib: Tidak

ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: Aws::GameLift::Server::Model::DescribePlayerSessionsResult&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

DescribePlayerSessionsResult

Kumpulan objek yang berisi properti untuk setiap sesi pemain yang cocok dengan permintaan.

Sifat-sifat Deskripsi
NextToken

Token yang menunjukkan awal halaman hasil berurutan berikutnya. Gunakan token yang dikembalikan dengan panggilan sebelumnya ke operasi ini. Untuk memulai di awal set hasil, jangan tentukan nilai. Jika ID sesi pemain ditentukan, parameter ini diabaikan.

Jenis: std::string

Wajib: Ya
PlayerSessions

Jenis: IList<PlayerSession>

Diperlukan:

ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: std::string&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

GenericOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

GenericOutcomeCallable

Tipe data ini adalah hasil generik asinkron. Ini memiliki sifat-sifat berikut:

Sifat-sifat Deskripsi
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

PlayerSession

Jenis data ini mewakili sesi pemain yang Amazon GameLift Servers diteruskan ke server game. Untuk informasi selengkapnya, lihat PlayerSession.

Sifat-sifat Deskripsi
CreationTime

Jenis: long

Wajib: Tidak
FleetId

Jenis: std::string

Wajib: Tidak
GameSessionId

Jenis: std::string

Wajib: Tidak
IpAddress

Jenis: std::string

Wajib: Tidak
PlayerData

Jenis: std::string

Wajib: Tidak
PlayerId

Jenis: std::string

Wajib: Tidak
PlayerSessionId

Jenis: std::string

Wajib: Tidak
Port

Jenis: int

Wajib: Tidak
Status

Status sesi pemain untuk mem-filter hasil. Ketika PlayerSessionId atau PlayerId disediakan, maka tidak PlayerSessionStatusFilter berpengaruh pada respons.

Jenis: A PlayerSessionStatus enum. Kemungkinan nilainya mencakup berikut ini:

  • AKTIF

  • SELESAI

  • TIDAK DITETAPKAN

  • DIPESAN

  • BATAS WAKTU

Wajib: Tidak
TerminationTime

Jenis: long

Wajib: Tidak
DnsName

Jenis: std::string

Wajib: Tidak

StartMatchBackfillOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: StartMatchBackfillResult

Wajib: Tidak
ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: StartMatchBackfillResult&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

StartMatchBackfillResult

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
TicketId

Pengidentifikasi unik untuk tiket perjodohan. Jika tidak ada ID tiket yang ditentukan di sini, Amazon GameLift Servers akan menghasilkan satu dalam bentuk UUID. Gunakan pengenal ini untuk melacak status tiket isi ulang pertandingan dan mengambil hasil pertandingan.

Jenis: std::string

Wajib: Tidak

GetComputeCertificateOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: GetComputeCertificateResult

Wajib: Tidak

ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: Aws::GameLift::Server::Model::GetComputeCertificateResult&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

GetComputeCertificateResult

Jalur ke sertifikat TLS pada komputasi Anda dan nama host komputasi.

Sifat-sifat Deskripsi
CertificatePath

Jalur ke sertifikat TLS pada sumber daya komputasi Anda. Saat menggunakan armada yang Amazon GameLift Servers dikelola, jalur ini berisi:

  • certificate.pem: Sertifikat pengguna akhir. RanTAI sertifikat lengkap adalah kombinasi yang certificateChain.pem ditambahkan ke sertifikat ini.

  • certificateChain.pem: RanTAI sertifikat yang berisi sertifikat root dan sertifikat perantara.

  • rootCertificate.pem: Sertifikat root.

  • privateKey.pem: Kunci pribadi untuk sertifikat pengguna akhir.

Jenis: std::string

Wajib: Tidak
ComputeName

Nama sumber daya komputasi Anda.

Jenis: std::string

Wajib: Tidak

GetFleetRoleCredentialsOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: GetFleetRoleCredentialsResult

Wajib: Tidak

ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: Aws::GameLift::Server::Model::GetFleetRoleCredentialsResult

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

GetFleetRoleCredentialsResult

Sifat-sifat Deskripsi
AccessKeyId

ID kunci akses untuk mengotentikasi dan menyediakan akses ke AWS sumber daya Anda.

Jenis: string

Wajib: Tidak
AssumedRoleId

ID pengguna yang menjadi milik peran layanan.

Jenis: string

Wajib: Tidak
AssumedRoleUserArn

Nama Sumber Daya Amazon (ARN) dari pengguna yang menjadi milik peran layanan.

Jenis: string

Wajib: Tidak
Kedaluwarsa

Jumlah waktu hingga kredentif sesi Anda kedaluwarsa.

Jenis: DateTime

Wajib: Tidak
SecretAccessKey

ID kunci akses rahasia untuk otentikasi.

Jenis: string

Wajib: Tidak
SessionToken

Token untuk mengidentifikasi sesi aktif saat ini yang berinteraksi dengan AWS sumber daya Anda.

Jenis: string

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

ListContainersNetworkInfoOutcome

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:

Sifat-sifat Deskripsi
Hasil

Hasil dari tindakan.

Jenis: ListContainersNetworkInfoResult

Wajib: Tidak

ResultWithOwnership

Hasil tindakan, diberikan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.

Jenis: Aws::GameLift::Server::Model::ListContainersNetworkInfoResult&&

Wajib: Tidak
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

ListContainersNetworkInfoResult

Informasi jaringan untuk semua kontainer yang berjalan pada instance yang sama dengan proses pemanggilan server game.

Sifat-sifat Deskripsi
ContainersNetworkInfo

Daftar informasi jaringan untuk setiap wadah yang berjalan pada instance.

Jenis: std::vector<ContainerNetworkInfo> kapan GAMELIFT_USE_STD didefinisikan; jika tidak, array tetap dengan nama aksesor. GetContainersNetworkInfoCount()

Wajib: Tidak

ContainerNetworkInfo

Informasi jaringan untuk satu wadah yang berjalan pada instance.

Sifat-sifat Deskripsi
ContainerName

Nama wadah, seperti yang didefinisikan dalam definisi grup kontainer.

Jenis: std::string kapan GAMELIFT_USE_STD didefinisikan; sebaliknyachar[].

Wajib: Tidak
ContainerId

Pengidentifikasi unik wadah.

Jenis: std::string kapan GAMELIFT_USE_STD didefinisikan; sebaliknyachar[].

Wajib: Tidak
IpAddress

Alamat IPv4 lokal kontainer pada jaringan jembatan Docker.

Jenis: std::string kapan GAMELIFT_USE_STD didefinisikan; sebaliknyachar[].

Wajib: Tidak
ContainerGroupType

Jenis grup kontainer yang dimiliki wadah tersebut.

Jenis: A ContainerGroupType enum.

Wajib: Tidak

InitsdkOutcome

catatan

InitSDKOutcomedikembalikan hanya ketika Anda membangun SDK dengan ben std dera. Jika Anda membangun dengan nostd bendera, maka GenericOutcome dikembalikan sebagai gantinya.

Sifat-sifat Deskripsi
Berhasil

Apakah tindakan itu berhasil atau tidak.

Jenis: bool

Wajib: Ya
Kesalahan

Kesalahan yang terjadi jika tindakan tidak berhasil.

Jenis: GameLiftError

Wajib: Tidak

GameLiftError

Sifat-sifat Deskripsi
ErrorType

Jenis kesalahan.

Jenis: A GameLiftErrorType enum.

Wajib: Tidak

ErrorName

Nama kesalahan.

Jenis: std::string

Wajib: Tidak

ErrorMessage

Pesan kesalahan.

Jenis: std::string

Wajib: Tidak

Enum

Enum yang ditentukan untuk server SDK untuk Amazon GameLift Servers (C++) didefinisikan sebagai berikut:

GameLiftErrorType

Nilai string yang menunjukkan jenis kesalahan. Nilai yang valid meliputi:

  • PENGECUALIAN PERMINTAAN BURUK

  • GAMESESSION_ID_NOT_SET — ID sesi permainan belum ditetapkan.

  • PENGECUALIAN LAYANAN INTERNAL

  • UNSUPPORTED_COMPUTE_TYPE_EXCEPTION — API yang dipanggil tidak didukung pada tipe komputasi.

  • LOCAL_CONNECTION_FAILED — Koneksi lokal gagal. Amazon GameLift Servers

  • NETWORK_NOT_INITIALIZED — Jaringan belum diinisialisasi.

  • SERVICE_CALL_FAIL ED — Panggilan ke layanan gagal. AWS

  • WEBSOCKET_CONNECT_FAILURE

  • WEBSOCKET_CONNECT_FAILURE_FORBIDDEN

  • WEBSOCKET_CONNECT_FAILURE_INVALID_URL

  • WEBSOCKET_CONNECT_FAILURE_TIMEOUT

  • ALREADY_INITIALIZED — Amazon GameLift Servers Server atau Klien telah diinisialisasi dengan Initialize ().

  • FLEET_MISMATCH — Armada target tidak cocok dengan armada GameSession atau PlayerSession.

  • GAMELIFT_CLIENT_NOT_INITIALIZED — Klien belum diinisialisasi. Amazon GameLift Servers

  • GAMELIFT_SERVER_NOT_INITIALIZED — Server belum diinisialisasi. Amazon GameLift Servers

  • GAME_SESSION_ENDED_FAILED — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan sesi game berakhir.

  • GAME_SESSION_NOT_READY — Sesi Game Server tidak diaktifkan. Amazon GameLift Servers

  • GAME_SESSION_READY_FAILED — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan sesi game sudah siap.

  • INITIALIZATION_MISMATCH — Metode klien dipanggil setelah Server: :Initialize (), atau sebaliknya.

  • NOT_INITIALIZED — Amazon GameLift Servers Server atau Klien belum diinisialisasi dengan Initialize ().

  • NO_TARGET_ALIASID_SET — AliaSid target belum ditetapkan.

  • NO_TARGET_FLEET_SET — Armada target belum ditetapkan.

  • PROCESS_ENDING_FAIL ED — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan proses berakhir.

  • PROCESS_NOT_ACTIVE — Proses server belum aktif, tidak terikat pada a GameSession, dan tidak dapat menerima atau memproses. PlayerSessions

  • PROCESS_NOT_READY — Proses server belum siap untuk diaktifkan.

  • PROCESS_READY_F AILED — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan proses sudah siap.

  • SDK_VERSION_DETECTION_FAILED — Deteksi versi SDK gagal.

  • STX_CALL_FAILED — Panggilan ke komponen backend server XSTx gagal.

  • STX_INITIALIZATION_FAILED — Komponen backend server XSTx gagal diinisialisasi.

  • UNEXPECTED_PLAYER_SESSION — Sesi pemain yang tidak terdaftar ditemui oleh server.

  • WEBSOCKET_CONNECT_FAILURE

  • WEBSOCKET_CONNECT_FAILURE_FORBIDDEN

  • WEBSOCKET_CONNECT_FAILURE_INVALID_URL

  • WEBSOCKET_CONNECT_FAILURE_TIMEOUT

  • WEBSOCKET_RETRIABLE_SEND_MESSAGE_FAILURE — Kegagalan yang dapat diambil untuk mengirim pesan ke Layanan. GameLift WebSocket

  • WEBSOCKET_SEND_MESSAGE_FAILURE — Gagal mengirim pesan ke Layanan. GameLift WebSocket

  • MATCH_BACKFILL_REQUEST_VALIDATION — Validasi permintaan gagal.

  • PLAYER_SESSION_REQUEST_VALIDATION — Validasi permintaan gagal.

ContainerGroupType

Jenis grup kontainer yang dimiliki wadah. Nilai yang valid meliputi:

  • GAME_SERVER — Grup kontainer replika server game. Sebuah instance dapat memiliki beberapa grup kontainer server game.

  • PER_INSTANCE — Grup kontainer daemon per instans. Sebuah instance memiliki tepat satu grup kontainer per instans.

PlayerSessionCreationPolicy

Nilai string yang menunjukkan apakah sesi game menerima pemain baru. Nilai yang valid meliputi:

  • ACCEPT_ALL — Menerima semua sesi pemain baru.

  • DENY_ALL — Menolak semua sesi pemain baru.

  • NOT_SET — Sesi permainan tidak diatur untuk menerima atau menolak sesi pemain baru.

LogLevel

Tingkat keparahan pesan log. Nilai meningkat keparahan dari Trace (paling bertele-tele) menjadi Fatal (paling parah). Offbukan tingkat keparahan log, tetapi Anda dapat menggunakannya sebagai tingkat log minimum di a CustomLoggerConfiguration untuk menonaktifkan logging. Nilai yang valid meliputi:

  • Jejak — Level paling bertele-tele, digunakan untuk pesan diagnostik berbutir halus.

  • Debug - Informasi terperinci berguna untuk debugging.

  • Info - Pesan informasi umum. Ini adalah tingkat log minimum default.

  • Peringatkan — Pesan yang menunjukkan potensi masalah.

  • Kesalahan — Pesan yang menunjukkan kesalahan yang dapat dipulihkan.

  • Fatal — Level paling parah, digunakan untuk kesalahan yang tidak dapat dipulihkan.

  • Non aktif — Menonaktifkan semua pengiriman panggilan balik log.