Gorush项目中Android推送通知声音与颜色配置问题解析

问题背景

在Gorush推送通知服务的最新版本1.18.6中，部分用户反馈Android设备的通知声音和颜色配置出现了失效问题。经过技术分析，这主要是由于新版FCM（Firebase Cloud Messaging）API的字段变更导致的兼容性问题。

问题表现

开发者在使用Gorush发送Android推送通知时，发现以下配置项无法正常工作：

1. 通知声音(sound)无法播放
2. 通知颜色(color)设置无效
3. 安卓通道ID(android_channel_id)字段不被识别

技术分析

旧版配置的问题

在旧版实现中，开发者通常使用如下结构配置Android通知：

{
  "notification": {
    "android_channel_id": "channel_name",
    "sound": "custom_sound",
    "color": "#FF0000"
  }
}

这种配置方式在新版FCM API中已不再支持，导致相关功能失效。

新版FCM API的变更

新版FCM API要求Android特定的配置必须嵌套在"android"字段下，且字段名称有所调整：

1. "android_channel_id"应改为"channel_id"
2. 所有Android特有的通知配置必须放在"android.notification"对象中

解决方案

正确的配置方式应如下所示：

{
  "notifications": [
    {
      "platform": 2,
      "tokens": ["device_token"],
      "title": "通知标题",
      "message": "通知内容",
      "android": {
        "notification": {
          "channel_id": "channel_name",
          "sound": "custom_sound",
          "color": "#0093E9"
        }
      },
      "data": {
        "custom_key": "custom_value"
      }
    }
  ]
}

关键配置说明

1. 平台标识：必须设置"platform": 2表示Android设备
2. Android专用配置：所有Android特有的配置必须放在"android"对象内
3. 通知配置：声音、颜色等通知相关设置放在"android.notification"对象中
4. 通道ID：使用"channel_id"而非"android_channel_id"
5. 优先级设置：可以在"android"对象中设置"priority": "high"

最佳实践建议

1. 版本兼容性：在使用Gorush服务时，应注意查阅对应版本的API文档
2. 测试验证：重要配置变更后应在测试环境充分验证
3. 回退机制：生产环境实现应具备配置回退能力
4. 日志监控：建立推送通知的送达和展示监控机制

总结

Gorush 1.18.6版本中Android通知配置的问题主要是由于FCM API变更引起的。通过调整配置结构，将Android特有的设置移至"android"和"android.notification"对象中，可以解决声音、颜色等配置失效的问题。开发者应及时更新推送配置逻辑，以适应新版API的要求。