原生Android应用OneSignal通知无法播放自定义声音问题求助

• 检查keep.xml的格式与位置
  确保keep.xml位于res/raw/目录下，内容格式正确，多个声音文件用逗号分隔，示例：

  <resources xmlns:tools="http://schemas.android.com/tools"
      tools:keep="@raw/sound_1,@raw/sound_2"/>
  

  注意不要给资源路径加多余引号，避免编译时识别错误。

• 确认声音文件是否被正确打包
  用APK Editor Studio打开最终编译的APK，查看res/raw/目录下是否存在目标MP3文件。Kodular的默认编译优化可能会移除未被显式引用的资源，即使添加了keep.xml，也要验证文件是否确实被保留。

• 处理Android 12+的通知频道限制
  Android 12及以上系统中，通知频道的声音配置一旦创建就无法通过代码修改。如果之前发送过不带自定义声音的通知（使用过同一个频道ID），后续设置的自定义声音不会生效。解决方式：

  • 卸载应用后重装，清除旧的频道配置
  • 发送通知时使用全新的频道ID，确保新频道的声音配置被正确初始化

• 核对OneSignal的声音参数设置

  • 通过REST API发送时，android_sound参数需填写不带@raw/前缀和.mp3后缀的文件名，示例：

    "android_sound": "sound_1"
    

  • 在OneSignal控制台设置声音时，同样直接填写文件名（如sound_1），不要添加路径或后缀。

• 验证Kodular组件与权限配置

  • 确认Kodular项目中已添加POST_NOTIFICATIONS权限，虽然振动和图标正常说明权限大概率没问题，但仍需排除权限遗漏导致的资源访问限制。
  • 检查Kodular的OneSignal组件是否启用了自定义通知支持，避免组件默认配置覆盖自定义声音设置。

• 排除设备本身的声音问题
  先测试使用系统默认通知声音是否能正常播放，确认设备的通知音量未关闭、未处于静音模式，媒体/通知通道的声音设置正常。

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