Referensi API klien Server Realtime (C #): Callback asinkron

Gunakan referensi C# Realtime Client API ini untuk membantu Anda mempersiapkan game multipemain untuk digunakan dengan Server Realtime yang digunakan di armada Amazon. GameLift Untuk informasi detail tentang proses integrasi, lihat Siapkan server Realtime.

• Tindakan Sinkron

• Callback Asinkron

• Jenis Data

Sebuah client game perlu menerapkan metode callback ini untuk menanggapi kejadian. Server Realtime memanggil callback ini untuk mengirim informasi yang berhubungan dengan game ke client game. Callback untuk kejadian yang sama juga dapat diimplementasikan dengan logika game kustom dalam skrip server Realtime. Lihat Callback skrip untuk Server Realtime.

Metode callback didefinisikan dalam ClientEvents.cs.

OnOpen()

Dipanggil ketika proses server menerima permintaan koneksi client game dan membuka koneksi.

Sintaks

public void OnOpen()

Parameter

Metode ini tidak menggunakan parameter.

Nilai kembali

Metode ini tidak mengembalikan apa pun.

OnClose()

Dipanggil ketika proses server mengakhiri koneksi dengan client game, seperti setelah sesi game berakhir.

Sintaks

public void OnClose()

Parameter

Metode ini tidak menggunakan parameter.

Nilai kembali

Metode ini tidak mengembalikan apa pun.

OnError()

Dipanggil ketika terjadi kegagalan untuk permintaan API Realtime Client API. Callback ini dapat disesuaikan untuk menangani berbagai kesalahan koneksi.

Sintaks

private void OnError(byte[] args)

Parameter

Metode ini tidak menggunakan parameter.

Nilai kembali

Metode ini tidak mengembalikan apa pun.

OnDataReceived()

Dipanggil ketika client game menerima pesan dari server Realtime. Ini adalah metode utama di mana pesan dan notifikasi diterima oleh client game.

Sintaks

public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)

Parameter

dataReceivedEventArgs

Informasi yang berkaitan dengan aktivitas pesan.

Tipe: DataReceivedEventArgs

Wajib: Ya

Nilai kembali

Metode ini tidak mengembalikan apa pun.

OnGroupMembershipUpdated()

Dipanggil ketika keanggotaan untuk grup yang ditempati pemain telah diperbarui. Callback ini juga dipanggil ketika client memanggil RequestGroupMembership.

Sintaks

public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)

Parameter

groupMembershipEventArgs

Informasi yang berkaitan dengan kegiatan keanggotaan grup.

Tipe: GroupMembershipEventArgs

Wajib: Ya

Nilai kembali

Metode ini tidak mengembalikan apa pun.