Amazon GameLift ServersRealtimereferensi API klien (C #): Tipe data

Referensi C# Realtime Client API ini dapat membantu Anda mempersiapkan game multipemain Anda untuk digunakan dengan Amazon GameLift Servers Realtime dikerahkan pada armada. Amazon GameLift Servers

• Tindakan Sinkron

• Panggilan Balik Asinkron

• Jenis Data

ClientConfiguration

Informasi tentang bagaimana klien game terhubung ke Realtime server.

Daftar Isi

ConnectionType

Jenis client/server koneksi yang akan digunakan, baik aman atau tidak aman. Jika Anda tidak menentukan jenis koneksi, pengaturan default-nya adalah koneksi tidak aman.

catatan

Saat menghubungkan ke server Realtime pada armada aman dengan sertifikat TLS, Anda harus menggunakan nilai RT_OVER_WSS_DTLS_. TLS12

Jenis: nilai ConnectionType enum A.

Wajib: Tidak

ConnectionToken

Informasi tentang and/or pemain klien game yang meminta koneksi dengan Realtime server.

Daftar Isi

playerSessionId

ID unik yang dikeluarkan oleh Amazon GameLift Servers saat sesi pemain baru dibuat. ID sesi pemain ditentukan dalam PlayerSession objek, yang dikembalikan sebagai respons terhadap panggilan klien ke tindakan GameLift API StartGameSessionPlacement,, CreateGameSession DescribeGameSessionPlacement, atau DescribePlayerSessions.

Tipe: String

Diperlukan: Ya

payload

Informasi yang ditentukan pengembang untuk dikomunikasikan ke server pada Realtime koneksi. Ini mencakup data acak yang mungkin digunakan untuk mekanisme kustom untuk masuk. Misalnya, payload dapat memberikan informasi otentikasi untuk diproses oleh skrip Realtime server sebelum mengizinkan klien untuk terhubung.

Jenis: byte array

Wajib: Tidak

RTMessage

Konten dan informasi pengiriman untuk pesan. Pesan harus menentukan pemain target atau grup target.

Daftar Isi

opCode

Kode operasi yang didefinisikan developer yang mengidentifikasi kejadian atau tindakan game, seperti gerakan pemain atau notifikasi server. Kode Op pesan memberikan konteks untuk muatan data yang sedang diberikan. Pesan yang dibuat menggunakan NewMessage () sudah memiliki kode operasi yang ditetapkan, tetapi dapat diubah kapan saja.

Jenis: Integer

Wajib: Ya

targetPlayer

ID unik yang mengidentifikasi pemain yang merupakan penerima pesan yang dikirim. Target mungkin server itu sendiri (menggunakan ID server) atau pemain lain (menggunakan ID pemain).

Tipe: Integer

Wajib: Tidak

targetGroup

ID unik yang mengidentifikasi grup penerima pesan yang dikirim. Grup IDs didefinisikan oleh pengembang.

Tipe: Integer

Wajib: Tidak

deliveryIntent

Menunjukkan apakah akan mengirim pesan menggunakan koneksi TCP yang andal atau menggunakan saluran UDP cepat. Pesan yang dibuat menggunakan NewMessage().

Jenis: DeliveryIntent enum

Nilai valid: FAST | RELIABLE

Wajib: Ya

payload

Isi pesan. Informasi ini terstruktur sesuai kebutuhan untuk diproses oleh client game berdasarkan kode operasi yang menyertainya. Ini mungkin berisi data status game atau informasi lain yang perlu dikomunikasikan antar client game atau antara client game dan server Realtime.

Jenis: Byte array

Wajib: Tidak

DataReceivedEventArgs

Data yang diberikan dengan callback OnDataReceived().

Daftar Isi

pengirim

ID unik yang mengidentifikasi entitas (ID pemain atau ID server) yang mengirim pesan tersebut.

Jenis: Integer

Wajib: Ya

opCode

Kode operasi yang didefinisikan developer yang mengidentifikasi kejadian atau tindakan game, seperti gerakan pemain atau notifikasi server. Kode Op pesan memberikan konteks untuk muatan data yang sedang diberikan.

Jenis: Integer

Wajib: Ya

data

Isi pesan. Informasi ini terstruktur sesuai kebutuhan untuk diproses oleh client game berdasarkan kode operasi yang menyertainya. Ini mungkin berisi data status game atau informasi lain yang perlu dikomunikasikan antar client game atau antara client game dan server Realtime.

Jenis: Byte array

Wajib: Tidak

GroupMembershipEventArgs

Data yang diberikan dengan callback OnGroupMembershipUpdated().

Daftar Isi

pengirim

ID unik mengidentifikasi pemain yang meminta pembaruan keanggotaan grup.

Jenis: Integer

Wajib: Ya

opCode

kode operasi yang didefinisikan developer yang mengidentifikasi kejadian atau tindakan game.

Jenis: Integer

Wajib: Ya

groupId

ID unik yang mengidentifikasi grup penerima pesan yang dikirim. Grup IDs didefinisikan oleh pengembang.

Jenis: Integer

Wajib: Ya

playerId

Daftar pemain IDs yang merupakan anggota saat ini dari grup yang ditentukan.

Jenis: himpunan integer

Wajib: Ya

Enum

Enum yang didefinisikan untuk SDK klien untuk Amazon GameLift Servers Realtime didefinisikan sebagai berikut:

ConnectionStatus

• CONNECTED — Klien game terhubung ke Realtime server hanya dengan koneksi TCP. Semua pesan, terlepas dari maksud pengirimannya, dikirim melalui TCP.

• CONNECTED_SEND_FAST — Klien game terhubung ke Realtime server dengan koneksi TCP dan UDP. Namun, kemampuan untuk menerima pesan melalui UDP belum diverifikasi; akibatnya, semua pesan yang dikirim ke client game menggunakan TCP.

• CONNECTED_SEND_AND_RECEIVE_FAST — Klien game terhubung ke server dengan koneksi TCP dan UDP. Realtime Client game dapat mengirim dan menerima pesan menggunakan TCP atau UDP.

• CONNECTING Game client telah mengirim permintaan koneksi dan Realtime server sedang memprosesnya.

• DISCONNECTED_CLIENT_CALL — Klien game terputus dari Realtime server sebagai tanggapan atas permintaan dari klien game. Disconnect()

• TERPUTUS - Klien game terputus dari Realtime server karena alasan selain panggilan pemutusan klien.

ConnectionType

• TLS12 RT_OVER_WSS_DTLS_ - Jenis koneksi aman.

  Untuk digunakan dengan server Realtime yang berjalan pada Amazon GameLift Servers armada dengan sertifikat TLS yang dihasilkan. Apabila menggunakan sambungan aman, lalu lintas TCP dienkripsi menggunakan TLS 1.2, dan lalu lintas UDP dienkripsi menggunakan DTLS 1.2.

• RT_OVER_WS_UDP_UNSECURED — Jenis koneksi non-aman.

• RT_OVER_WEBSOCKET – Jenis koneksi non-aman. Nilai ini tidak lagi disukai.

DeliveryIntent

• FAST - Dikirimkan menggunakan saluran UDP.

• ANDAL - Dikirimkan menggunakan koneksi TCP.