【超全总结】集成环信消息推送注意事项（华为、oppo、vivo等）

news2024/9/25 7:26:01

环信即时通讯 IM 支持集成第三方厂商的消息推送服务，为 Android 开发者提供低延时、高送达、高并发、不侵犯用户个人数据的离线消息推送服务。

当客户端应用进程被关闭等原因导致用户离线，环信即时通讯 IM 服务会通过第三方厂商的消息推送服务向该离线用户的设备推送消息通知。当用户再次上线时，会收到离线期间所有消息。

目前支持的手机厂商推送服务包括：Google、华为、小米、OPPO、VIVO 和魅族。本文介绍在客户端应用中实现各厂商的推送服务时需要注意的事项。

1.初始化注意事项

参考文档中提供的案例

这部分操作时在环信初始化的时候来进行的

注意：

EMoptions 一定不要重复创建对象 如果重复创建，是不会出现对象重复的报错，因此会导致初始化的时候绑定不上证书，所以这块要特别注意

2.FCM推送需要注意事项

（1）FCM推送上传

此图的json文件是需要上传到环信管理后台的并不是给客户端的json

（2）options.enableFCM("") 参数值就是在环信管理后台上传的SenderID

关于客户端绑定的id 在我们的 google-service.json文件中project_number

(3) 如果在接收推送的时候没有出现通知，可以检查下是否已经在EMFCMMSGService中自己写入了本地通知，环信只为FCM做了一个唤醒需要您自己做本地通知进行展示，如果没有看到通知但是接收方是有唤醒的,也视为成功，自己评判不准确可以提供接收方的日志提供给环信技术支持查看下

","marks":[{"type":"color","value":"#ffb45f"},{"type":"backgroundColor","value":"rgb(51, 51, 51)"},{"type":"fontFamily","value":"Courier New"},{"type":"fontSize","value":12}]}]}],"state":{}},{"type":"block","id":"LLhI-1665372447646","name":"paragraph","data":{"version":1},"nodes":[{"type":"text","id":"fiGI-1665372447644","leaves":[{"text":"","marks":[{"type":"fontSize","value":12}]}]}],"state":{}}]" style="white-space: normal;">

3.华为推送注意事项

（1）华为的通知在app未上架之前的通知级别默认是不重要通知（运营通知）只有上线以后才可以自己定义界别其次可能是因为推送的标题的限制直接到不重要通知中，

（2）支持自定义铃声华为设备必须安装2.6+以上华为移动服务还需要开启当前app的启动权限

（3）清单文件中声明appid <meta-data android:name="com.huawei.hms.client.appid" android:value="appid=填写开发者的appid" /> （4）证书上传在管理后台要上传 OAuth2.0客户端中Client Secret 起首为小写的密钥

（4）证书上传在管理后台要上传 OAuth2.0客户端中Client Secret

（5）华为厂商集成需要导入agconnect-services.json文件以及环信封装好的类导入到项目中（HMSPushHelper）需要在初始化以后在Mainactivty的onCreate中引用 HMSPushHelper.getInstance().getHMSToken(this);

HMSPushHelper在环信demo中有提供直接将此类拖入到您的项目中即可使用

（6）华为推送的通知进入到营销通知去华为官网按照这个看下自动类权益设置一下

4.OPPO推送注意事项

1.环信管理后台截图

（1）OPPO集成的时候上传证书环信管理后台上传的是MasterSecret 而客户端（AS初始化）上绑定的是AppSecret

2. oppo官网Master位置截图

oppo官方链接：【推送服务】OPPO PUSH 客户端SDK接口文档（2.1.0版本） - 移动服务 - 开发者社区

（1）客户端绑定证书是Appsecret 调用 enableOppoPush("appkey","appSecret");

（2） SDK 3.7.1-升3.9.0级到 2.1.0 版本初始化添加（HeytapPushManager.init(context,true)），如果OPPO aar版本为 3.0.0 环信sdk需要升级大于或等于3.9.1 OPPO的通知也会归纳到不重要级别具体配置需要在OPPO控制台进行自己配置

（样例图中展示SDK是3.8.5 所以使用的oppo2.1.0.aar）