使用firebase-admin时设置FCM高优先级

基础概念

Firebase Cloud Messaging (FCM) 是 Google 提供的用于向移动设备和 Web 应用发送消息的服务。Firebase Admin SDK 允许服务器端应用程序向 Firebase 项目中的设备发送消息。FCM 消息可以是通知消息或数据消息。

设置 FCM 高优先级

高优先级消息确保即使在设备处于低电量模式或 Doze 模式下，消息也能尽快送达。这对于需要立即用户注意的消息（如紧急警报）非常重要。

优势

• 快速送达：高优先级消息即使在设备处于省电模式下也能快速送达。
• 可靠性：确保重要消息不会因为设备状态而延迟或丢失。

类型

• 通知消息：自动显示在设备的通知栏。
• 数据消息：包含自定义键值对，需要应用逻辑来处理。

应用场景

• 紧急通知：如自然灾害预警、安全警报等。
• 实时更新：如游戏得分更新、股票价格变动等。

如何设置高优先级

在使用 Firebase Admin SDK 发送消息时，可以通过设置 priority 字段为 "high" 来指定消息的高优先级。

示例代码

const admin = require('firebase-admin');
admin.initializeApp({
  credential: admin.credential.applicationDefault(),
  databaseURL: 'https://<DATABASE_NAME>.firebaseio.com'
});

const message = {
  notification: {
    title: '紧急通知',
    body: '这是一个高优先级的紧急通知'
  },
  data: {
    key1: 'value1',
    key2: 'value2'
  },
  token: '<DEVICE_TOKEN>',
  android: {
    priority: 'high'
  },
  apns: {
    headers: {
      'apns-priority': '5'
    }
  }
};

admin.messaging().send(message)
  .then((response) => {
    console.log('消息发送成功:', response);
  })
  .catch((error) => {
    console.error('消息发送失败:', error);
  });

参考链接

• Firebase Admin SDK 文档
• FCM 消息文档

常见问题及解决方法

问题：为什么高优先级消息没有立即送达？

原因：

• 设备处于离线状态。
• 网络问题导致消息延迟。
• Firebase 服务器端处理延迟。

解决方法：

• 确保设备在线并连接到网络。
• 检查网络连接是否稳定。
• 查看 Firebase 控制台中的消息发送日志，确认消息是否已成功发送。

问题：如何确认消息是否成功送达？

解决方法：

• 使用 Firebase 控制台查看消息发送日志。
• 在应用中实现消息接收回调，记录消息送达状态。

通过以上设置和调试，可以确保高优先级消息能够及时送达用户设备。