应用data目录自定义通知铃声无法播放问题排查求助

核心问题 #

将自定义音乐保存至应用私有/storage/emulated/0/Android/data/package/files/Ringtone/目录后，无法设置为通知铃声正常播放，但使用RAW目录资源时功能正常。

代码问题分析 #

1. Notification Channel 语法冗余错误 #

自定义铃声分支中存在一行无效代码，既未赋值也未调用，可能引发语法警告：

Uri.parse("$musicNamea.mp3"))

需直接删除该行。

2. Android 8.0+ 铃声配置优先级问题 #

Android 8.0（API 26）及以上版本中，通知铃声绑定到Notification Channel，NotificationCompat.Builder中的setSound()会被忽略，必须确保Channel内的铃声配置正确。

3. 文件URI格式错误 #

直接使用文件路径字符串创建Uri不符合规范，正确的文件URI需要以file://前缀开头。原代码中：

setSound(Uri.parse(musicNamea), Notification.AUDIO_ATTRIBUTES_DEFAULT)

需修正为带前缀的完整URI：

setSound(Uri.parse("file://${musicNamea}.mp3"), Notification.AUDIO_ATTRIBUTES_DEFAULT)

4. 字符串比较逻辑错误 #

Kotlin中!==是引用比较，字符串内容比较应使用!=。原代码中的判断逻辑：

if (reminder.Ringtone !== "def")

可能导致错误的分支执行，需改为：

if (reminder.Ringtone != "def")

5. 通知Builder中的冲突设置 #

同时调用setDefaults(Notification.DEFAULT_SOUND)和setSound()会导致默认铃声覆盖自定义设置，需移除setDefaults(Notification.DEFAULT_SOUND)这一行。

修复后的代码示例 #

修正后的Notification Channel代码 #

private fun createNotificationChannel(reminder: Reminder) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val notifMusic = reminder.Ringtone
        val channel = NotificationChannel(CHANNEL_ID, CHANNEL_Name, NotificationManager.IMPORTANCE_HIGH).apply {
            name = "Reminder Channel${reminder.id}"
            description = "For reminder"
            enableLights(true)
            lightColor = Color.RED
            enableVibration(true)
            vibrationPattern = longArrayOf(0, 300, 200, 500)
            lockscreenVisibility = NotificationCompat.VISIBILITY_PUBLIC
            if (reminder.Ringtone != "def") {
                // 拼接正确的file://格式URI
                val soundUri = Uri.parse("file://$notifMusic")
                setSound(soundUri, Notification.AUDIO_ATTRIBUTES_DEFAULT)
            } else {
                setSound(Uri.parse("${ContentResolver.SCHEME_ANDROID_RESOURCE}://${context.packageName}/${R.raw.waterdrop_drop}"), Notification.AUDIO_ATTRIBUTES_DEFAULT)
            }
        }
        NotificationManagerCompat.from(context).createNotificationChannel(channel)
    }
}

（注：删除了多余的路径截断操作，直接使用完整路径避免错误）

修正后的通知构建代码 #

val notification = NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_stat_name)
        .setColor(Color.parseColor("#FFFFFF"))
        .setLargeIcon(getBitmapFromVectorDrawable(context, R.drawable.ic_pill_capsul))
        .setContentTitle(reminder.reminder.Name)
        .setContentText(reminder.reminder.Description)
        .setWhen(Calendar.getInstance().timeInMillis)
        .setAutoCancel(false)
        .setOngoing(true)
        .setStyle(NotificationCompat.BigTextStyle()
            .bigText(reminder.reminder.Description))
        .addAction(android.R.drawable.ic_menu_add, "Snooze", snoozePendingIntent)
        .setContentIntent(pendingIntent)
        .setPriority(NotificationCompat.PRIORITY_HIGH)
        .setVisibility(NotificationCompat.VISIBILITY_PUBLIC)
        // Android O+下此方法无效，可删除以精简代码
        // .setSound(Uri.parse(notifMusic))
        .build()
NotificationManagerCompat.from(context).notify(idNott, notification)

额外验证步骤 #

• 确认reminder.Ringtone为完整文件路径：/storage/emulated/0/Android/data/package/files/Ringtone/ring.mp3
• 通过File(notifMusic).exists()验证文件是否存在
• 检查文件权限：应用私有目录文件默认拥有读写权限，无需额外申请，但需确认写入时未设置错误权限

内容的提问来源于stack exchange，提问作者Mostafa Rostami