环信推送的一些常见问题
原文地址 : http://blog.csdn.net/jyt199011302/article/details/72829520
参考资料
APNS证书创建和上传到环信后台 : http://www.imgeek.org/article/825308748
APNS离线推送文档 : http://docs.easemob.com/im/300iosclientintegration/75apns
离线推送的集成代码这里就不一一介绍了, 上面文档中写的 很明白了, 接下来说下比较容易误会的几点
一. 离线推送
如果app集成时添加
App后台静默后，能够保持长连接3分钟左右。超过3分钟，长连接会断开，当前登录的账号，在服务端被认为离线。消息会存入离线消息空间，之后接收的消息会在再次登录后，连接上服务器，然后通过长连接把消息取走，投递给此用户。如果app配置了推送证书，上传了推送证书并且集成了推送功能，服务器会给接收方发一个APNs推送，则会对离线消息进行APNs推送提示消息内容，通知接收方有一条新消息。
如果想自定义推送的alert，可以在发消息的时候，在消息扩展中添加相应的字段。文档见：APNS内容解析
离线推送 : 当app被杀死或者进入后台三分钟之后
消息回调 : app在前台及app进入后台三分钟之内
注意 : 环信支持推送消息，只是目前还不能根据标签推送给特定用户组，也暂不支持推送模板。CMD消息没有推送,好友请求也没有推送
收不到离线推送时可以从下面几个方面找下原因
1.测试apns推送的时候，接受消息方的app是杀掉状态吗,或者进入后台三分钟以后
2.看看你环信后台上传的证书名称与工程中初始化SDK那里填的证书名 是不是相同的
3.配置证书时候填的id与你工程中的bundle id 是否相同
4.devicetoken有没有传给环信SDK。即查看管理后台中，对应 IM 账户下是否有您刚刚写的证书名。（如果没有，请检查您是否得到了 deviceToken）
5.确认Xcode环境是否配置正确 ,Build Settings---signing,看Debug对应的是不是开发的，Release对应的是不是生产的
6.在确认xcode运行环境是否正确 (Product-->Scheme-->Edit Scheme， 开发证书选Debug，生产证书选Release)
7.证书制作上传过程是否有问题，配置证书的时候是否设置了密码,正确的步骤可以参考：http://www.imgeek.org/article/825308748。另外可以用推送工具进行验证。
8.如果以上都没有问题，可以尝试重新制作上传一下推送证书。
对照这些检查一下，基本上就是这些原因
如果上面几点都符合的话，看下重新登录之后是否可以收到之前收不到推送消息
可以的，话提供一下AppKey，证书名 (查下证书是否被封)以及收不到的推送消息的消息id及发送方和接收方log
log导出请看这篇文章: http://www.imgeek.org/article/825308785 然后转成txt格式上传到工单上，同时注明上述配置都正确 , 环信这边来查下消息推送记录
注意 :后台没有证书名 是指用户列表后面没有显示证书名。这个证书名是SDK初始化的时候传的字符串，用户登录之后会进行绑定。
如果用户没有绑定证书名的话，肯定收不到推送的。这个证书名是用户登录之后绑定的，要确认下初始化SDK的时候有没有传。 options.apnsCertName = apnsCertName;
==============常见问题==============
Q : iOS apns离线推送证书apns的离线推送可以和友盟(极光)推送共用一个证书吗？
A : 环信的推送只要和后台上传的证书对应就可以实现，其他的不关心。
首先苹果推送证书的生成都是统一的方式，这个不区分是极光(友盟)推送证书还是个推证书等等。使用的推送证书只要按照正确的苹果推送证书生成流程创建，都可以使用。
环信添加推送证书可以看http://www.imgeek.org/article/825308748 不是要求必须重新生成推送证书
Q : 好友申请通知的离线推送?
A : 我们的好友体系，添加好友的申请不支持离线推送。
如果你们是使用App本身的好友体系，可以在app的添加好友业务上向被添加的好友发送文本消息，在EMMessage的ext中设置自定义字段，来区分此条文本消息是否用于好友申请提示，由此来判断处理UI的显示。
Q : iOS的杀死进程远程推送和服务端有关么
A : 如果客户端把远程通知给关了肯定就收不到通知,我们服务器会检测客户端是否有deviceToken,有的话才会把消息发送到deviceToken对应的设备上
Q : 每个项目创建了一个开发的推送证书一个生产的推送证书。这俩证书什么时候要做切换？
A : 在App上传AppStore前需要修改App内初始化SDK设置的推送证书名，EMOptions的apnsCertName。
注意，这里的值需要和在Console管理后天上传时设置的证书名一致。
Q : 绑定devicetoken的时候是否需要先登录到环信？
A : 绑定是需要登录过之后才进行的，
- (EMError *)bindDeviceToken:(NSData *)aDeviceToken; 是把deviceToken传给SDK。调用登录，SDK会进行绑定。也可以调用 - (void)registerForRemoteNotificationsWithDeviceToken:(NSData *)aDeviceToken
completion:(void (^)(EMError *aError))aCompletionBlock;自己绑定
需要判断是否已经登录，如果已经有登录的账号，再登录会返回 已登录的错误。
Q : 离线推送在客户端怎么设置显示详情？
A :
可以设置离线推送消息显示具体内容还是只显示-您收到一条消息
要设置在登录成功之后,然后要用服务器拉取一遍APNS 属性
然后在修改displayStyle
Q : 两个APP通信，如果只希望其中一类APP能收到推送，而另一端的APP不希望收到推送，是不是不希望收到推送的APP不配置证书就好了？
A : 两个App的推送证书都是在同一appkey下单独配置的，如果不希望收到推送，可以对此App不配置推送证书，同时在App代码中注释掉注册远程通知的相关代码。
bundle id对应的证书也可以取消push的功能,针对App不使用任何远程推送服务，包括其他第三方的，如果App还需要其他第三方的推送服务，请忽略这句话。
Q : 不配置推送证书的APP是不是只有刷新的情况下才会显示新的消息？不刷新的情况下APP是看不到新的消息？
A : 不配置推送功能的App，只有在用户登录成功后，才能通过长连接的接收消息回掉中拿到消息体。
Q : 在开发环境下收到了离线推送消息，但是在生成环境下没有收到?
A : 看一下SDK初始化时，是否设置的apnsCerName与生产环境证书上传时填写的证书名一致，还有是否为adhoc打包成ipa文件安装测试的。
Q :发送消息1,2,3,4,5 对方收到推送 2 1 5 顺序不对而且丢失, app角标也不对
A : 1.首先，苹果不保证所有远程推送的到达率。这个可以看苹果官方文档。
Because the delivery of remote notifications is not guaranteed, never include sensitive data or data that can be retrieved by other means in your payload.
2.我们只保证，把离线消息执行远程推送，发给苹果服务器。苹果服务器是否能够百分之百把所有推送送达到指定移动端，这个根据苹果的策略，当 APNs 向你发送了多条推送，你的设备在 APNs 那里下线了，这时 APNs 到你的手机的链路上有多条任务堆积，APNs 的处理方式是，只保留最后一条消息推送给你，然后告知你推送数。那么其他消息会被APNs丢弃。
3.我们保证的是离线消息，当用户重新登录时，可以都接收到。
4. 如果需要找后台查询离线消息（前提接收方已绑定deviceToken）是否成功，需要提供离线消息的messageId，接收方环信id
5.我们的推送角标，是接收方的在服务端的离线消息数。
https://developer.apple.com/library/prerelease/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/APNSOverview.html#//apple_ref/doc/uid/TP40008194-CH8-SW1
这是官方文档
Q11 :ios是怎么判断离线了 然后发推送的啊 有时候把应用杀掉后 半天收不到推送
A : rest可以查用户的状态，推送前提是此用户有devicetoken已经绑定成功
如果账号所有配置都没问题，杀掉后，其他人发的消息，过几秒就能看到推送
Q12 : Q11不管用会是什么原因呢
A : 配置，还有账号在我们这绑的deviceToken
Q : 多个app共用一个appkey 推送证书怎么配置呢
A : 后台可以上传多套推送证书。
Q :程序关闭后推送了一个消息，点击后怎样获取到环信传过来的数据
A : 需要用户点击横幅后，重新启动App，这时从- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中，获取字典launchOptions，UIApplicationLaunchOptionsRemoteNotificationKey这个key下的数据，就是aps的字典数据
二 . 消息回调
app的长连接存在的时候，环信服务器检测您为在线状态，是不会给app推送消息的。app端在线的情况下，消息会通过长连接直接收取(didreceivemessage)，收到消息，SDK会通过回调通知给上层。app通过收消息的回调拿到消息对象，然后解析并展示UI。
目前我们不支持App切后台后，可以一直执行。
我们SDK在切后台后，实现[[EMClient sharedClient] applicationDidEnterBackground:application];，会保持，直到被系统释放iOS目前其他方式应该都无法去实现一直保持App的活跃状态了。
==============常见问题==============
Q : 本地推送声音设置在哪 ?一条消息推送两声
A : 推送声音设置的要自己实现,具体可参考demo里的ChatDemoHelper类和MainViewController类里的
- (void)showNotificationWithMessage:(EMMessage *)message方法,该方法中有发送本地推送做的一系列操作,本地通知怎么做的,本地通知触发几次,一条消息推送几声,一下接收到多条消息响几声,都需要用户自己实现.
Q : 视频通话,推送怎么实现?
iOS 3.2.3之后，如果在实时通话接收方不在线时，发送提醒。
A : 1.在发起实时音视频通话前，需要设置EMCallOptions对象属性isSendPushIfOffline为YES；
2.遵守协议EMCallBuilderDelegate，实现其中的- (void)callRemoteOffline:(NSString *)aRemoteName 委托方法。
3.在第2步的方法中向 aRemoteName用户发送单聊消息。
如果被叫方已注册远程通知且绑定deviceToken，会收到对应消息的APNs推送，点击横幅来唤醒App。
上面是接收方离线的情况。如果接收方长连接还未断开，只是App切到后台，需要在回调- (void)callDidReceive:(EMCallSession *)aSession中判断当前App是否在后台，如果是弹出本地通知。
Q : EMCallOptions *options = [[EMClient sharedClient].callManager getCallOptions]; //当对方不在线时，是否给对方发送离线消息和推送，并等待对方回应 options.isSendPushIfOffline = YES; [[EMClient sharedClient].callManager setCallOptions:options];isSendPushIfOffline设置为YES后，A用户呼叫B用户，B用户处于离线状态，但B用户没有收到推送。
A : 1. 先确接收方杀掉App后，文本消息是否能收到APNs推送。
2.在1点确认App杀掉可以收到推送前提下，确认实时音视频发送方代码执行顺序如下：
（2） callManager调用
或者
Q : 推送的提示音可不可以自定义啊。
A: 推送的提示音目前不支持自定义，本地通知的你们以自己去设置。
Q : app压后台，立刻收到聊天推送来的信息，点击通知栏信息，捕获不到唤起程序事件
A : App切后台后，长连接为断开前，当前弹出的横幅是本地通知，那么此时唤醒时间是本地通知的回调
iOS10后
Q : 环信在离线状态下能收消息，但是程序运行状态按home按键进入后台的时候无法接受消息，怎么处理
A : App切入后台一段时间内，长连接还未断开，这时候接收消息都是通过SDK的接收消息回调(EMChatManagerDelegate)来收消息，不会执行APNs推送。
如果是需要弹出横幅提醒，需要在接收消息的回调方法中，判断[[UIApplication sharedApplication] applicationState]为UIApplicationStateBackground，然后实现本地通知。可以参考demo中的处理
参考资料
APNS证书创建和上传到环信后台 : http://www.imgeek.org/article/825308748
APNS离线推送文档 : http://docs.easemob.com/im/300iosclientintegration/75apns
离线推送的集成代码这里就不一一介绍了, 上面文档中写的 很明白了, 接下来说下比较容易误会的几点
一. 离线推送
如果app集成时添加
- (void)applicationDidEnterBackground:(UIApplication *)application {
[[EMClient sharedClient] applicationDidEnterBackground:application];
}
- (void)applicationWillEnterForeground:(UIApplication *)application {
[[EMClient sharedClient] applicationWillEnterForeground:application];
}App后台静默后，能够保持长连接3分钟左右。超过3分钟，长连接会断开，当前登录的账号，在服务端被认为离线。消息会存入离线消息空间，之后接收的消息会在再次登录后，连接上服务器，然后通过长连接把消息取走，投递给此用户。如果app配置了推送证书，上传了推送证书并且集成了推送功能，服务器会给接收方发一个APNs推送，则会对离线消息进行APNs推送提示消息内容，通知接收方有一条新消息。
如果想自定义推送的alert，可以在发消息的时候，在消息扩展中添加相应的字段。文档见：APNS内容解析
离线推送 : 当app被杀死或者进入后台三分钟之后
消息回调 : app在前台及app进入后台三分钟之内
注意 : 环信支持推送消息，只是目前还不能根据标签推送给特定用户组，也暂不支持推送模板。CMD消息没有推送,好友请求也没有推送
收不到离线推送时可以从下面几个方面找下原因
1.测试apns推送的时候，接受消息方的app是杀掉状态吗,或者进入后台三分钟以后
2.看看你环信后台上传的证书名称与工程中初始化SDK那里填的证书名 是不是相同的
3.配置证书时候填的id与你工程中的bundle id 是否相同
4.devicetoken有没有传给环信SDK。即查看管理后台中，对应 IM 账户下是否有您刚刚写的证书名。（如果没有，请检查您是否得到了 deviceToken）
5.确认Xcode环境是否配置正确 ,Build Settings---signing,看Debug对应的是不是开发的，Release对应的是不是生产的
6.在确认xcode运行环境是否正确 (Product-->Scheme-->Edit Scheme， 开发证书选Debug，生产证书选Release)
7.证书制作上传过程是否有问题，配置证书的时候是否设置了密码,正确的步骤可以参考：http://www.imgeek.org/article/825308748。另外可以用推送工具进行验证。
8.如果以上都没有问题，可以尝试重新制作上传一下推送证书。
对照这些检查一下，基本上就是这些原因
如果上面几点都符合的话，看下重新登录之后是否可以收到之前收不到推送消息
可以的，话提供一下AppKey，证书名 (查下证书是否被封)以及收不到的推送消息的消息id及发送方和接收方log
log导出请看这篇文章: http://www.imgeek.org/article/825308785 然后转成txt格式上传到工单上，同时注明上述配置都正确 , 环信这边来查下消息推送记录
注意 :后台没有证书名 是指用户列表后面没有显示证书名。这个证书名是SDK初始化的时候传的字符串，用户登录之后会进行绑定。
如果用户没有绑定证书名的话，肯定收不到推送的。这个证书名是用户登录之后绑定的，要确认下初始化SDK的时候有没有传。 options.apnsCertName = apnsCertName;
==============常见问题==============
Q : iOS apns离线推送证书apns的离线推送可以和友盟(极光)推送共用一个证书吗？
A : 环信的推送只要和后台上传的证书对应就可以实现，其他的不关心。
首先苹果推送证书的生成都是统一的方式，这个不区分是极光(友盟)推送证书还是个推证书等等。使用的推送证书只要按照正确的苹果推送证书生成流程创建，都可以使用。
环信添加推送证书可以看http://www.imgeek.org/article/825308748 不是要求必须重新生成推送证书
Q : 好友申请通知的离线推送?
A : 我们的好友体系，添加好友的申请不支持离线推送。
如果你们是使用App本身的好友体系，可以在app的添加好友业务上向被添加的好友发送文本消息，在EMMessage的ext中设置自定义字段，来区分此条文本消息是否用于好友申请提示，由此来判断处理UI的显示。
Q : iOS的杀死进程远程推送和服务端有关么
A : 如果客户端把远程通知给关了肯定就收不到通知,我们服务器会检测客户端是否有deviceToken,有的话才会把消息发送到deviceToken对应的设备上
Q : 每个项目创建了一个开发的推送证书一个生产的推送证书。这俩证书什么时候要做切换？
A : 在App上传AppStore前需要修改App内初始化SDK设置的推送证书名，EMOptions的apnsCertName。
注意，这里的值需要和在Console管理后天上传时设置的证书名一致。
Q : 绑定devicetoken的时候是否需要先登录到环信？
A : 绑定是需要登录过之后才进行的，
- (EMError *)bindDeviceToken:(NSData *)aDeviceToken; 是把deviceToken传给SDK。调用登录，SDK会进行绑定。也可以调用 - (void)registerForRemoteNotificationsWithDeviceToken:(NSData *)aDeviceToken
completion:(void (^)(EMError *aError))aCompletionBlock;自己绑定
需要判断是否已经登录，如果已经有登录的账号，再登录会返回 已登录的错误。
Q : 离线推送在客户端怎么设置显示详情？
A :
EMPushOptions *pushOptions = [[EMClient sharedClient] pushOptions];
pushOptions.displayStyle = EMPushDisplayStyleMessageSummary;
可以设置离线推送消息显示具体内容还是只显示-您收到一条消息
要设置在登录成功之后,然后要用服务器拉取一遍APNS 属性
EMError *error = nil;
EMPushOptions *options = [[EMClient sharedClient] getPushOptionsFromServerWithError:&error];
然后在修改displayStyle
Q : 两个APP通信，如果只希望其中一类APP能收到推送，而另一端的APP不希望收到推送，是不是不希望收到推送的APP不配置证书就好了？
A : 两个App的推送证书都是在同一appkey下单独配置的，如果不希望收到推送，可以对此App不配置推送证书，同时在App代码中注释掉注册远程通知的相关代码。
bundle id对应的证书也可以取消push的功能,针对App不使用任何远程推送服务，包括其他第三方的，如果App还需要其他第三方的推送服务，请忽略这句话。
Q : 不配置推送证书的APP是不是只有刷新的情况下才会显示新的消息？不刷新的情况下APP是看不到新的消息？
A : 不配置推送功能的App，只有在用户登录成功后，才能通过长连接的接收消息回掉中拿到消息体。
Q : 在开发环境下收到了离线推送消息，但是在生成环境下没有收到?
A : 看一下SDK初始化时，是否设置的apnsCerName与生产环境证书上传时填写的证书名一致，还有是否为adhoc打包成ipa文件安装测试的。
Q :发送消息1,2,3,4,5 对方收到推送 2 1 5 顺序不对而且丢失, app角标也不对
A : 1.首先，苹果不保证所有远程推送的到达率。这个可以看苹果官方文档。
Because the delivery of remote notifications is not guaranteed, never include sensitive data or data that can be retrieved by other means in your payload.
2.我们只保证，把离线消息执行远程推送，发给苹果服务器。苹果服务器是否能够百分之百把所有推送送达到指定移动端，这个根据苹果的策略，当 APNs 向你发送了多条推送，你的设备在 APNs 那里下线了，这时 APNs 到你的手机的链路上有多条任务堆积，APNs 的处理方式是，只保留最后一条消息推送给你，然后告知你推送数。那么其他消息会被APNs丢弃。
3.我们保证的是离线消息，当用户重新登录时，可以都接收到。
4. 如果需要找后台查询离线消息（前提接收方已绑定deviceToken）是否成功，需要提供离线消息的messageId，接收方环信id
5.我们的推送角标，是接收方的在服务端的离线消息数。
https://developer.apple.com/library/prerelease/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/APNSOverview.html#//apple_ref/doc/uid/TP40008194-CH8-SW1
这是官方文档
Q11 :ios是怎么判断离线了 然后发推送的啊 有时候把应用杀掉后 半天收不到推送
A : rest可以查用户的状态，推送前提是此用户有devicetoken已经绑定成功
如果账号所有配置都没问题，杀掉后，其他人发的消息，过几秒就能看到推送
Q12 : Q11不管用会是什么原因呢
A : 配置，还有账号在我们这绑的deviceToken
Q : 多个app共用一个appkey 推送证书怎么配置呢
A : 后台可以上传多套推送证书。
Q :程序关闭后推送了一个消息，点击后怎样获取到环信传过来的数据
A : 需要用户点击横幅后，重新启动App，这时从- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中，获取字典launchOptions，UIApplicationLaunchOptionsRemoteNotificationKey这个key下的数据，就是aps的字典数据
二 . 消息回调
app的长连接存在的时候，环信服务器检测您为在线状态，是不会给app推送消息的。app端在线的情况下，消息会通过长连接直接收取(didreceivemessage)，收到消息，SDK会通过回调通知给上层。app通过收消息的回调拿到消息对象，然后解析并展示UI。
目前我们不支持App切后台后，可以一直执行。
我们SDK在切后台后，实现[[EMClient sharedClient] applicationDidEnterBackground:application];，会保持，直到被系统释放iOS目前其他方式应该都无法去实现一直保持App的活跃状态了。
==============常见问题==============
Q : 本地推送声音设置在哪 ?一条消息推送两声
A : 推送声音设置的要自己实现,具体可参考demo里的ChatDemoHelper类和MainViewController类里的
- (void)showNotificationWithMessage:(EMMessage *)message方法,该方法中有发送本地推送做的一系列操作,本地通知怎么做的,本地通知触发几次,一条消息推送几声,一下接收到多条消息响几声,都需要用户自己实现.
Q : 视频通话,推送怎么实现?
iOS 3.2.3之后，如果在实时通话接收方不在线时，发送提醒。
A : 1.在发起实时音视频通话前，需要设置EMCallOptions对象属性isSendPushIfOffline为YES；
2.遵守协议EMCallBuilderDelegate，实现其中的- (void)callRemoteOffline:(NSString *)aRemoteName 委托方法。
3.在第2步的方法中向 aRemoteName用户发送单聊消息。
如果被叫方已注册远程通知且绑定deviceToken，会收到对应消息的APNs推送，点击横幅来唤醒App。
上面是接收方离线的情况。如果接收方长连接还未断开，只是App切到后台，需要在回调- (void)callDidReceive:(EMCallSession *)aSession中判断当前App是否在后台，如果是弹出本地通知。
Q : EMCallOptions *options = [[EMClient sharedClient].callManager getCallOptions]; //当对方不在线时，是否给对方发送离线消息和推送，并等待对方回应 options.isSendPushIfOffline = YES; [[EMClient sharedClient].callManager setCallOptions:options];isSendPushIfOffline设置为YES后，A用户呼叫B用户，B用户处于离线状态，但B用户没有收到推送。
A : 1. 先确接收方杀掉App后，文本消息是否能收到APNs推送。
2.在1点确认App杀掉可以收到推送前提下，确认实时音视频发送方代码执行顺序如下：
(1) EMCallOptions *callOptions = [[EMClient sharedClient].callManager getCallOptions];
callOptions.isSendPushIfOffline = YES;
callOptions.offlineMessageText = @"提示文本";//可选
[[EMClient sharedClient].callManager setCallOptions:callOptions];
（2） callManager调用
- (void)startVideoCall:(NSString *)aUsername
completion:(void (^)(EMCallSession *aCallSession, EMError *aError))aCompletionBlock;
或者
- (void)startVoiceCall:(NSString *)aUsername
completion:(void (^)(EMCallSession *aCallSession, EMError *aError))aCompletionBlock;
Q : 推送的提示音可不可以自定义啊。
A: 推送的提示音目前不支持自定义，本地通知的你们以自己去设置。
Q : app压后台，立刻收到聊天推送来的信息，点击通知栏信息，捕获不到唤起程序事件
A : App切后台后，长连接为断开前，当前弹出的横幅是本地通知，那么此时唤醒时间是本地通知的回调
- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification；
iOS10后
- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler；
Q : 环信在离线状态下能收消息，但是程序运行状态按home按键进入后台的时候无法接受消息，怎么处理
A : App切入后台一段时间内，长连接还未断开，这时候接收消息都是通过SDK的接收消息回调(EMChatManagerDelegate)来收消息，不会执行APNs推送。
如果是需要弹出横幅提醒，需要在接收消息的回调方法中，判断[[UIApplication sharedApplication] applicationState]为UIApplicationStateBackground，然后实现本地通知。可以参考demo中的处理
(ChatDemoHelper的- (void)didReceiveMessages:(NSArray *)aMessages)
[attach]7500[/attach][size=13]
[/size]
