Berdasarkan model publikasi/langganan, pesan topik FCM dapat digunakan untuk mengirim pesan ke beberapa perangkat yang mengikuti topik tertentu. Anda cukup menulis pesan topik sesuai kebutuhan dan FCM akan secara andal menangani pemilihan rute serta pengiriman pesan ke perangkat yang tepat.
Misalnya, pengguna suatu aplikasi perkiraan pasang surut laut setempat dapat memilih untuk menerima topik "pemberitahuan arus pasang surut" dan menerima notifikasi kondisi laut yang optimal untuk menangkap ikan di area tertentu. Pengguna suatu aplikasi olahraga dapat berlangganan skor terbaru otomatis pada pertandingan langsung untuk tim favoritnya.
Beberapa hal yang perlu diingat tentang topik:
Pesan topik sangat cocok untuk konten seperti cuaca atau informasi lainnya yang tersedia untuk umum.
Pesan topik dioptimalkan untuk throughput, bukan latensi. Untuk pengiriman yang cepat dan aman ke satu perangkat atau sekelompok kecil perangkat, targetkan pesan ke token pendaftaran, bukan topik.
Jika perlu mengirimkan pesan ke beberapa perangkat per pengguna, sebaiknya gunakan pesan grup perangkat untuk kasus penggunaan tersebut.
Pesan topik mendukung langganan tak terbatas untuk setiap topik. Namun, FCM memberlakukan batasan untuk hal-hal berikut ini:
- Satu instance aplikasi hanya dapat berlangganan maksimal 2.000 topik.
- Jika Anda menggunakan impor batch untuk membuat instance aplikasi berlangganan topik, setiap permintaan dibatasi hingga 1.000 instance aplikasi.
- Frekuensi langganan baru dibatasi kapasitasnya per project. Jika Anda mengirim terlalu banyak permintaan langganan dalam waktu singkat, server FCM akan memberikan respons
429 RESOURCE_EXHAUSTED
("kuota terlampaui"). Coba lagi dengan backoff eksponensial.
Membuat aplikasi klien berlangganan topik
Aplikasi klien dapat berlangganan topik yang ada atau membuat topik baru. Jika aplikasi klien berlangganan nama topik baru (nama yang belum ada untuk project Firebase Anda), topik baru dengan nama tersebut akan dibuat di FCM sehingga semua klien dapat berlangganan topik tersebut.
Untuk berlangganan topik, panggil subscribeToTopic()
dengan nama topik terkait. Metode ini menampilkan Future
, yang akan di-resolve saat langganan berhasil:
await FirebaseMessaging.instance.subscribeToTopic("topic");
Untuk berhenti berlangganan, panggil unsubscribeFromTopic()
dengan nama topik terkait.
Langkah berikutnya
- Pelajari cara mengirim pesan topik.
- Pelajari cara Mengelola langganan topik di server.
- Pelajari lebih lanjut cara lain mengirim pesan ke beberapa perangkat —pesan grup perangkat.