如何实现自定义通知铃声

各通道支持情况

安卓自定义铃声

阿里云自有通道自定义铃声实现

安卓8.0以上版本可以在客户端创建自定义通知通道时指定铃声。

操作步骤如下：

1. 在客户端项目指定位置放入铃声文件

假设您的铃声文件为alicloud_notification_sound.mp3，您需要将它放到客户端项目工程的app/src/main/res/raw/目录下，即最终形如app/src/main/res/raw/alicloud_notification_sound.mp3。

2. 在客户端创建自定义通知通道

在创建通知通道时通过调用setSound()给通知通道指定铃声。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    // 通知通道的id。
    String channelId = "${channel_id}"; // 这个id值需要给后端开发和运维人员，推送的时候对应 AndroidNotificationChannel 参数。
    // 用户可以看到的通知通道的名字。
    CharSequence name = "${通道描述}";
    int importance = NotificationManager.IMPORTANCE_HIGH;
    NotificationChannel mChannel = new NotificationChannel(channelId, 
                                          name, importance);
    // 配置通知通道的属性。
    //  自定义铃声
    mChannel.setSound(Uri.parse("android.resource://" + this.getPackageName() + "/" + R.raw.alicloud_notification_sound), Notification.AUDIO_ATTRIBUTES_DEFAULT);
    // 最后在notificationmanager中创建该通知通道。
    mNotificationManager.createNotificationChannel(mChannel);
}

3. 服务端推送通知时参数配置

服务端推送通知时配置参数AndroidNotificationChannel。

AndroidNotificationChannel字段说明如下：

关于AndroidNotificationChannel的更多描述可以跳转Push - 高级推送查看。

服务端在推送通知时需要根据步骤2中创建的通知通道的channel_Id设置参数。示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setAndroidNotificationChannel("${channel_id}"); // 设置channel id
...

华为通道自定义铃声实现

华为通道提供了两种自定义铃声的实现方式，方式一是通过首次给应用推送服务与通讯消息时携带铃声路径字段实现，方式二是通过自定义通知通道实现，其中方式二仅支持数据处理位置为海外的应用，不支持数据处理位置为中国区的应用。

方式一：首次给应用推送服务与通讯消息时携带铃声路径字段

自2023年2月28日起，华为发布了《华为消息分类调整通知》，将EMUI 10.0以上系统的推送消息分为了服务与通讯以及资讯营销两类。

其中，服务与通讯类消息通过铃声提醒，而资讯营销类消息静默通知。

通过在首次给应用推送服务与通讯类消息时携带铃声路径字段，用户可以自定义通知铃声。

操作步骤如下：

1. 为应用申请服务与通讯类的自分类权益

根据华为《自分类权益申请》为您的应用申请服务与通讯类消息的自分类权益。

2. 在客户端项目指定位置放入铃声文件

假设您的铃声文件为alicloud_notification_sound.mp3，您需要将它放到客户端项目工程的app/src/main/res/raw/目录下，即最终形如app/src/main/res/raw/alicloud_notification_sound.mp3。

3. 服务端首次推送服务与通讯类通知时参数配置

服务端推送通知时配置参数AndroidMusic与AndroidMessageHuaweiCategory。

AndroidMusic与AndroidMessageHuaweiCategory字段说明如下：

关于AndroidMusic与AndroidMessageHuaweiCategory的更多描述可以跳转Push - 高级推送查看。

在首次推送服务与通讯类通知时，您需要调用setAndroidMusic()设置铃声，参数为客户端铃声文件的名称，不需要携带文件格式后缀名。同时您需要根据步骤1中申请的自分类权益的消息类型设置其云端通知category取值。示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setAndroidMusic("alicloud_notification_sound"); // /raw/目录下的铃声路径，不需要携带文件格式后缀名
pushRequest.setAndroidMessageHuaweiCategory("WORK"); // 步骤1中申请的自分类权益的消息类型的云端通知category取值
...

方式二：自定义通知通道

华为通道给海外应用提供了自定义通知通道的能力。用户可以在客户端创建自定义通知通道，通过给通知通道设置铃声路径属性来自定义通知铃声。

