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:@"推送昵称"];

设置指定群组是否接收 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 的群组 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 = EMPushNoDisturbStatusClose;
EMError *error = [[EMClient sharedClient] updatePushOptionsToServer];


// 设置免打扰时段,设置后,在改时间内不收推送
EMPushOptions *options = [[EMClient sharedClient] pushOptions];
options.noDisturbStatus = EMPushNoDisturbStatusCustom;
options.noDisturbingStartH = 9;
options.noDisturbingEndH = 22;
EMError *error = [[EMClient sharedClient] updatePushOptionsToServer];

上一页:红包集成

下一页:EaseUI使用指南