Android推送通知：仅为本应用设置自定义铃声失败求助

核心排查与修复步骤 #

1. Android 8.0（API 26）及以上版本（通知渠道优先级最高）

• 渠道配置注意事项
  通知渠道一旦创建，后续修改铃声不会自动生效，测试时需：
  • 使用全新的channelId，或卸载应用清除旧渠道缓存后重装
  • 音频属性audio_attr必须正确配置，示例代码：

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

  • 绑定铃声Uri与音频属性到渠道：

    NotificationChannel channel = new NotificationChannel(CHANNEL_ID, CHANNEL_NAME, NotificationManager.IMPORTANCE_DEFAULT);
    channel.setSound(soundUri, audioAttr);
    NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    notificationManager.createNotificationChannel(channel);
    

  • 创建通知时必须指定该CHANNEL_ID，否则会使用默认渠道

2. 自定义铃声Uri有效性检查

• 禁止直接使用file://格式Uri：Android 7.0及以上需通过FileProvider生成内容Uri，示例：

  File soundFile = new File(getExternalFilesDir(Environment.DIRECTORY_RINGTONES), "custom_sound.mp3");
  Uri soundUri = FileProvider.getUriForFile(this, "com.your.package.fileprovider", soundFile);
  

• 权限配置：
  • Android 13+：申请READ_MEDIA_AUDIO和POST_NOTIFICATIONS权限
  • Android 6.0~12：申请READ_EXTERNAL_STORAGE和POST_NOTIFICATIONS（Android 12+）权限

3. 低版本（Android 7.1及以下）适配

• 通过NotificationCompat.Builder直接设置铃声：

  NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
      .setSmallIcon(R.drawable.ic_notification)
      .setContentTitle("通知标题")
      .setContentText("通知内容")
      .setSound(soundUri);
  

• 或直接设置Notification对象的sound字段，确保Uri和权限无问题

4. 系统设置验证

• 前往系统设置 > 应用 > 你的应用 > 通知 > 对应渠道，确认铃声是否已设为自定义音频
• 若未生效，尝试手动选择自定义铃声后再测试代码逻辑

内容的提问来源于stack exchange，提问作者Urvish Vocsy