操作步骤如下：

1. 在客户端项目指定位置放入铃声文件

假设您的铃声文件为alicloud_notification_sound.mp3，您需要将它放到客户端项目工程的app/src/main/res/raw/目录下，即最终形如app/src/main/res/raw/alicloud_notification_sound.mp3。

2. 在客户端创建自定义通知通道

在创建通知通道时通过调用setSound()给通知通道指定铃声。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    // 通知通道的id。
    String channelId = "${channel_id}"; // 这个id值需要给后端开发和运维人员，推送的时候对应 AndroidNotificationChannel 参数。
    // 用户可以看到的通知通道的名字。
    CharSequence name = "${通道描述}";
    int importance = NotificationManager.IMPORTANCE_HIGH;
    NotificationChannel mChannel = new NotificationChannel(channelId, name, importance);
    // 配置通知通道的属性。
    //  自定义铃声
    mChannel.setSound(Uri.parse("android.resource://" + this.getPackageName() + "/" + R.raw.alicloud_notification_sound), Notification.AUDIO_ATTRIBUTES_DEFAULT);
    // 最后在notificationmanager中创建该通知通道。
    mNotificationManager.createNotificationChannel(mChannel);
}

3. 服务端推送通知时参数配置

服务端推送通知时配置参数AndroidNotificationChannel与AndroidNotificationHuaweiChannel。

AndroidNotificationChannel与AndroidNotificationHuaweiChannel字段说明如下：

关于AndroidNotificationChannel与AndroidNotificationHuaweiChannel的更多描述可以跳转Push - 高级推送查看。

服务端在推送消息时，需要根据步骤2中创建的通知通道的channel id进行参数设置，同时设置importance参数为NORMAL。示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setAndroidNotificationChannel("${channel_id}"); // 设置channel id
pushRequest.setAndroidNotificationHuaweiChannel("NORMAL"); // 设置importance参数
...

小米通道自定义铃声实现

自2023年2月1日起，小米发布了《推送消息分类新规》，将推送消息分为了私信消息以及公信消息两类。其中私信消息支持自定义铃声。

私信消息支持自定义channel，自定义channel需要在小米推送运营平台申请，在申请时可以指定与该channel绑定的通知铃声。

操作步骤如下：

1. 在客户端项目指定位置放入铃声文件

假设您的铃声文件为alicloud_notification_sound.mp3，您需要将它放到客户端项目工程的app/src/main/res/raw/目录下，即最终形如app/src/main/res/raw/alicloud_notification_sound.mp3。

2. 在小米推送运营平台申请自定义channel

根据channel申请及接入方法申请私信消息类型的自定义channel，申请时在自定义铃声一栏填入铃声文件的URI。

3. 服务端推送通知时配置小米推送运营平台生成的channel id

完成步骤2中的channel申请后，小米会给生成的channel分配一个channel id。

服务端在推送消息时需要根据小米分配的channel id进行参数设置。

服务端推送通知时配置参数AndroidNotificationXiaomiChannel。

AndroidNotificationXiaomiChannel字段说明如下：

关于AndroidNotificationXiaomiChannel的更多描述可以跳转Push - 高级推送查看。

示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setAndroidNotificationXiaomiChannel("${channel_id}"); // 设置小米通道的channel id，需要与小米推送运营平台申请的channel id一致
...

OPPO通道自定义铃声实现

OPPO目前同时存在着旧消息分类方式：《消息分类说明》与新消息分类方式：《OPUSH消息分类细则》。目前新消息分类方式不支持自定义铃声，只有旧消息分类方式中的私信消息类型支持自定义铃声。

以2024年11月20日为界，11.20之后开启Opush的应用只能接入新消息分类方式，无法自定义铃声。11.20之前开启Opush的应用可以自由选择接入新消息分类方式或旧消息分类方式，其中接入旧消息分类方式的应用可以自定义铃声。

操作步骤如下：

1. 在客户端项目指定位置放入铃声文件

