@capgo/capacitor-通知

Capgo管理的本机通知，用于活动、徽章、用户查找、送达统计和静默实时更新检查。

概述

@capgo/capacitor-notifications 连接Capacitor应用到Capgo的本机通知管道。您的应用程序在Capgo中注册一个签名的客户端用户ID，Capgo在Cloudflare分析引擎中保留最新的活跃设备状态，您可以从Capgo控制台或API发送通知、设置徽章、检查送达统计和触发静默Capgo实时更新检查。

该功能旨在避免CapgoPostgres中的高基数通知设备表。Postgres仅存储低基数控制平面数据，如应用程序设置、平台凭证元数据、活动草稿、计划和汇总活动记录。活跃设备状态和通知事件是__CAPGO_KEEP_4__分析引擎中的追加写行。

什么Capgo存储

数据	它存储在哪里	为什么
平台凭证元数据	Capgo Postgres	用于管理应用程序设置和权限
私有平台密钥	工作者环境	避免将私有凭证存储在客户端表中
活动草稿和设置	Capgo Postgres	低卡分类控制平面数据。
主动设备注册状态	Cloudflare 分析引擎	便宜的追加设备注册
通知事件	Cloudflare 分析引擎	便宜的统计信息：排队、发送、接收、打开、失败和后台事件

身份模型

Capgo 不要求您上传用户列表或维护设备表

您的后端知道真实的客户用户 ID
您的后端要求 Capgo 获取一个短期有效的 identityProof.
The app registers with externalId 并且在您的用户身份验证成功后会得到该证明。
Capgo 为接收者和本地安装生成确定性的内部密钥。
发送到相同的 externalId 找到用户的活跃设备。

这使您可以在不在Capgo Postgres 中存储每个设备的通知行的情况下查找用户的设备、设置徽标和目标通知活动。

核心功能

使用已验证的外部用户 ID 注册设备。
在应用启动或令牌更改时刷新标签、属性、同意和令牌状态。
在 JavaScript 中接收前台通知。
跟踪通知接收和打开事件。
处理后台数据通知。
设置、清除和增加应用标签。
创建 Android 通知频道。
发送一次性通知、活动通知、标签更新和静默更新检查。
触发 @capgo/capacitor-updater 从静默通知

统计

Capgo 将通知事件写入 Cloudflare 分析引擎，以便仪表板统计保持低成本：

queued
sent
provider_accepted
received
opened
failed
permission_changed
background_started
background_finished

统计是操作指标，而不是永久的每个接收方账本。分析引擎的保留期意味着活动设备必须定期刷新注册。

公共 API

方法	描述
`configure`	设置Capgo应用ID、API主机和更新器集成行为。
`register`	为外部客户用户ID注册当前安装。
`setExternalId`	登录或账户切换后更改外部客户用户ID。
`setTags`	替换用于目标受众的标签。
`setBadge`	设置原生应用徽章。
`clearBadge`	清除原生应用徽章。
`incrementBadge`	增加原生应用徽章。
`enableUpdaterIntegration`	通过 `@capgo/capacitor-updater`.
`runUpdateCheck`	启用静默更新检查处理。
`trackReceived`	手动运行更新器集成以进行测试。
`trackOpened`	手动写一个打开的事件。
`addListener('notificationReceived')`	当 JavaScript 活跃时接收通知时触发。
`addListener('notificationOpened')`	当用户打开通知时触发。
`addListener('backgroundNotification')`	后台数据通知和暴露 `finish()`.
`addListener('registrationChanged')`	当原生推送令牌发生变化时触发。

交付保证

原生推送至少一次。一次推送可以重试，设备可以接收重复的推送，如果平台接受重复的消息。使用折叠 ID 进行更新检查并使后台工作幂等。

iOS 后台通知是尽力而为的。操作系统可以根据电池、用户行为、强制退出状态和系统政策来抑制或跳过后台执行。不要依赖静默通知来实现硬期限。

从 @capgo/capacitor-notifications 继续

如果您正在使用 @capgo/capacitor-notifications 连接它以计划推送消息开始使用设置调试故障排除 @capgo/capacitor-updater 进行静默更新检查 Capgo 原生插件目录其他原生插件