ガイド
Capacitor での通知機能の使い方
@capgo/capacitor-notifications の使用方法
Capgo から iOS/Android のネイティブプッシュ通知を送信。ユーザー検索、バッジ、フォアグラウンド/開封トラッキング、バックグラウンドコールバック、およびサイレントな Capgo による Live Update チェックに対応。
このプラグインは Capgo の通知パイプライン向けに構築されています。Capgo はプラットフォームの認証メタデータとキャンペーン制御データを Postgres に保存し、アクティブなデバイスの状態と配信イベントは Cloudflare Analytics Engine に書き込まれます。
インストール
ガイド付きセットアップには Capgo CLI を使用してください:
npx @capgo/cli@latest notifications setup com.example.app
手動インストール:
npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync
設定
import { CapgoNotifications } from '@capgo/capacitor-notifications'
await CapgoNotifications.configure({
appId: 'com.example.app',
autoUpdater: true,
updateInstallMode: 'next',
})
署名済みユーザーを登録
発行 identityProof バックエンドから、次を使用して POST /notifications/recipients/proofその後、自分のログインが成功したらデバイスを登録します。
await CapgoNotifications.register({
externalId: 'customer-user-123',
identityProof,
tags: ['paid'],
attributes: { plan: 'team' },
consent: true,
})
イベントをリッスン
await CapgoNotifications.addListener('notificationReceived', (notification) => {
console.log('Received', notification)
})
await CapgoNotifications.addListener('notificationOpened', (event) => {
console.log('Opened', event.notification.id)
})
await CapgoNotifications.addListener('backgroundNotification', async (event) => {
try {
console.log('Background payload', event.notification.data)
} finally {
await event.finish()
}
})
iOSのセットアップ
有効にする プッシュ通知 と Background Modes > Remote notifications Xcode で選択してください。
リモート通知を以下から転送: ios/App/App/AppDelegate.swift:
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
NotificationCenter.default.post(name: Notification.Name("CapgoNotificationsRemoteNotification"), object: userInfo)
completionHandler(.newData)
}
Android セットアップ
実行 npx cap sync androidCapgo で Android プラットフォームの認証情報を設定し、Android 13+ で通知権限をリクエストしてください。Google Play 開発者サービスが搭載された実機またはエミュレータでテストしてください。
デバッグ用チェックリスト
- 実行
npx @capgo/cli@latest notifications setup com.example.app以下のフォルダからcapacitor.config.*. - Capgo で外部顧客 ID を使用して受信者を検索します。
- デバイスにプラットフォームが設定されていることを確認してください
androidまたはiosかつ、権限が付与されていること。 - 〜用の一時リスナーを追加：
registrationChanged,notificationReceived,notificationOpenedやbackgroundNotification. - ダッシュボードからテスト通知を送信します。
- キュー済み、送信済み、受信済み、開封済みイベントの統計を確認します。
- サイレントアップデートのチェックでは、以下を確認してください：
@capgo/capacitor-updaterがインストールされており、autoUpdaterが有効であること。
リファレンス全文
- ドキュメント: /docs/plugins/notifications/
- デバッグ: /docs/plugins/notifications/debugging/
- 出典: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
@capgo/capacitor-notifications の使用方法から次へ
使用している場合 @capgo/capacitor-notifications の使用方法 ネイティブのプッシュ通知を計画し、以下と連携させるには、 @capgo/capacitor-notifications 実装の詳細については、 デバッグ トラブルシューティング用、 @capgo/capacitor-updater サイレントアップデート確認用、および Capgo プラグインディレクトリ その他のネイティブプラグイン用。