假设您的铃声文件为alicloud_notification_sound.mp3，您需要将它放到客户端项目工程的app/src/main/res/raw/目录下，即最终形如app/src/main/res/raw/alicloud_notification_sound.mp3。

2. 在OPPO推送运营平台上为应用申请自定义channel

登录OPPO推送运营平台，选择配置管理->通道配置->登记通道。

申请私信消息类型的自定义channel：

3. 在客户端创建自定义通知通道

在创建通知通道时通过调用setSound()给通知通道指定铃声。此通知通道的id，需要与在oppo推送运营平台申请自定义channel时填写的通道ID保持一致。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    // 通知通道的id，需要与在oppo推送运营平台申请自定义channel时填写的通道ID保持一致。
    String channelId = "${channel_id}"; // 这个id值需要给后端开发和运维人员，推送的时候对应 AndroidNotificationChannel 参数。
    // 用户可以看到的通知通道的名字。
    CharSequence name = "${通道描述}";
    int importance = NotificationManager.IMPORTANCE_HIGH;
    NotificationChannel mChannel = new NotificationChannel(channelId, name, importance);
    // 配置通知通道的属性。
    //  自定义铃声
    mChannel.setSound(Uri.parse("android.resource://" + this.getPackageName() + "/" + R.raw.alicloud_notification_sound), Notification.AUDIO_ATTRIBUTES_DEFAULT);
    // 最后在notificationmanager中创建该通知通道。
    mNotificationManager.createNotificationChannel(mChannel);
}

4. 服务端推送通知时配置参数

服务端推送通知时配置参数AndroidNotificationChannel。

AndroidNotificationChannel字段说明如下：

关于AndroidNotificationChannel的更多描述可以跳转Push - 高级推送查看。

服务端在推送消息时，需要根据步骤3中创建的通知通道的channel id进行参数设置。示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setAndroidNotificationChannel("${channel_id}"); // 设置channel id
...

FCM通道自定义铃声实现

安卓8.0以上版本可以在客户端创建自定义通知通道时指定铃声。

操作步骤如下：

1. 在客户端项目指定位置放入铃声文件

假设您的铃声文件为alicloud_notification_sound.mp3，您需要将它放到客户端项目工程的app/src/main/res/raw/目录下，即最终形如app/src/main/res/raw/alicloud_notification_sound.mp3。

2. 在客户端创建自定义通知通道

在创建通知通道时通过调用setSound()给通知通道指定铃声。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    // 通知通道的id。
    String channelId = "${channel_id}"; // 这个id值需要给后端开发和运维人员，推送的时候对应 AndroidNotificationChannel 参数。
    // 用户可以看到的通知通道的名字。
    CharSequence name = "${通道描述}";
    int importance = NotificationManager.IMPORTANCE_HIGH;
    NotificationChannel mChannel = new NotificationChannel(channelId, 
                                          name, importance);
    // 配置通知通道的属性。
    //  自定义铃声
    mChannel.setSound(Uri.parse("android.resource://" + this.getPackageName() + "/" + R.raw.alicloud_notification_sound), Notification.AUDIO_ATTRIBUTES_DEFAULT);
    // 最后在notificationmanager中创建该通知通道。
    mNotificationManager.createNotificationChannel(mChannel);
}

3.服务端推送通知时配置参数

服务端推送通知时配置参数AndroidNotificationChannel。

AndroidNotificationChannel字段说明如下：

关于AndroidNotificationChannel的更多描述可以跳转Push - 高级推送查看。

服务端在推送消息时，需要根据步骤2中创建的通知通道的channel id进行参数设置。示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setAndroidNotificationChannel("${channel_id}"); // 设置channel id
...

iOS自定义铃声

APNs通道自定义铃声实现

1. 客户端设置

将音频文件添加到Xcode项目的Bundle Resources中，并确保该文件包含在应用的构建目标中。

2. 服务端配置

请使用接口Push - 高级推送向iOS设备进行推送，关键参数如下：

示例代码如下：

PushRequest pushRequest = new PushRequest();
...
pushRequest.setIOSMusic("Basso.aiff"); // 设置iOS通知声音
...