个推消息推送SDK通知栏铃声功能解析及使用攻略

Posted 2022-03-01 个推技术

本文为大家分享个推消息推送SDK【通知栏铃声】功能的使用窍门，帮助开发者用简单10行代码，即可以声传意，轻松收获用户喜爱。

一、功能介绍

众所周知，消息推送是App和用户之间交互的桥梁。App通过通知栏消息，低成本、高效率地向用户告知产品功能更新、运营活动上线、日常新闻动态等重要消息。

为了使用户不错过重要通知，个推SDK还支持App开发者自定义个性化的通知栏铃声（区别于系统提示音），通过声音的方式，更加有效地提醒用户及时查阅关键消息。比如个推某生活服务类App客户使用该功能，将自制的温馨提示音作为通知栏铃声，告知其App用户“您的外卖到了”，从而拉近了和用户之间的距离。

接下来，本文就围绕该功能的接入方式、通知栏铃声的配置方式及相关注意事项等方面展开，帮助广大开发者快速解锁该功能，通过设置好听、个性化的“通知栏铃声”，为用户提供高效和贴心服务，打动用户芳心，提升App用户黏性和活跃度。

二、功能接入

个推消息推送SDK“通知栏铃声”功能供开发者免费使用，开发者需要在客户端和服务端同时做相应设置，才能实现该功能。

2.1 客户端

Android

在客户端app/raw目录下放置铃声文件（支持mp3、wav、mpeg等多种格式的音频文件），例如设置铃声文件名为：ringing.mp3。

iOS

在客户端把自制好的的铃声添加到项目的main bundle中后，在项目设置Build Phases-->Copy Bundle Resources中添加您的铃声文件（支持 aiff、wav、caf、mp3等格式的音频）。

2.2 服务端

开发者可通过调用 个推服务端API（https://docs.getui.com/getui/server/rest_v2/push）或者登陆个推开发者中心，从 页面https://dev.getui.com/?activityId=xuetang#/overviewIndex下发消息。针对这两种消息下发方式，开发者都可以通过简单配置，自定义消息下发时的通知栏铃声。

方式一：服务端API设置

由于默认的厂商策略是：在成功集成多厂商的前提下且App在线（即App在前台打开运行）时，下发push_message内的消息；App离线（App在后台、锁屏、进程关闭）时，下发push_channel内的消息。因此开发者在调用个推服务端API下发消息时，需要同时在push_message和push_channel内指定该铃声。

联系@个推技术支持，获取配置说明：

个推技术支持企业微信

温馨提示：

1. 使用自定义铃声前，必须完成个推SDK和个推消息推送多厂商版本SDK集成，建议使用最新版个推SDK： 集成指南-个推文档中心

2. options内相关参数的生成，可参考个推文档中心详解： 多厂商参数-个推文档中心

3. 通过以上方式实现后，App在线时：ios、android都支持自定义铃声；App离线时：iOS完全支持，Android 暂时只有小米、华为机型支持自定义铃声。其它安卓机型，等待对应厂商平台开放相关功能后会进行适配。

方 式二：个推开发者中心配置

Step1：

登陆个推开发者中心（https://dev.getui.com/?activityId=xuetang#/overviewIndex），进入个推消息推送dos页面，点击【创建推送】后在Android配置模块中选择【通知渠道模板】。一般默认为响铃、震动、唤醒屏幕。

Step2：

通过设置通知渠道模板来设置通知的提醒方式。可以自主选择响铃、震动、浮动、唤醒屏幕等多种方式对用户进行消息弱提醒、强提醒。如果是重要的消息内容，还可以针对通知栏铃声进行自定义设置，提醒相应用户群体及时关注消息；如果没有进行自定义设置，则通知栏铃声默认为系统声音。

Step3：

自定义铃声设置：在渠道模板【提醒方式】中选择通知铃声，输入自定义文件名。

总结

个推消息推送SDK不仅支持对通知栏消息设置自定义铃声，还支持自定义角标，提供大图、动态视频等富媒体形式的消息推送服务，让App开发者可以自主设置通知栏的展示样式，和用户建立更加有趣、有效、有爱的互动联结。快来体验个推消息推送SDK的【通知栏铃声功能】，用开发者的别样浪漫，收获用户芳心！

登陆个推开发者中心（https://dev.getui.com），获取个推消息推送SDK最新版本，解锁App用户触达新姿势。