版本記錄
| 版本號 | 時間 |
|---|---|
| V1.0 | 2017.06.10 |
前言
很多app種都集成環(huán)信做第三方信息通訊工具，這里我們就看一下環(huán)信的主要功能和集成方法寝受。先給出環(huán)信3.0的地址坷牛。
感興趣的可以參考：
1. 環(huán)信ios客戶端的集成（一）
2. 環(huán)信ios客戶端的集成（二）
3. 環(huán)信ios客戶端的集成（三）
4. 環(huán)信ios客戶端的集成（四）
5. 環(huán)信ios客戶端的集成（五）
6. 環(huán)信ios客戶端的集成（六）
7. 環(huán)信ios客戶端的集成（七）
8. 環(huán)信ios客戶端的集成（八）
9. 環(huán)信ios客戶端的集成（九）
10. 環(huán)信ios客戶端的集成（十）
這一篇主要說一下環(huán)信的 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 會自動回調(diào)以下方法，得到 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 注冊失敗乾翔，一般是由于使用了通用證書或者是模擬器調(diào)試導致爱葵，請檢查證書并用真機調(diào)試。此處是 iOS 系統(tǒng)報的錯反浓，如仍不能確定萌丈，請從網(wǎng)上查找相關資料。
二雷则、獲取全局 APNS 配置
APNS 屬性需要從服務器獲取端獲取辆雾。
EMError *error = nil;
EMPushOptions *options = [[EMClient sharedClient] getPushOptionsFromServerWithError:&error];
三、設置 APNS 全局屬性
??提供三種方法月劈《扔兀可以配置 APNS 免打擾時間、APNS 昵稱猜揪、推送樣式惭墓。EMPushNotificationOptions 中的屬性傳入你想設置的值，調(diào)用以下方法即可而姐。
以下方法會將 options 參數(shù)中的所有屬性都更新到服務器上腊凶，請確保傳入的 options 參數(shù)中的配置符合你的要求。
/*!
@property
@brief 更新服務器推送屬性配置
@discussion
同步方法拴念，會阻塞當前線程
*/
- (EMError *)updatePushOptionsToServer;
//調(diào)用：[[EMClient sharedClient] updatePushOptionsToServer];
四钧萍、單獨設置 APNS 昵稱
登錄成功之后，按照以下代碼設置當前登錄用戶的 APNS 昵稱政鼠。
[[EMClient sharedClient] setApnsNickname:@"推送昵稱"];
五风瘦、設置推送顯示詳情
EMPushOptions *options = [[EMClient sharedClient] pushOptions];
options.displayStyle == EMPushDisplayStyleMessageSummary // 顯示消息內(nèi)容
// 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;
//調(diào)用:
//[[EMClient sharedClient].groupManager ignoreGroupPush:@"groupId" ignore:YES];
批量指定群組是否接收 APNS
/*!
* 屏蔽/取消屏蔽群組消息的推送
*
* 同步方法蟹略，會阻塞當前線程
*
* @param aGroupIDs 群組ID列表
* @param aIgnore 是否屏蔽
*
* @result 錯誤信息
*/
- (EMError *)ignoreGroupsPush:(NSArray *)aGroupIDs
ignore:(BOOL)aIsIgnore;
//調(diào)用:
//[[EMClient sharedClient].groupManager ignoreGroupsPush:@[@"group1",@"group2"] ignore:YES];
七登失、獲取不接收 APNS 的群組 ID
登錄成功之后，APNS 會自動返回不接收 APNS 的群組 ID挖炬，獲取代碼如下揽浙。
NSArray *ignoredGroupIds = [[EMClient sharedClient].groupManager getAllIgnoredGroupIds];
八、全局免打擾設置
登錄成功后設置意敛。
/*!
@enum
@brief 推送免打擾設置的狀態(tài)
@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];
// 設置免打擾時段草姻，設置后钓猬，在改時間內(nèi)不收推送
EMPushOptions *options = [[EMClient sharedClient] pushOptions];
options.noDisturbStatus = EMPushNoDisturbStatusCustom;
options.noDisturbingStartH = 9;
options.noDisturbingEndH = 22;
EMError *error = [[EMClient sharedClient] updatePushOptionsToServer];
后記
未完，待續(xù)~~~
湖面如鏡
