Untuk mulai menggunakan FCM, coba kasus penggunaan yang paling sederhana: mengirim pesan notifikasi ke pengguna tertentu saat aplikasi berjalan di latar belakang pada perangkat. Halaman ini membahas semua langkah untuk mencapainya, dari penyiapan hingga verifikasi. Jadi, halaman ini mencakup langkah-langkah yang mungkin telah diselesaikan ketika menyiapkan aplikasi klien JavaScript untuk FCM.
Menyiapkan SDK
Jika belum melakukannya, tambahkan Firebase ke project JavaScript Anda.
Mengakses token pendaftaran
Jika perlu mengambil token pendaftaran saat ini untuk instance aplikasi, pertama-tama minta izin notifikasi dari pengguna dengan Notification.requestPermission()
.
Jika dipanggil seperti yang ditampilkan, token akan ditampilkan jika izin diberikan atau menolak promise jika ditolak:
function requestPermission() { console.log('Requesting permission...'); Notification.requestPermission().then((permission) => { if (permission === 'granted') { console.log('Notification permission granted.');
FCM memerlukan file firebase-messaging-sw.js
.
Jika Anda belum memiliki file firebase-messaging-sw.js
, buat file kosong dengan nama tersebut, lalu
letakkan di root domain Anda sebelum mengambil token.
Anda dapat menambahkan konten yang bermakna ke file ini nanti dalam proses penyiapan klien.
Untuk mengambil token terbaru:
Web
import { getMessaging, getToken } from "firebase/messaging"; // Get registration token. Initially this makes a network call, once retrieved // subsequent calls to getToken will return from cache. const messaging = getMessaging(); getToken(messaging, { vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => { if (currentToken) { // Send the token to your server and update the UI if necessary // ... } else { // Show permission request UI console.log('No registration token available. Request permission to generate one.'); // ... } }).catch((err) => { console.log('An error occurred while retrieving token. ', err); // ... });
Web
// Get registration token. Initially this makes a network call, once retrieved // subsequent calls to getToken will return from cache. messaging.getToken({ vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => { if (currentToken) { // Send the token to your server and update the UI if necessary // ... } else { // Show permission request UI console.log('No registration token available. Request permission to generate one.'); // ... } }).catch((err) => { console.log('An error occurred while retrieving token. ', err); // ... });
Setelah memperoleh token, kirim token ke server aplikasi dan simpan menggunakan metode yang Anda pilih.
Mengirim pesan notifikasi pengujian
Instal dan jalankan aplikasi pada perangkat target. Pada perangkat Apple, Anda harus menyetujui permintaan izin untuk menerima notifikasi jarak jauh.
Pastikan aplikasi berjalan di latar belakang pada perangkat.
Di Firebase console, buka halaman Messaging.
Jika ini adalah pesan pertama Anda, pilih Create your first campaign.
- Pilih Firebase Notification messages, lalu pilih Create.
Atau, di tab Campaigns, pilih New campaign, lalu Notifications.
Masukkan teks pesan. Semua kolom lainnya bersifat opsional.
Pilih Send test message dari panel kanan.
Dalam kolom yang berlabel Add an FCM registration token, masukkan token pendaftaran yang diperoleh di bagian sebelumnya pada panduan ini.
Pilih Test.
Setelah Anda memilih Test, perangkat klien yang ditargetkan (dengan aplikasi berada di latar belakang) akan menerima notifikasi.
Langkah berikutnya
Mengirim pesan ke aplikasi di latar depan
Setelah berhasil mengirim pesan notifikasi selagi aplikasi berjalan di latar belakang, lihat Menerima Pesan di Klien JavaScript untuk memulai pengiriman ke aplikasi di latar depan.
Mempelajari topik lanjutan dari pesan notifikasi
Untuk mempelajari topik selain pesan notifikasi dan menambahkan perilaku lanjutan lain pada aplikasi Anda, lihat: