第三方推送集成

首先就是去华为开发者后台创建应用，并开启 push 服务，并上传对应的证书指纹，具体可以看下华为官方介绍： 华为HMS消息推送服务集成

注册完整后，需要在环信开发者后台上传推送证书，选择你的应用—>推送证书—>Huawei—>新增证书，然后输入你在华为开发者后台创建的应用的APPID和APP SECRET以及程序的包名；

为了方便用户自己升级华为推送相关sdk，环信 SDK 在3.4.x之后的版本中将华为推送的集成从SDK中转移到应用层，SDK提供上传华为推送token的接口供用户调用，方便华为推送升级时用户自行升级，以后的版本就需要开发者自己去集成华为推送相关功能，然后调用下边的方法将 token 发送到环信服务器：

// 上传 token 方法
EMClient.getInstance().sendHMSPushTokenToServer("华为appId", "注册华为的 token");

PS:需要注意，此方法必须是登录成功后才能调用，所以请求华为 token 需要放在登录成功之后，所以我们请求华为推送 token 一般放在 MainActivity 类中，环信 IM 的 Demo也已经集成了华为最新推送 SDK，开发者也可以参考 demo 进行集成

这是华为官方集成文档，开发者可以自己根据华为官方文档进行集成华为推送 华为消息推送服务集成官方文档

Demo 中将华为的 HMSAgent 做成了一个 module 进行引用（这里没有对华为 HMSAgent 进行任何封装和修改），开发者可以直接进行使用，也可以直接下载华为官方最新的HMSAgent自己进行集成，如果使用 demo 中的 module 需要修改以下几个地方：

<application>
    <!-- 接入HMSSDK 需要注册的appid参数。value的值中“10492024”用实际申请的appid替换，来源于开发者联盟网站应用的权益详情。格式 android:value="appid=xxxxxx"-->
    <meta-data
        android:name="com.huawei.hms.client.appid"
        android:value="appid=10492024" />
    <!-- 接入HMSSDK 需要注册的provider，authorities 一定不能与其他应用一样，所以这边 com.hyphenate.chatuidemo 要替换上您应用的包名-->
    <provider
        android:name="com.huawei.hms.update.provider.UpdateProvider"
        android:authorities="com.hyphenate.chatuidemo.hms.update.provider"
        android:exported="false"
        android:grantUriPermissions="true" />
    <!-- 接入HMSSDK 需要注册的provider，authorities 一定不能与其他应用一样，所以这边 com.hyphenate.chatuidemo 要替换上您应用的包名-->
    <provider
        android:name="com.huawei.updatesdk.fileprovider.UpdateSdkFileProvider"
        android:authorities="com.hyphenate.chatuidemo.updateSdk.fileProvider"
        android:exported="false"
        android:grantUriPermissions="true"/>
        ...
</application>

Demo在集成华为推送时将调用华为推送的几个方法都放在了HMSPushHelper类中，开发者可以进行参考使用

配置完这些之后，在满足条件的华为设备上就可以使用华为推送接收离线推送通知了; 这里的满足条件是指：华为设备必须安装2.6.+以上的华为移动服务，以及开启当前 app 的自启动权限；

当开发者做完这些之后如果在华为设备上还是收不到推送，可以看下控制台的输出，或者环信 sdcard 上保存的日志，是否有一下日志输出：

// 当设备的华为移动服务版本比较低的时候，无法启用华为推送，会有以下输出
huawei mobile services is not available. please upgrade
// 当注册 token 时，华为开发者后台证书不对应，或者没有开通 Push 服务，当所有的都确认没问题后，如果还是有这样的问题，这个需要联系华为技术支持查看下是否生效
hms service connection suspended. error: 6xxx 或 9xxxxxxxx

后边的 error 为华为官方错误码，更多错误码请参考华为官方错误表：表3-1 HMS 通用错误码及处理方式

使用第三方推送时需要在退出登录时解绑设备 token，调用EMClient.getInstance().logout(true)或者EMClient.getInstance().logout(true,callback)方法，如果是被踢的情况下，则要求设置为 false。

用户可以在消息扩展中增加特定的字段来实现消息的推送配置。

(Android 发消息)

EMMessage message = EMMessage.createSendMessage(EMMessage.Type.TXT);
EMTextMessageBody txtBody = new EMTextMessageBody("test");
message.setTo("6006");
// 设置自定义扩展字段
message.setAttribute("em_ignore_notification", true);
// 设置消息回调
message.setMessageStatusCallback(new EMCallBack() {...});
// 发送消息
EMClient.getInstance().chatManager().sendMessage(message);

(Android 发消息)

EMMessage message = EMMessage.createSendMessage(EMMessage.Type.TXT);
EMTextMessageBody txtBody = new EMTextMessageBody("test");
message.setTo("6006");
// 设置自定义扩展字段
message.setAttribute("em_force_notification", true);
// 设置消息回调
message.setMessageStatusCallback(new EMCallBack() {...});
// 发送消息
EMClient.getInstance().chatManager().sendMessage(message);

(Android 发消息)

// 这里只是一 TXT 消息为例，IMAGE FILE 等类型的消息设置方法相同
EMMessage message = EMMessage.createSendMessage(EMMessage.Type.TXT);
EMTextMessageBody txtBody = new EMTextMessageBody("消息内容");
message.setTo("6006");
// 设置自定义推送提示
JSONObject extObject = new JSONObject();
try {
    extObject.put("em_push_name", "离线推送标题");
    extObject.put("em_push_content", "离线推送内容部分");
} catch (JSONException e) {
    e.printStackTrace();
}
// 将推送扩展设置到消息中
message.setAttribute("em_apns_ext", extObject);
// 设置消息回调
message.setMessageStatusCallback(new EMCallBack() {...});
// 发送消息
EMClient.getInstance().chatManager().sendMessage(message);

另外，GCM 推送可以在 “em_apns_ext” 中传入 “collapseKey”、“timeToLive”来控制推送的相关属性，详见 GCM 文档