Android自定义通知铃声在部分设备（主要为小米）无法生效如何解决

问题根因 #

• MIUI对通知通道的配置做了系统级缓存，即使你删除旧通道重建，部分系统版本仍然会复用之前的通道配置，导致自定义铃声不生效
• MIUI默认限制第三方应用自定义通知铃声，需要额外的权限校验，且对铃声文件的存储路径、AudioAttributes的配置有特殊要求
• 你代码中设置的Notification.FLAG_INSISTENT在高版本MIUI中被系统拦截，会覆盖自定义铃声配置

适配修复方案 #

1. 修正通知通道创建逻辑 #

首先调整音频属性配置，明确标记为通知用途：

private fun getAudioAttributes(): AudioAttributes {
    return AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_NOTIFICATION)
        .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
        .build()
}

• 每次更新通道配置（比如修改铃声）的时候，必须生成全新的channelId，不要复用旧ID，彻底规避MIUI的通道缓存问题。删除旧通道的逻辑可以保留，但是新通道ID要和之前所有用过的都不一样，比如可以加版本后缀channelId = "msg_notify_channel_v2"
• 不要将自定义铃声文件放在应用私有目录，需要提前把铃声文件拷贝到系统公共的铃声目录MediaStore.Audio.Media.EXTERNAL_CONTENT_URI下，再获取对应的URI，MIUI不支持直接读取应用私有目录的铃声文件

2. 修正通知发送逻辑 #

• 移除notification.flags = Notification.FLAG_INSISTENT，这个标志在高版本Android和MIUI中已经被废弃，会导致自定义铃声被系统默认铃声覆盖。如果需要重复响铃，可以自己通过MediaPlayer或者Ringtone类单独控制铃声播放
• Android O及以上版本不需要再在NotificationBuilder里设置setSound，所有声音配置统一走通知通道即可，避免逻辑冲突

3. 适配MIUI专属权限 #

如果是小米设备，首次发送通知前可以引导用户开启对应权限：

• 跳转到应用通知通道设置页，引导用户确认铃声设置是否为你自定义的铃声，跳转代码示例：

val intent = Intent(Settings.ACTION_CHANNEL_NOTIFICATION_SETTINGS)
intent.putExtra(Settings.EXTRA_APP_PACKAGE, context.packageName)
intent.putExtra(Settings.EXTRA_CHANNEL_ID, channelId)
context.startActivity(intent)

• 部分旧版MIUI需要额外开启“通知管理”中的“允许通知响铃”权限，可引导用户前往系统设置手动开启

替代解决方案 #

如果系统通道的自定义铃声始终不生效，可以选择自主控制铃声播放，兼容性更强：

• 在发送通知的同时，使用RingtoneManager获取自定义铃声的Ringtone实例，主动调用play方法播放
• 监听通知的点击、取消事件，用户操作后主动停止铃声播放
• 注意申请音频焦点，避免和其他系统声音冲突

内容的提问来源于stack exchange，提问作者Abu Yousuf