Android Oreo自定义通知音效失效问题及解决方案求助

这个问题我之前也踩过坑！Android 8.0（API 26）引入了**通知渠道（Notification Channel）**机制，从这版系统开始，通知的音效、震动、灯光这类行为不再直接通过NotificationCompat.Builder来设置，而是完全绑定到对应的通知渠道上——你之前调用的setSound()方法，在Oreo及以上系统会被直接忽略，这就是为什么只有默认音效在播放。

下面是具体的修改步骤：

1. 先创建并注册自定义通知渠道（只需执行一次） #

你需要在应用启动时（比如Application的onCreate()方法里）或者第一次发送通知前，创建一个包含自定义音效的通知渠道。这个渠道只需要创建一次，系统会保存它的配置：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // 自定义渠道的ID、名称和重要性级别
    String channelId = "custom_notification_sound_channel";
    CharSequence channelName = "自定义通知音效渠道";
    int importance = NotificationManager.IMPORTANCE_DEFAULT; // 这个级别决定通知是否会弹出
    
    // 创建渠道实例
    NotificationChannel channel = new NotificationChannel(channelId, channelName, importance);
    
    // 配置渠道的音效
    Uri soundUri = Uri.parse(ContentResolver.SCHEME_ANDROID_RESOURCE + "://" + getPackageName() + "/" + R.raw.notification_mp3);
    // 必须设置音频属性，否则音效可能不生效
    AudioAttributes audioAttributes = new AudioAttributes.Builder()
            .setUsage(AudioAttributes.USAGE_NOTIFICATION)
            .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
            .build();
    channel.setSound(soundUri, audioAttributes);
    
    // 可选：添加震动、灯光等其他配置
    channel.enableVibration(true);
    channel.setVibrationPattern(new long[]{100, 200, 300});
    
    // 将渠道注册到系统通知管理器
    NotificationManager notificationManager = getSystemService(NotificationManager.class);
    notificationManager.createNotificationChannel(channel);
}

2. 创建通知时关联该渠道ID #

现在创建通知的时候，必须在NotificationCompat.Builder的构造方法里指定刚才的渠道ID，这样系统才会使用渠道上配置的自定义音效：

// 注意第二个参数是我们刚才定义的渠道ID
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context, "custom_notification_sound_channel")
        .setSmallIcon(R.drawable.your_notification_icon)
        .setContentTitle("通知标题")
        .setContentText("通知内容")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT);

// 注意：Oreo及以上系统下，这里的setSound()会被忽略，所以可以直接注释掉
// mBuilder.setSound(sound);

// 发送通知
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
notificationManager.notify(your_notification_id, mBuilder.build());

补充说明 #

如果之后需要修改通知的音效，不能直接通过Builder修改，而是要获取已有的渠道实例，更新它的音效配置，再调用notificationManager.createNotificationChannel(channel)来更新渠道（系统会覆盖原有渠道的可修改属性）。

内容的提问来源于stack exchange，提问作者Ashish John