メインコンテンツへスキップ
@capgo/capacitor-firebase-messaging コミュニケーション オープンソース

Firebase Messaging Capacitor プラグイン

Firebase Cloud Messaging (FCM) 用の Capacitor プラグイン

インストール

bun add @capgo/capacitor-firebase-messaging bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-firebase-messaging
  • pnpm add @capgo/capacitor-firebase-messaging
  • yarn add @capgo/capacitor-firebase-messaging

ガイド

Capacitor で Firebase Messaging を使う方法

@capgo/capacitor-firebase-messaging の使用方法

Firebase Cloud Messaging (FCM) 用の Capacitor プラグイン

インストール

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

bunx cap sync プラグインのネイティブ code をネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
checkPermissions プッシュ通知の受信許可を確認します。
requestPermissions プッシュ通知の受信許可をリクエストします。
isSupported 必要なAPIがすべて存在するか確認します。
getToken プッシュ通知を受け取るためにアプリを登録します。このMessagingインスタンスへのプッシュメッセージ送信に使用できるFCMトークンを返します。
deleteToken FCMトークンを削除してアプリの登録を解除し、プッシュ通知の受信を停止します。ユーザーのサインアウト時などに呼び出せます。
getDeliveredNotifications 通知画面に表示されている通知の一覧を取得します。
removeDeliveredNotifications 通知画面から特定の通知を削除します。
removeAllDeliveredNotifications 通知画面からすべての通知を削除します。
subscribeToTopic バックグラウンドでトピックを購読します。
unsubscribeFromTopic バックグラウンドでトピックの購読を解除します。
createChannel 通知チャンネルを作成します。
deleteChannel 通知チャンネルを削除します。
listChannels 利用可能な通知チャンネルを一覧表示します。

実装例

checkPermissions()

プッシュ通知の受信許可を確認します。

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

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

requestPermissions()

プッシュ通知の受信許可をリクエストします。

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

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

isSupported()

必要なAPIがすべて存在するか確認します。

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

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

getToken()

プッシュ通知を受信するためにアプリを登録します。このMessagingインスタンスへのプッシュメッセージ送信に使用できるFCMトークンを返します。

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

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

deleteToken()

FCMトークンを削除してアプリの登録を解除し、プッシュ通知の受信を停止します。ユーザーのサインアウト時などに呼び出せます。

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

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

通知画面に表示されている通知の一覧を取得します。

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

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

上記の表には13個のコアメソッドが記載されています。リスナーやバージョンのヘルパー、各メソッドの詳細な仕様については、以下に記載されています。 GitHub リポジトリ.

イベントをリッスンする

addListener ハンドルを返します。次に、 handle.remove() 画面がアンマウントされるとき、または FirebaseMessaging.removeAllListeners() すべてのリスナーを解除します。

リファレンス全文

@capgo/capacitor-firebase-messaging の使用方法へ進む

以下を使用している場合: @capgo/capacitor-firebase-messaging の使用 ネイティブプラグインの作業を計画するには、それを以下と連携させる Capgo プラグインディレクトリ Capgo プラグインディレクトリでのプロダクトワークフロー向けに、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加・更新 プラグインの追加・更新における実装詳細については、 Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案のプロダクトワークフロー、および Capgo Native Build Capgo Native Builds のプロダクトワークフローについて。

よくある質問

Firebase Messaging プラグイン FAQ

Capacitor アプリに Firebase Messaging プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-firebase-messaging"(または "npm install @capgo/capacitor-firebase-messaging")を実行し、次に "bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させます。その後、アプリの code から "@capgo/capacitor-firebase-messaging" をインポートしてください。

@capgo/capacitor-firebase-messaging は React、Vue、Angular で動作しますか?

はい。Firebase Messaging は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、およびプレーンな JavaScript を含む、Capacitor 内で動作するあらゆる Web フレームワークで使用できます。

@capgo/capacitor-firebase-messaging はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンと一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-firebase-messaging は無料のオープンソースですか?

はい。ソース code は GitHub の https://github.com/Cap-go/capacitor-firebase/tree/main/packages/messaging で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Store の審査なしで、Firebase Messaging を使用している code をアップデートできますか?

このプラグインをインストールまたはアップグレードするとネイティブの code が変わるため、ストア向けの新しいビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo によるライブアップデートで即座に配信できます。

アプリの審査を待たずに Firebase Messaging の変更をリリース

ストアビルドにプラグインを組み込めば、Capgo のライブアップデートで JavaScript、HTML、CSS の変更を数分でユーザーに配信できます。

Capgo から始める