用途
该技能面向需要在 CometChat Angular 应用中实现 Web 推送通知的开发者,目标场景是应用处于关闭或后台状态时仍能向用户送达通知。
主要能力
- 覆盖 CometChat Notifications 产品层面的推送接入,而非 UI Kit 组件。
- 涉及 FCM(Firebase Cloud Messaging)注册、Service Worker 配置以及推送令牌的生命周期管理。
- 采用文档优先(docs-first)的薄封装方式:注册流程、推送载荷结构与服务商配置均从通知文档中获取,不在技能内固化,以降低因上游变更导致的过时风险。
使用方式
- 前置依赖:需先阅读配套技能 cometchat-angular-v5-core,其中涵盖安装、凭据配置以及 init→login→render 流程。
- 文档入口:从 {SDK_DOCS_BASE}/notifications/overview.md 开始,再进入 Web 推送集成页面;当前可用页面可通过 SDK 索引(cometchat-angular-v5-core/references/docs-map.md)发现。
- Angular 自身文档仅在 {DOCS_BASE}/ui-kit/angular/campaigns.md 中涉及推送,没有专门的 Angular 推送页面,这是已知的文档缺口,产品级通知文档才是权威来源。
- Angular 相关要点:在 login() 完成后注册令牌(参考 core 的 guarded-login 模式);将注册逻辑放在 service 而非 component 中,避免随路由重复执行;若应用为 SSR,需用 isPlatformBrowser 进行保护(参考 cometchat-angular-v5-patterns);在调用 CometChatUIKit.logout() 的同一位置执行注销。
适用场景
- 需要在应用关闭或后台运行时向用户送达通知的 CometChat Angular 应用。
限制与注意事项
- 推送是独立产品,必须在控制台为应用启用并配置,且需在控制台添加服务商凭据,客户端代码无法替代该步骤。
- 推送不是 UI Kit,注册是 SDK 级别(CometChatNotifications),没有可渲染的组件。
- 需要位于源根路径的 Service Worker:firebase-messaging-sw.js 必须从 / 提供,而非嵌套路径。在 Angular 中应将其加入 angular.json 的 assets,使其落在 dist/ 根目录,并在构建后确认可通过 /firebase-messaging-sw.js 访问;此处 404 是“推送无反应”最常见的原因。
- 权限请求需要用户手势,应从点击事件中调用;浏览器会阻止加载时请求,反复静默阻止会损害该源。
- 令牌生命周期由开发者负责:登录后注册 FCM 令牌,登出时注销;跳过注销会导致下一个用户的通知发送到之前的设备。
- iOS Safari 仅支持 PWA:iOS 上的 Web 推送要求站点已安装到主屏幕,这不是缺陷,需提前设定预期。
- 推送无法在无头浏览器中验证,需要真实设备或浏览器配置文件、可用的服务商以及处于后台的应用,需手动测试:通过 HTTPS 加载并从点击授予权限;确认 /firebase-messaging-sw.js 返回 200;将标签页置于后台,从第二个账号发送消息;通知到达后点击可聚焦应用;登出后确认通知停止。
- 常见陷阱包括:控制台未启用通知(无任何反应也无报错)、Service Worker 不在源根路径(静默失败)、加载时请求权限(被阻止)、登录前注册令牌(无用户可关联)、登出时未注销(通知跟随错误用户)、期望 iOS Safari 在非 PWA 下工作、凭记忆固化配方(该领域变化快,应实时获取文档)。