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

我之前也踩过OneSignal自定义声音不生效的坑，给你整理几个实打实的排查和解决要点，应该能帮你搞定：

• 先确认音频文件本身没问题
  别小看这一步，很多时候问题出在文件上：

  • 确保okayy.mp3是标准MP3格式，采样率建议44.1kHz、比特率128kbps左右，OneSignal对音频参数有隐性要求
  • 文件放在res/raw目录下，文件名全小写、无特殊字符（你已经做到okayy，这点没问题）
  • 手动播放下文件，确认没有损坏；另外注意配置时绝对不能加.mp3后缀，这点你虽然提了，但再核对一遍有没有手滑写错

• 检查AndroidManifest的通知渠道配置
  Android 8.0+的通知渠道机制会覆盖很多全局设置，一定要在Manifest里补全相关配置：

  <!-- 声明通知渠道的基本信息 -->
  <meta-data
      android:name="com.onesignal.NotificationChannelName"
      android:value="你的通知渠道名称"/>
  <meta-data
      android:name="com.onesignal.NotificationChannelDescription"
      android:value="你的通知渠道描述"/>
  <!-- 指定渠道默认使用的自定义声音 -->
  <meta-data
      android:name="com.onesignal.NotificationChannelSound"
      android:value="okayy"/>
  

  另外！千万要检查用户系统设置里的通知渠道声音——如果用户手动把该渠道的声音改成默认，代码和控制台的配置都会被覆盖，这是最容易忽略的点！

• 核对OneSignal控制台的推送配置
  推送时要在控制台的「高级设置」或「通知设置」里，准确填写自定义声音的文件名（不带后缀），并且确认选择了Android平台。如果是批量推送，还要检查有没有全局默认设置覆盖了单条推送的声音配置。

• 测试时的避坑指南

  • 别用模拟器测试！大部分安卓模拟器对自定义通知声音的支持都有问题，一定要用真实设备
  • 卸载重装应用！旧的通知渠道配置会被系统缓存，重装后会重新创建渠道，能解决很多缓存导致的异常
  • 测试前先清除应用数据，避免残留的旧配置干扰

• 默认文件名onesignal_default_sound.mp3无效的特殊处理
  如果连官方指定的默认文件名都没用，大概率是SDK初始化的问题：
  确保在Application类里正确初始化OneSignal，比如：

  @Override
  public void onCreate() {
      super.onCreate();
      OneSignal.initWithContext(this);
      OneSignal.setAppId("你的APP_ID");
      // 可以尝试显式设置默认通知声音
      OneSignal.setNotificationWillShowInForegroundHandler(new NotificationWillShowInForegroundHandler() {
          @Override
          public void notificationWillShowInForeground(OSNotificationReceivedEvent event) {
              // 保留原有逻辑的同时，强制设置声音
              OSNotification notification = event.getNotification();
              notification.setSound("okayy");
              event.complete(notification);
          }
      });
  }
  

  另外检查下SDK版本，更新到最新版的OneSignal SDK，旧版本确实存在过自定义声音的bug

要是以上步骤都试过还不行，可以先用Android原生通知API测试下自定义声音能不能正常播放，先排除系统或音频文件本身的问题，再回到OneSignal的配置上排查。

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