原生移动开发 / 系统课时

区分通知消息与数据消息

区分通知消息与数据消息

这一课解决 FCM 消息类型选错导致的业务失控问题。你将能根据“谁负责展示、谁负责处理”选择 notification、data 或两者组合,并写出对应的 Android 处理代码。([Firebase][1])

学习目标

  • 能区分 notification、data 以及 notification + data 的处理边界
  • 能判断消息应该依赖系统展示还是客户端业务代码
  • 能在 Android 中正确读取 FCM 的数据字段

notification 和 data 的核心区别

FCM 的 notification 消息带有预定义的用户可见字段,例如标题和正文。应用处于后台时,FCM SDK 可以直接把这类通知交给 Android 系统通知栏展示;应用处于前台时,则会通过 onMessageReceived 交给应用代码决定行为。

data 消息只包含业务自定义键值对,由客户端代码负责处理。它适合“收到事件后执行业务逻辑”的场景,例如同步状态、更新本地数据或根据业务类型决定是否展示通知。([Firebase][1])

类型 前台 后台 适合场景
notification onMessageReceived 系统通知栏 以用户可见通知为主
data onMessageReceived 客户端处理 业务逻辑由应用控制
notification + data 两种 payload 都可在回调中处理 通知进通知栏,数据在用户点击后进入启动 Activity 的 Intent 同时需要系统展示和业务上下文

用 payload 判断设计意图

下面是服务端发送请求中最关键的三种形态。它们展示的是消息类型结构,不代表可以直接在终端执行。

json
{
  "message": {
    "token": "<FCM_TOKEN>",
    "notification": {
      "title": "订单更新",
      "body": "订单已发货"
    }
  }
}

预期结果

text
后台状态下,FCM 可将“订单更新 / 订单已发货”交给系统通知栏展示。
json
{
  "message": {
    "token": "<FCM_TOKEN>",
    "data": {
      "event": "order_shipped",
      "orderId": "<ID>"
    }
  }
}

预期结果

text
客户端收到自定义键值对,并由应用代码决定后续业务处理。

对于 notification + data,需要特别注意:应用后台时,通知由系统展示,业务数据不会像纯 data 消息一样直接走 onMessageReceived;用户点击通知后,相关 data 会出现在启动 Activity 的 Intent extras 中。([Firebase][1])

在客户端统一处理 data

业务代码不要把 FCM 的字段名直接散落在多个页面。可以在 FirebaseMessagingService 中把 data 转换成自己的业务对象,再交给后续处理。

kotlin
package com.example.push

import android.util.Log
import com.google.firebase.messaging.FirebaseMessagingService
import com.google.firebase.messaging.RemoteMessage

class AppMessagingService : FirebaseMessagingService() {

    override fun onMessageReceived(message: RemoteMessage) {
        // data 是业务负载;这里先统一提取,再决定是否继续执行耗时任务。
        val event = message.data["event"] ?: return
        val id = message.data["orderId"] ?: return

        Log.d("FCM", "event=$event, orderId=$id")
        handleEvent(event, id)
    }

    private fun handleEvent(event: String, id: String) {
        if (event == "order_shipped") {
            Log.d("FCM", "process shipped order: $id")
        }
    }
}

预期结果

text
FCM: event=order_shipped, orderId=<ID>
FCM: process shipped order: <ID>

这里的日志值取决于服务端实际发送的 data。若处理需要持续数秒以上,不应把长任务全部放在 onMessageReceived 中,应转交到适合当前生命周期的后台任务机制。([Firebase][2])

什么时候选哪一种

需要“后台收到就尽快显示一条普通通知”,而不要求应用先执行复杂业务逻辑时,可以使用 notification。需要“消息到达后由应用完全决定怎么处理”,例如根据事件类型更新业务状态,则优先考虑 data。

需要系统先显示通知、用户点击后再把业务上下文带入应用时,可以使用 notification + data,但必须明确后台点击路径,不能假设 data 一定会进入 onMessageReceived。([Firebase][1])

真正的设计原则是:凡是业务正确性依赖客户端执行的逻辑,不要把它只寄托在后台 notification 的自动展示行为上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分通知消息与数据消息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通