Flutter/Firebase 聊天应用如何实现图标未读消息角标数的累计管理
Flutter/Firebase 应用图标未读角标实现方案
当前硬编码badge: '1'的推送逻辑存在本质缺陷:移动操作系统会直接把推送请求里携带的badge值作为图标的角标数字,每次收到新推送时就会用这个新值覆盖之前显示的角标,自然无法实现累计递增的效果。
不要在每次触发推送时临时扫描全量未读消息做count统计,这种方式会产生大量Firestore读请求,随着消息量增长会带来不必要的成本和推送延迟,最稳妥的方案是建立单一可信的未读计数数据源:
- 在每个用户的独立主文档下新增
totalUnreadCount字段,专门存储该用户跨所有聊天会话的未读消息总数 - 所有和未读状态相关的操作,都通过Firestore的原子增量操作同步更新这个字段,完全避免并发场景下的计数偏差:
- 新消息创建且发送对象为其他用户时,给收件人的
totalUnreadCount执行+1的原子操作 - 用户打开某一聊天会话并将会话内所有未读消息标记为已读时,按该会话内被标记的未读消息数,给
totalUnreadCount执行对应数值的-1原子扣减 - 当用户清空所有未读消息时,直接将
totalUnreadCount重置为0
- 新消息创建且发送对象为其他用户时,给收件人的
基于上面的计数逻辑,直接对现有触发推送的云函数做改造,去掉硬编码的badge值,直接读取实时维护的totalUnreadCount作为推送的角标参数:
const functions = require('firebase-functions'); const admin = require('firebase-admin'); admin.initializeApp(); exports.onCreateMessage = functions.firestore.document('/Chat/{currentUserID}/UserList/{anotherUserID}/Messages/{messageID}') .onCreate(async (snap, context) => { const recieverUserID = snap.data().recieverID; // 仅处理发给其他用户的消息,不统计自发自收的内容 if (recieverUserID === context.params.currentUserID) { const userRef = admin.firestore().doc(`/User/${recieverUserID}`); // 原子更新用户的全局未读总数,不会出现并发计数冲突 await userRef.update({ totalUnreadCount: admin.firestore.FieldValue.increment(1) }); // 读取更新后的最新未读值 const userDoc = await userRef.get(); const latestUnreadCount = userDoc.data().totalUnreadCount || 1; // 发送带正确角标的推送通知 return admin.messaging().sendToTopic(`${recieverUserID}`, { notification: { title: snap.data().senderID, body: snap.data().message, clickAction: 'FLUTTER_NOTIFICATION_CLICK', sound: 'default', badge: latestUnreadCount.toString() } }); } });
边界场景注意事项
- 系统端的角标显示会被推送携带的badge值强制覆盖,因此角标值的来源要完全以Firestore中维护的
totalUnreadCount为唯一标准,不要在本地端单独计算角标值,避免前后台切换时出现计数不一致 - iOS系统中如果推送携带的badge值为0,会自动清除应用图标的角标,刚好适配用户清空所有未读消息的场景
- 当应用处于前台运行状态时,需要同步调用本地的角标设置接口,将本地显示的角标值和
totalUnreadCount保持一致,避免用户在APP内读了消息,但是图标上的角标还保留旧值的问题
内容的提问来源于stack exchange,提问作者DaegilPyo
相关产品推荐
相关产品推荐

