最近一段时间工作量比较大, 抽不出时间来整理博客, 趁今天任务量较小的时候整理下关于环信推送的问题, 介绍. 集成以及常见的问题 , 这周末空的话我会写个推送的demo和实时音视频的demo出来
APNs证书创建和上传到环信后台 :http://www.imgeek.org/article/825308748
APNS离线推送文档 : http://docs.easemob.com/im/300iosclientintegration/75apns
原文地址:http://www.imgeek.org/article/825308792
一. 离线推送
如果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.我们保证的是离线消息,当用户重新登录时,可以都接收到。
- 如果需要找后台查询离线消息(前提接收方已绑定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是怎么判断离线了 然后发推送的啊 有时候把应用杀掉后 半天收不到推送
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中的处理