版本记录
| 版本号 | 时间 |
|---|---|
| V1.0 | 2017.06.10 |
前言
很多app种都集成环信做第三方信息通讯工具，这里我们就看一下环信的主要功能和集成方法。先给出环信3.0的地址。
感兴趣的可以参考：
1. 环信ios客户端的集成（一）
2. 环信ios客户端的集成（二）
3. 环信ios客户端的集成（三）
4. 环信ios客户端的集成（四）
5. 环信ios客户端的集成（五）
6. 环信ios客户端的集成（六）
7. 环信ios客户端的集成（七）
8. 环信ios客户端的集成（八）
9. 环信ios客户端的集成（九）
10. 环信ios客户端的集成（十）
这一篇主要说一下环信的 APNS 离线推送。
一、必备条件
1. 后台上传了推送证书
具体步骤见集成 iOS SDK 前的准备工作-制作并上传推送证书。
2. 代码配置 APNS 使用的推送证书。
EMOptions *options = [EMOptions optionsWithAppkey:@"appkey"];
options.apnsCertName = @"apnsCertName";
[[EMClient sharedClient] initializeSDKWithOptions:options];
3. 代码注册离线推送。
//iOS8以上 注册APNS
if ([application respondsToSelector:@selector(registerForRemoteNotifications)]) {
[application registerForRemoteNotifications];
UIUserNotificationType notificationTypes = UIUserNotificationTypeBadge |
UIUserNotificationTypeSound |
UIUserNotificationTypeAlert;
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:notificationTypes categories:nil];
[application registerUserNotificationSettings:settings];
}
else{
UIRemoteNotificationType notificationTypes = UIRemoteNotificationTypeBadge |
UIRemoteNotificationTypeSound |
UIRemoteNotificationTypeAlert;
[[UIApplication sharedApplication] registerForRemoteNotificationTypes:notificationTypes];
}
您注册了推送功能，iOS 会自动回调以下方法，得到 deviceToken，您需要将 deviceToken 传给 SDK。
// 将得到的deviceToken传给SDK
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
[[EMClient sharedClient] bindDeviceToken:deviceToken];
}
// 注册deviceToken失败
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
NSLog(@"error -- %@",error);
}
APNS 注册失败，一般是由于使用了通用证书或者是模拟器调试导致，请检查证书并用真机调试。此处是 iOS 系统报的错，如仍不能确定，请从网上查找相关资料。
二、获取全局 APNS 配置
APNS 属性需要从服务器获取端获取。
EMError *error = nil;
EMPushOptions *options = [[EMClient sharedClient] getPushOptionsFromServerWithError:&error];
三、设置 APNS 全局属性
提供三种方法。可以配置 APNS 免打扰时间、APNS 昵称、推送样式。EMPushNotificationOptions 中的属性传入你想设置的值，调用以下方法即可。
以下方法会将 options 参数中的所有属性都更新到服务器上，请确保传入的 options 参数中的配置符合你的要求。
/*!
@property
@brief 更新服务器推送属性配置
@discussion
同步方法，会阻塞当前线程
*/
- (EMError *)updatePushOptionsToServer;
//调用：[[EMClient sharedClient] updatePushOptionsToServer];
四、单独设置 APNS 昵称
登录成功之后，按照以下代码设置当前登录用户的 APNS 昵称。
[[EMClient sharedClient] setApnsNickname:@"推送昵称"];
五、设置推送显示详情
EMPushOptions *options = [[EMClient sharedClient] pushOptions];
options.displayStyle == EMPushDisplayStyleMessageSummary // 显示消息内容
// options.displayStyle == EMPushDisplayStyleSimpleBanner // 显示“您有一条新消息”
EMError *error = [[EMClient sharedClient] updatePushOptionsToServer]; // 更新配置到服务器，该方法为同步方法，如果需要，请放到单独线程
if(!error) {
// 成功
}else {
// 失败
}
六、设置指定群组是否接收 APNS
/*!
@method
@brief 屏蔽/取消屏蔽群组推送
@param aGroupId 群组ID
@param aIgnore 是否屏蔽
@result 错误信息
@discussion
同步方法，会阻塞当前线程
*/
- (EMError *)ignoreGroupPush:(NSString *)aGroupId
ignore:(BOOL)aIgnore;
//调用:
//[[EMClient sharedClient].groupManager ignoreGroupPush:@"groupId" ignore:YES];
批量指定群组是否接收 APNS
/*!
* 屏蔽/取消屏蔽群组消息的推送
*
* 同步方法，会阻塞当前线程
*
* @param aGroupIDs 群组ID列表
* @param aIgnore 是否屏蔽
*
* @result 错误信息
*/
- (EMError *)ignoreGroupsPush:(NSArray *)aGroupIDs
ignore:(BOOL)aIsIgnore;
//调用:
//[[EMClient sharedClient].groupManager ignoreGroupsPush:@[@"group1",@"group2"] ignore:YES];
七、获取不接收 APNS 的群组 ID
登录成功之后，APNS 会自动返回不接收 APNS 的群组 ID，获取代码如下。
NSArray *ignoredGroupIds = [[EMClient sharedClient].groupManager getAllIgnoredGroupIds];
八、全局免打扰设置
登录成功后设置。
/*!
@enum
@brief 推送免打扰设置的状态
@constant EMPushNoDisturbStatusDay 全天免打扰
@constant EMPushNoDisturbStatusCustom 自定义时间段免打扰
@constant EMPushNoDisturbStatusClose 关闭免打扰模式
*/
typedef NS_ENUM(NSInteger, EMPushNoDisturbStatus) {
EMPushNoDisturbStatusDay = 0,
EMPushNoDisturbStatusCustom,
EMPushNoDisturbStatusClose,
};
// 设置全天免打扰，设置后，您将收不到任何推送
EMPushOptions *options = [[EMClient sharedClient] pushOptions];
options.noDisturbStatus = EMPushNoDisturbStatusDay;
options.noDisturbingStartH = 0;
options.noDisturbingEndH = 24;
EMError *error = [[EMClient sharedClient] updatePushOptionsToServer];
// 设置免打扰时段，设置后，在改时间内不收推送
EMPushOptions *options = [[EMClient sharedClient] pushOptions];
options.noDisturbStatus = EMPushNoDisturbStatusCustom;
options.noDisturbingStartH = 9;
options.noDisturbingEndH = 22;
EMError *error = [[EMClient sharedClient] updatePushOptionsToServer];
后记
未完，待续~~~
湖面如镜
