一. 离线推送

如果app集成时添加

- (void)applicationDidEnterBackground:(UIApplication *)application {

[[EMClient sharedClient] applicationDidEnterBackground:application];

}

- (void)applicationWillEnterForeground:(UIApplication *)application {

[[EMClient sharedClient] applicationWillEnterForeground:application];

}

App后台静默后，能够保持长连接3分钟左右。超过3分钟，长连接会断开，当前登录的账号，在服务端被认为离线。消息会存入离线消息空间，之后接收的消息会在再次登录后，连接上服务器，然后通过长连接把消息取走，投递给此用户。如果app配置了推送证书，上传了推送证书并且集成了推送功能，服务器会给接收方发一个APNs推送，则会对离线消息进行APNs推送提示消息内容，通知接收方有一条新消息。

如果想自定义推送的alert，可以在发消息的时候，在消息扩展中添加相应的字段。文档见：http://docs.easemob.com/im/300iosclientintegration/apnscontent

所以这里推送说的是当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 : 好友申请通知的离线推送?

我们的好友体系，添加好友的申请不支持离线推送。

如果你们是使用App本身的好友体系，可以在app的添加好友业务上向被添加的好友发送文本消息，在EMMessage的ext中设置自定义字段，来区分此条文本消息是否用于好友申请提示，由此来判断处理UI的显示。

Q : iOS的杀死进程远程推送和服务端有关么

A: 如果客户端把远程通知给关了肯定就收不到通知,我们服务器会检测客户端是否有deviceToken,有的话才会把消息发送到deviceToken对应的设备上

Q : 每个项目创建了一个开发的推送证书一个生产的推送证书。这俩证书什么时候要做切换？

在App上传AppStore前需要修改App内初始化SDK设置的推送证书名，EMOptions的apnsCertName。

注意，这里的值需要和在Console管理后天上传时设置的证书名一致。

Q : 绑定devicetoken的时候是否需要先登录到环信？

绑定是需要登录过之后才进行的，

- (EMError *)bindDeviceToken:(NSData *)aDeviceToken; 是把deviceToken传给SDK。调用登录，SDK会进行绑定。也可以调用 - (void)registerForRemoteNotificationsWithDeviceToken:(NSData *)aDeviceToken

completion:(void (^)(EMError *aError))aCompletionBlock;自己绑定

需要判断是否已经登录，如果已经有登录的账号，再登录会返回 已登录的错误。

Q : 离线推送在客户端怎么设置显示详情？

EMPushOptions *pushOptions = [[EMClient sharedClient] pushOptions];

pushOptions.displayStyle = EMPushDisplayStyleMessageSummary;

可以设置离线推送消息显示具体内容还是只显示-您收到一条消息

要设置在登录成功之后,然后要用服务器拉取一遍APNS 属性

EMError *error = nil;

EMPushOptions *options = [[EMClient sharedClient] getPushOptionsFromServerWithError:&error];

然后在修改displayStyle

Q : 两个APP通信，如果只希望其中一类APP能收到推送，而另一端的APP不希望收到推送，是不是不希望收到推送的APP不配置证书就好了？

两个App的推送证书都是在同一appkey下单独配置的，如果不希望收到推送，可以对此App不配置推送证书，同时在App代码中注释掉注册远程通知的相关代码。

bundle id对应的证书也可以取消push的功能,针对App不使用任何远程推送服务，包括其他第三方的，如果App还需要其他第三方的推送服务，请忽略这句话。

Q : 不配置推送证书的APP是不是只有刷新的情况下才会显示新的消息？不刷新的情况下APP是看不到新的消息？

不配置推送功能的App，只有在用户登录成功后，才能通过长连接的接收消息回掉中拿到消息体。

Q : 在开发环境下收到了离线推送消息，但是在生成环境下没有收到?

看一下SDK初始化时，是否设置的apnsCerName与生产环境证书上传时填写的证书名一致，还有是否为adhoc打包成ipa文件安装测试的。

Q :发送消息1,2,3,4,5 对方收到推送 2 1 5 顺序不对而且丢失, app角标也不对

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.我们保证的是离线消息，当用户重新登录时，可以都接收到。

Q11 :ios是怎么判断离线了 然后发推送的啊 有时候把应用杀掉后 半天收不到推送

rest可以查用户的状态，推送前提是此用户有devicetoken已经绑定成功

如果账号所有配置都没问题，杀掉后，其他人发的消息，过几秒就能看到推送

Q12 : Q11不管用会是啥原因呢

配置，还有账号在我们这绑的deviceToken

Q : 多个app共用一个appkey 推送证书怎么配置呢

后台可以上传多套推送证书。

Q :程序关闭后推送了一个消息，点击后怎样获取到环信传过来的数据

需要用户点击横幅后，重新启动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的活跃状态了。

android 这边后台受到各种 rom 的限制，没有固定的结果，有可能马上就被杀死，有可能一直不被杀死，你可以尝试下自己对自己的 app 进行后台保活http://melove.net/blog/2017/03/android-daemon-service-1488942411000.html

==============常见问题==============

Q : 本地推送声音设置在哪 ?一条消息推送两声

A: 推送声音设置的要自己实现,具体可参考demo里的ChatDemoHelper类和MainViewController类里的

(void)showNotificationWithMessage:(EMMessage *)message方法,该方法中有发送本地推送做的一系列操作,本地通知怎么做的,本地通知触发几次,一条消息推送几声,一下接收到多条消息响几声,都需要用户自己实现.

Q : 视频通话,推送怎么实现?

iOS 3.2.3之后，如果在实时通话接收方不在线时，发送提醒。

1.在发起实时音视频通话前，需要设置EMCallOptions对象属性isSendPushIfOffline为YES；

2.遵守协议EMCallBuilderDelegate，实现其中的- (void)callRemoteOffline:(NSString *)aRemoteName 委托方法。

3.在第2步的方法中向 aRemoteName用户发送单聊消息。

如果被叫方已注册远程通知且绑定deviceToken，会收到对应消息的APNs推送，点击横幅来唤醒App。

上面是接收方离线的情况。如果接收方长连接还未断开，只是App切到后台，需要在回调- (void)callDidReceive:(EMCallSession *)aSession中判断当前App是否在后台，如果是弹出本地通知。

EMCallOptions *options = [[EMClient sharedClient].callManager getCallOptions]; //

当对方不在线时，是否给对方发送离线消息和推送，并等待对方回应

options.isSendPushIfOffline = YES; [[EMClient sharedClient].callManager setCallOptions:options];

isSendPushIfOffline设置为YES后，A用户呼叫B用户，B用户处于离线状态，但B用户没有收到推送。

SDK版本是3.2.0

先确接收方杀掉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 : 推送的提示音可不可以自定义啊。

推送的提示音目前不支持自定义，本地通知的你们以自己去设置。

Q : app压后台，立刻收到聊天推送来的信息，点击通知栏信息，捕获不到唤起程序事件

App切后台后，长连接为断开前，当前弹出的横幅是本地通知，那么此时唤醒时间是本地通知的回调

- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification；

iOS10后

- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void (^)())completionHandler；

Q : 环信在离线状态下能收消息，但是程序运行状态按home按键进入后台的时候无法接受消息，怎么处理

App切入后台一段时间内，长连接还未断开，这时候接收消息都是通过SDK的接收消息回调(EMChatManagerDelegate)来收消息，不会执行APNs推送。

如果是需要弹出横幅提醒，需要在接收消息的回调方法中，判断[[UIApplication sharedApplication] applicationState]为UIApplicationStateBackground，然后实现本地通知。可以参考demo中的处理