Ionic 3 Android本地通知自定义声音失效问题求助

我之前也踩过Ionic 3 Android本地通知自定义声音不生效的坑，折腾了好一阵才摸清楚门道，给你分享几个关键的排查点和解决步骤：

一、本地音频文件的正确配置（最常见问题） #

这部分最容易踩路径和命名的坑，一定要注意：

• 文件存放路径：Android要求自定义通知音频必须放在platforms/android/res/raw目录下，如果这个raw文件夹不存在，直接手动创建即可。
• 文件名规则：文件名必须是小写字母+下划线，不能有空格、大写字母或者特殊字符，比如my_notification_sound.mp3是合法的，My Notification Sound.mp3就会失效。
• 代码配置：调用本地通知时，sound字段不能写全路径，要写成res://你的文件名（不带后缀），示例代码：

  import { LocalNotifications } from '@ionic-native/local-notifications';
  
  constructor(private localNotifications: LocalNotifications) {}
  
  scheduleCustomNotification() {
    this.localNotifications.schedule({
      id: 1,
      title: '自定义声音通知',
      text: '这是带有本地自定义声音的通知',
      sound: 'res://my_notification_sound'
    });
  }
  

• 避免缓存问题：添加音频文件后，建议先删除platforms/android目录，再重新执行ionic cordova platform add android，然后编译打包，防止旧的缓存文件干扰。

二、远程音频文件的配置要点 #

如果用远程音频还是不生效，注意这几点：

• 格式与可访问性：确保远程音频是Android支持的格式（MP3、WAV等），并且设备能直接访问该URL（没有跨域限制、不需要登录验证等）。
• 代码配置：sound字段要写完整的HTTP/HTTPS URL，示例：

  this.localNotifications.schedule({
    id: 2,
    title: '远程声音通知',
    text: '使用远程音频的通知',
    sound: 'https://your-domain.com/notification_sound.mp3'
  });
  

三、Android 8.0+的通知渠道问题 #

Android 8.0及以上版本引入了通知渠道机制，如果你的通知使用了默认渠道，自定义声音可能会被渠道的默认设置覆盖，必须手动创建带自定义声音的渠道：

if (this.platform.is('android')) {
  // 创建自定义通知渠道
  this.localNotifications.createChannel({
    id: 'custom_notification_channel',
    name: '自定义通知渠道',
    sound: 'res://my_notification_sound', // 这里也可以填远程URL
    importance: 3, // 重要程度，3对应默认通知音量
    vibration: true
  });

  // 调度通知时指定该渠道
  this.localNotifications.schedule({
    id: 3,
    title: '渠道自定义声音',
    text: '通过通知渠道设置的自定义声音',
    channel: 'custom_notification_channel'
  });
}

四、额外排查项 #

• 插件版本兼容性：Ionic 3建议使用cordova-plugin-local-notifications的v0.9.x或v1.x稳定版本，过高版本可能和Ionic 3的依赖不兼容。
• 使用真实设备测试：Android模拟器对自定义通知声音的支持经常有问题，一定要用真实设备测试。
• 设备音量设置：确认设备没有静音，并且通知音量是开启状态，有时候不是代码问题，是设备设置的锅。

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