Android 10及以上从应用数据文件夹设置NotificationChannel音效失效

核心变更说明 #

Android 10（API 29）及以上版本启用了分区存储（Scoped Storage），同时收紧了系统组件对file://类型URI的访问权限：

• 应用私有外部存储目录下的文件，无法通过file:// URI直接提供给系统组件（如NotificationManager）访问，必须使用content://类型的URI。
• 系统不再允许非媒体库扫描到的本地文件通过file:// URI作为通知频道音效，必须通过合法的content:// URI暴露。

你的代码中使用Uri.parse()生成的是file:// URI，在Android 10+下NotificationManager无法访问该路径的文件，因此会 fallback 到默认音效。

解决步骤 #

1. 注册FileProvider #

在AndroidManifest.xml中添加FileProvider配置，用于将应用私有文件转换为content:// URI：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

2. 配置文件共享路径 #

在res/xml目录下创建file_paths.xml文件，指定要共享的文件目录：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 对应你的音效文件所在路径：外部私有存储的Documents/Download/MyApp/Ringtones/ -->
    <external-files-path
        name="ringtone_files"
        path="Download/MyApp/Ringtones/" />
</paths>

3. 修改代码生成合法的Content URI #

替换原代码中生成音效URI的逻辑，使用FileProvider生成content:// URI：

NotificationManager manager = (NotificationManager) ctx.getSystemService(Context.NOTIFICATION_SERVICE);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // 构造音效文件对象
    File soundFile = new File(ctx.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS), "Download/MyApp/Ringtones/new_ride.mp3");
    Uri sound;
    if(soundFile.exists()) {
        // 通过FileProvider生成content:// URI
        sound = FileProvider.getUriForFile(ctx, ctx.getPackageName() + ".fileprovider", soundFile);
    } else {
        sound = Uri.parse(ContentResolver.SCHEME_ANDROID_RESOURCE + "://" + ctx.getPackageName() + "/raw/new_ride");
    }

    // 修正AudioAttributes的usage，更贴合通知场景
    AudioAttributes attributes = new AudioAttributes.Builder()
            .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
            .setUsage(AudioAttributes.USAGE_NOTIFICATION_EVENT)
            .build();

    String NOTIFICATION_CHANNEL_ID = "com.MyApp.driverapp.newride";
    String channelName = "RideRequest";
    NotificationChannel chan = new NotificationChannel(NOTIFICATION_CHANNEL_ID, channelName, NotificationManager.IMPORTANCE_HIGH);
    chan.setLightColor(Color.BLUE);
    chan.enableVibration(true);
    chan.setImportance(NotificationManager.IMPORTANCE_HIGH);
    chan.setSound(sound, attributes);
    chan.setShowBadge(true);
    chan.setLockscreenVisibility(Notification.VISIBILITY_PUBLIC);
    
    // 注意：通知频道创建后无法修改音效，测试前需卸载应用或清除应用数据
    manager.createNotificationChannel(chan);
}

额外注意事项 #

• 通知频道不可修改：NotificationChannel一旦创建，除了名称、描述等少数属性，音效、重要性等核心属性无法修改。测试新音效前，必须先卸载应用或清除应用数据，确保频道被重新创建。
• AudioAttributes匹配场景：将USAGE_ALARM改为USAGE_NOTIFICATION_EVENT更符合通知音效的使用场景，避免系统对音频类型的限制。

内容的提问来源于stack exchange，提问作者Rajeev Kumar