Lebihkan ke konten utama
@capgo/capacitor-firebase-messaging Komunikasi Sumber Terbuka

Pengiriman Pesan Firebase Plugin Capacitor

Capacitor plugin untuk Firebase Cloud Messaging (FCM)

Install

bun add @capgo/capacitor-firebase-messaging bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-firebase-messaging
  • pnpm add @capgo/capacitor-firebase-messaging
  • yarn add @capgo/capacitor-firebase-messaging

Panduan

Cara menggunakan Firebase Messaging di Capacitor

Menggunakan @capgo/capacitor-firebase-messaging

Plugin Capacitor untuk Firebase Cloud Messaging (FCM).

Instal

bun add @capgo/capacitor-firebase-messaging
bunx cap sync

bunx cap sync menggandakan plugin code native ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

API secara singkat

Methode Deskripsi
checkPermissions Periksa izin untuk menerima push notifikasi.
requestPermissions Minta izin untuk menerima push notifikasi.
isSupported Mengatur apakah semua API yang diperlukan ada.
getToken Mendaftarkan aplikasi untuk menerima push notifikasi. Mengembalikan token FCM yang dapat digunakan untuk mengirimkan pesan push ke instance Messaging tersebut.
deleteToken Hapus token FCM dan mendaftarkan aplikasi untuk berhenti menerima push notifikasi. Dapat dipanggil, misalnya, ketika pengguna keluar.
getDeliveredNotifications Dapatkan daftar notifikasi yang dapat dilihat di layar notifikasi.
removeDeliveredNotifications Hapus notifikasi tertentu dari layar notifikasi.
removeAllDeliveredNotifications Hapus semua notifikasi dari layar notifikasi.
subscribeToTopic Mengikuti topik di latar belakang.
unsubscribeFromTopic Menghapus diri dari topik di latar belakang.
createChannel Buat saluran pemberitahuan.
deleteChannel Hapus saluran pemberitahuan.
listChannels Daftar saluran pemberitahuan yang tersedia.

Contoh

checkPermissions()

Periksa izin untuk menerima notifikasi push.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.checkPermissions();
console.log(result);

requestPermissions()

Berikan izin untuk menerima notifikasi push.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.requestPermissions();
console.log(result);

isSupported()

Periksa apakah semua API yang diperlukan ada.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.isSupported();
console.log(result);

getToken()

Daftarkan aplikasi untuk menerima notifikasi push. Mengembalikan token FCM yang dapat digunakan untuk mengirimkan pesan push ke instance Messaging tersebut.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.getToken();
// The result holds sensitive values: use it without logging it.

deleteToken()

Hapus token FCM dan daftarkan ulang aplikasi untuk menghentikan penerimaan notifikasi push. Dapat dipanggil, misalnya, ketika pengguna keluar.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

Dapatkan daftar notifikasi yang dapat dilihat di layar notifikasi.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.getDeliveredNotifications();
console.log(result);

Daftar metode dasar di atas mencakup 13 metode utama. Pembantu pemangku jawab dan versi, serta kontrak penuh dari setiap metode, dapat dilihat di repository GitHub.

Dengarkan event

addListener kembali sebuah handle. Panggil handle.remove() ketika layar dihapus, atau FirebaseMessaging.removeAllListeners() untuk menghapus semua pemangku jawab.

Referensi lengkap

Teruskan dari Menggunakan @capgo/capacitor-firebase-messaging

Jika Anda menggunakan Gunakan @capgo/capacitor-firebase-messaging untuk merencanakan pekerjaan plugin native, hubungkannya dengan Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic, dan Capgo Pembangunan Native untuk alur kerja produk di Capgo Pembangunan Native.

FAQ

FAQ Firebase Messaging plugin

Bagaimana cara saya menginstal plugin Firebase Messaging di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-firebase-messaging" (atau "npm install @capgo/capacitor-firebase-messaging"), kemudian jalankan "bunx cap sync" agar proyek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-firebase-messaging" di aplikasi code.

Apakah @capgo/capacitor-firebase-messaging berfungsi dengan React, Vue, dan Angular?

Ya. Firebase Messaging adalah paket Capacitor, sehingga berfungsi dengan semua framework web yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-firebase-messaging?

Capgo plugin mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menampilkan versi yang dipertahankan.

Apakah @capgo/capacitor-firebase-messaging gratis dan terbuka sumber?

Ya. Sumber code tersedia secara publik di GitHub di https://github.com/Cap-go/capacitor-firebase/tree/main/packages/messaging dan paket ini dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull selalu welcome.

Dapatkah saya memperbarui code yang menggunakan Firebase Messaging tanpa melalui tinjauan App Store?

Menginstal atau mengupgrade plugin mengubah native code, sehingga memerlukan build aplikasi baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat berlalu-lalang dengan Capgo live updates.

Kirim perubahan Firebase Messaging tanpa menunggu tinjauan aplikasi

Setelah plugin masuk ke dalam toko Anda, Capgo pembaruan hidup membagikan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo