Android中使用raw文件夹设置自定义通知铃声失效问题

核心问题分析 #

你的代码存在几个关键问题，导致自定义铃声无法正常工作：

1. Uri格式错误：raw资源的Uri不需要添加.mp3后缀，系统通过资源ID识别文件，而非完整文件名。
2. AudioAttributes使用错误：通知铃声应使用USAGE_NOTIFICATION而非USAGE_ALARM，否则会关联到闹钟音量而非通知音量。
3. Android O+ 渠道优先级问题：API 26及以上版本，通知铃声由NotificationChannel控制，NotificationCompat.Builder的setSound会被忽略；且渠道创建后修改参数不会自动生效，需处理已存在的渠道。

修正后的完整代码 #

1. 正确获取raw资源Uri

// 方式1：通过资源路径（去掉.mp3后缀）
Uri sound = Uri.parse(ContentResolver.SCHEME_ANDROID_RESOURCE + "://" + getPackageName() + "/raw/tone_3");

// 方式2：通过资源ID（更可靠，避免文件名拼写错误）
Uri sound = Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.tone_3);

2. 修复通知渠道创建逻辑

public static String createNotificationChannel(Context context, Uri sound) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        // 修正AudioAttributes的Usage为通知类型
        AudioAttributes audioAttributes = new AudioAttributes.Builder()
                .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
                .setUsage(AudioAttributes.USAGE_NOTIFICATION)
                .build();

        String channelId = Config.CHANNEL_ID;
        CharSequence channelName = Config.CHANNEL_NAME;
        String channelDescription = Config.CHANNEL_DESC;
        int channelImportance = NotificationManager.IMPORTANCE_HIGH;
        boolean channelEnableVibrate = true;

        NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
        assert notificationManager != null;

        // 检查渠道是否已存在，若铃声不一致则删除重建
        NotificationChannel existingChannel = notificationManager.getNotificationChannel(channelId);
        if (existingChannel != null) {
            if (!sound.equals(existingChannel.getSound())) {
                notificationManager.deleteNotificationChannel(channelId);
            } else {
                return channelId;
            }
        }

        // 创建新渠道并设置铃声
        NotificationChannel notificationChannel = new NotificationChannel(channelId, channelName, channelImportance);
        notificationChannel.setDescription(channelDescription);
        notificationChannel.enableVibration(channelEnableVibrate);
        notificationChannel.setVibrationPattern(new long[]{100, 200, 300, 400, 500, 400, 300, 200, 400});
        notificationChannel.setSound(sound, audioAttributes);

        notificationManager.createNotificationChannel(notificationChannel);
        return channelId;
    } else {
        return Config.CHANNEL_ID;
    }
}

3. 优化通知Builder代码

// 初始化Builder
NotificationCompat.Builder noBuilder = new NotificationCompat.Builder(this, channelId)
        .setLargeIcon(icon)
        .setSmallIcon(R.mipmap.ic_launcher)
        .setColor(getBaseContext().getResources().getColor(R.color.colorPrimary))
        .setContentTitle(title)
        .setContentText(message)
        .setAutoCancel(true)
        .setStyle(new NotificationCompat.BigTextStyle().bigText(message))
        .setContentIntent(pendingIntent);

// 仅在API<26时保留setSound调用（高版本由渠道控制）
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) {
    noBuilder.setSound(sound);
}

// 发送通知
NotificationManagerCompat.from(this).notify(notificationId, noBuilder.build());

关键注意事项 #

• 渠道不可动态修改：Android O+ 中，通知渠道创建后，铃声、振动等参数无法通过代码直接修改，只能删除旧渠道后重建，或引导用户在系统设置中手动调整。
• 权限检查：确保应用拥有POST_NOTIFICATIONS权限（API 33+），否则通知无法正常显示。
• 音量设置：测试时确认系统通知音量未静音，且USAGE_NOTIFICATION对应的音量滑块处于正常位置。

内容的提问来源于stack exchange，提问作者Ashwin H