NotificationChannel.setSound 如何正确设置自定义通知铃声？

Question

在Android 8.0（API 26）及以上系统中，使用 `NotificationChannel.setSound(Uri, AudioAttributes)` 设置自定义通知铃声时，常出现铃声不播放的问题。常见原因包括：自定义音频文件未放入`/res/raw`目录、URI路径构造错误、未正确设置音频属性（AudioAttributes），或设备的免打扰模式/音量设置限制。此外，从Android 10开始，对媒体资源访问权限进一步收紧，若使用非应用内资源，可能导致静音。如何正确构造Uri并搭配合适的AudioAttributes，确保铃声在不同厂商ROM上正常播放？

Answer 1

一、问题背景与Android通知机制演进

自Android 8.0（API 26）引入通知渠道（NotificationChannel）机制以来，应用对通知行为的控制更加精细化。然而，在设置自定义铃声时，开发者常遇到setSound(Uri, AudioAttributes)不生效的问题。尤其是在不同厂商ROM（如华为EMUI、小米MIUI、OPPO ColorOS）上表现不一致，导致用户收不到预期的声音提示。

该问题的核心在于：Android系统对音频资源访问权限、URI构造方式以及AudioAttributes配置的严格要求。尤其从Android 10（API 29）起，Scoped Storage和媒体权限收紧进一步加剧了兼容性挑战。

二、常见原因分析与排查路径

• 音频文件未放置于/res/raw目录：只有应用内资源才能通过R.raw.xxx安全引用，外部存储资源易被系统拦截。
• Uri构造错误：使用file://或content://media等非标准路径可能导致权限拒绝。
• AudioAttributes配置不当：未声明USAGE_ALARM或CONTENT_TYPE_SONIFICATION，系统可能将其归类为“非重要”音频流。
• 设备处于免打扰模式或静音状态：即使代码正确，系统策略仍会抑制声音播放。
• 厂商ROM定制限制：部分国产ROM默认关闭第三方应用通知声音，需引导用户手动开启。

三、正确构建Uri的实践方法

在Android中，推荐使用android.resource://方案构造指向raw目录下音频文件的Uri：

Uri soundUri = Uri.parse("android.resource://" + context.getPackageName() + "/" + R.raw.custom_notification);

音频来源	推荐Uri格式	适用场景
/res/raw/	android.resource://[pkg]/[id]	通用、高兼容性
应用私有目录	file:///data/data/[pkg]/files/sound.mp3	需配合FileProvider
公共媒体库	content://media/external/audio/media/[id]	需READ_EXTERNAL_STORAGE权限（Android 9及以下）

四、AudioAttributes配置最佳实践

必须明确指定音频用途（usage）和内容类型，否则系统可能忽略播放请求：

AudioAttributes audioAttributes = new AudioAttributes.Builder()
    .setUsage(AudioAttributes.USAGE_NOTIFICATION)
    .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
    .build();

对于强调紧急性的通知（如闹钟、警报），可考虑使用：

.setUsage(AudioAttributes.USAGE_ALARM)

注意：某些厂商ROM会对USAGE_ALARM进行额外弹窗提醒或强制提权处理，提升播放成功率。

五、跨厂商ROM兼容性适配策略

1. 优先使用raw资源+android.resource:// Uri，避免外部路径依赖。
2. 检测当前是否处于“勿扰模式”：
   NotificationManager.getCurrentInterruptionFilter()
3. 检查通知渠道的sound属性是否被用户手动禁用。
4. 针对华为、小米等机型，跳转至厂商设置页引导用户开启声音：

5. Intent intent = new Intent();
   intent.setClassName("com.miui.securitycenter", "com.miui.permcenter.autostart.AutoStartManagementActivity");
   // 小米示例，实际需动态判断包名存在性
   context.startActivity(intent);

6. 提供“测试铃声”功能，让用户即时验证配置有效性。

六、完整实现流程图

graph TD
    A[开始创建通知渠道] --> B{音频文件是否在/res/raw?}
    B -- 是 --> C[构造android.resource:// Uri]
    B -- 否 --> D[使用FileProvider生成content:// Uri]
    C --> E[构建AudioAttributes: USAGE_NOTIFICATION]
    D --> E
    E --> F[调用channel.setSound(Uri, AudioAttributes)]
    F --> G[检查NotificationManager渠道设置]
    G --> H[发送测试通知]
    H --> I{是否有声音?}
    I -- 否 --> J[提示用户检查免打扰/音量/厂商设置]
    I -- 是 --> K[完成]

七、权限与运行时行为注意事项

尽管读取raw资源无需权限，但从Android 10开始：

• 访问MediaStore.Audio需READ_EXTERNAL_STORAGE（仅限targetSdkVersion ≤ 28）。
• targetSdkVersion ≥ 29时，应使用MediaStore查询并请求ACCESS_MEDIA_LOCATION（若涉及地理位置元数据）。
• 推荐将目标SDK设为最新，并启用requestLegacyExternalStorage过渡标志（仅临时方案）。

此外，需监听onChannelUpdated事件，监控用户是否修改了声音设置。