簡介
MobPush 是 Mob 平臺推出的一款推送 SDK技羔。MobPush 支持 iOS 和 Android 兩大平臺，并且有 Cocoa2d卧抗，Unity3D藤滥，JavaScript 插件支持，并支持 Rest Api 輕松接入社裆，集成更加方便簡單快捷拙绊，且提供完整的可視化數(shù)據(jù)和強(qiáng)大的管理后臺。
推送是 App 必不可少的功能泳秀，能有效提升用戶留存率和活躍度标沪，快速高效的為 App 集成 MobPush 推送服務(wù)，可應(yīng)對多樣化的推送場景晶默。
本文主要介紹 MobPush For iOS谨娜。
主要功能
| 功能 | 詳解 |
|---|---|
| 推送類型<span class="Apple-tab-span" style="white-space:pre"></span> | <div>支持通知欄通知和自定義消息</div> |
| 推送屬性<span class="Apple-tab-span" style="white-space:pre"></span> | <div>可對通知和自定義通知進(jìn)行定時發(fā)送</div> |
| 個性化推送<span class="Apple-tab-span" style="white-space:pre"></span> | <div>可根據(jù)標(biāo)簽、別名磺陡、Registration ID趴梢、地理位置精確推送</div> |
| 數(shù)據(jù)統(tǒng)計 | <div>用戶量，推送數(shù)量币他，成功數(shù)量坞靶，點擊數(shù)量，發(fā)送 API 調(diào)用數(shù)詳細(xì)統(tǒng)計數(shù)據(jù)一覽無余</div> |
| API支持 | <div> <div>提供簡單接入的 Rest API 接口蝴悉，方便開發(fā)者定制推送需求</div> </div> |
推送流程
MobPush 提供兩條通道：一條 APNs 通道彰阴，一條長連接通道。
MOBPush 推送流程
上圖可以看出：
- 當(dāng)應(yīng)用在前臺時拍冠，走 MobPush 的長連接通道尿这，MobPush 收到長連接簇抵，調(diào)用本地通知，達(dá)到和 APNs 相同的效果射众，大大增大了推送速度和成功率碟摆。
- 當(dāng)應(yīng)用在后臺時，走 APNs 通道叨橱，MobPush 服務(wù)器直接發(fā)消息給 APNs 服務(wù)器典蜕。
上面的 APNs 推送流程，就是蘋果的 APNs 流程罗洗，請看下圖：
MobPush API
下面主要介紹 MobPush 的 API 和基本使用愉舔。
-
MobPushDidReceiveMessageNotification/** 收到消息通知（數(shù)據(jù)是MPushMessage對象，可能是推送數(shù)據(jù)伙菜、自定義消息數(shù)據(jù)轩缤，APNs、本地通知等的回調(diào)） */ extern NSString *const MobPushDidReceiveMessageNotification;收到消息通知（數(shù)據(jù)是 MPushMessage 對象贩绕，可能是推送數(shù)據(jù)典奉、自定義消息數(shù)據(jù)，APNs丧叽、本地通知等的回調(diào)），通過 NSNotificationCenter 監(jiān)聽這個通知公你，根據(jù) MPushMessage 對象內(nèi)的 messageType 判斷當(dāng)前收到的通知類型：自定義消息數(shù)據(jù)踊淳，APNs、本地通知陕靠。
將所有的通知回調(diào)封裝迂尝，統(tǒng)一用通知中心監(jiān)聽，大大的減少了代碼量剪芥，方便開發(fā)者的接入垄开，使開發(fā)者的接入門檻更低。
舉個例子：-
第一步監(jiān)聽通知
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(didReceiveMessage:) name:MobPushDidReceiveMessageNotification object:nil]; -
第二步收到通知
// 收到通知回調(diào)
- (void)didReceiveMessage:(NSNotification *)notification
{
MPushMessage *message = notification.object;switch (message.messageType) { case MPushMessageTypeCustom: {// 自定義消息 } break; case MPushMessageTypeAPNs: {// APNs 回調(diào) } break; case MPushMessageTypeLocal: {// 本地通知回調(diào) } break; default: break; } } ```-
第三步在 dealloc 移除通知
- (void)dealloc { [[NSNotificationCenter defaultCenter] removeObserver:self]; }
-
-
setAPNsForProduction/** 設(shè)置推送環(huán)境 @param isProduction 是否生產(chǎn)環(huán)境税肪。 如果為開發(fā)狀態(tài)溉躲，設(shè)置為 NO； 如果為生產(chǎn)狀態(tài)益兄，應(yīng)改為 YES锻梳。 Default 為 YES 生產(chǎn)狀態(tài) */ + (void)setAPNsForProduction:(BOOL)isProduction;設(shè)置推送環(huán)境，設(shè)置當(dāng)前推送的環(huán)境是否為生產(chǎn)環(huán)境净捅， 如果為開發(fā)狀態(tài)疑枯，設(shè)置為 NO； 如果為生產(chǎn)狀態(tài)蛔六，應(yīng)改為 YES荆永。 默認(rèn)為 YES 生產(chǎn)狀態(tài)废亭。這行代碼寫在
didFinishLaunchingWithOptions，告訴 MobPush 服務(wù)器具钥，將要在哪個環(huán)境進(jìn)行推送豆村。舉個例子：
// 設(shè)置推送環(huán)境
ifdef DEBUG
[MobPush setAPNsForProduction:NO];
else
[MobPush setAPNsForProduction:YES];
endif
```
通常我們都是 DEBUG 模式下設(shè)置開發(fā)狀態(tài)，Release 模式下設(shè)置生產(chǎn)狀態(tài)氓拼。
-
setupNotification/** 設(shè)置推送配置 @param configuration 配置信息 */ + (void)setupNotification:(MPushNotificationConfiguration *)configuration;設(shè)置推送配置你画，這里主要設(shè)置推送的一些配置參數(shù)，你可以設(shè)置在任何地方桃漾。
舉個例子：
//MobPush推送設(shè)置（獲得角標(biāo)坏匪、聲音、彈框提醒權(quán)限） MPushNotificationConfiguration *configuration = [[MPushNotificationConfiguration alloc] init]; configuration.types = MPushAuthorizationOptionsBadge | MPushAuthorizationOptionsSound | MPushAuthorizationOptionsAlert; [MobPush setupNotification:configuration];上面的代碼就是最基本的配置撬统，設(shè)置推送的角標(biāo)适滓、聲音、彈框提醒權(quán)限恋追。
-
addLocalNotification/** 添加本地推送通知 @param message 消息數(shù)據(jù) */ + (void)addLocalNotification:(MPushMessage *)message;添加本地推送通知凭迹，可以定制本地通知的內(nèi)容，標(biāo)題苦囱，子標(biāo)題嗅绸，聲音，角標(biāo)撕彤，什么時間觸發(fā)等等鱼鸠。
舉個例子：
MPushMessage *message = [[MPushMessage alloc] init]; message.messageType = MPushMessageTypeLocal; MPushNotification *noti = [[MPushNotification alloc] init]; noti.body = @"推送內(nèi)容"; noti.title = @"標(biāo)題"; noti.subTitle = @"子標(biāo)題"; noti.sound = @"unbelievable.caf"; noti.badge = 999; message.notification = noti; NSDate *currentDate = [NSDate dateWithTimeIntervalSinceNow:0]; NSTimeInterval nowtime = [currentDate timeIntervalSince1970] * 1000; //設(shè)置立即觸發(fā) //message.isInstantMessage = YES; //設(shè)置幾分鐘后發(fā)起本地推送 NSTimeInterval taskDate = nowtime + self.timeValue*60*1000; message.taskDate = taskDate; [MobPush addLocalNotification:message]; -
addTags/** 添加標(biāo)簽 @param tags 標(biāo)簽組 @param handler 結(jié)果 */ + (void)addTags:(NSArray<NSString *> *)tags result:(void (^) (NSError *error))handler;添加標(biāo)簽，可以添加多個羹铅，不覆蓋蚀狰，標(biāo)簽：給用戶分組的作用，比如一個新聞類 App职员，用戶喜歡體育麻蹋、科技。給用戶添加體育焊切、科技的標(biāo)簽扮授，當(dāng)有體育和科技的文章，就可以推送給該用戶专肪。
舉個例子：
[MobPush addTags:@[@"體育", @"科技"] result:^(NSError *error) { }]; -
getTagsWithResult/** 獲取所有標(biāo)簽 @param handler 結(jié)果 */ + (void)getTagsWithResult:(void (^) (NSArray *tags, NSError *error))handler;獲取所有已添加的標(biāo)簽列表
舉個例子：
[MobPush getTagsWithResult:^(NSArray *tags, NSError *error) { NSLog(@"%@", tags); }]; -
deleteTags/** 刪除標(biāo)簽 @param tags 需要刪除的標(biāo)簽 @param handler 結(jié)果 */ + (void)deleteTags:(NSArray<NSString *> *)tags result:(void (^) (NSError *error))handler;刪除標(biāo)簽糙箍，刪除指定的標(biāo)簽
舉個例子：
[MobPush deleteTags:@"體育" result:^(NSError *error) { }]; -
cleanAllTags/** 清空所有標(biāo)簽 @param handler 結(jié)果 */ + (void)cleanAllTags:(void (^) (NSError *error))handler;清空所有標(biāo)簽
舉個例子：
[MobPush cleanAllTags:^(NSError *error) { }]; -
setAlias/** 設(shè)置別名 @param alias 別名 @param handler 結(jié)果 */ + (void)setAlias:(NSString *)alias result:(void (^) (NSError *error))handler;設(shè)置別名，別名唯一牵祟，會覆蓋深夯，一般用作指定用戶，可以將 userId 設(shè)置為別名。
舉個例子：
[MobPush setAlias:@"userId" result:^(NSError *error) { }]; -
getAliasWithResult/** 獲取別名 @param handler 結(jié)果 */ + (void)getAliasWithResult:(void (^) (NSString *alias, NSError *error))handler;獲取別名咕晋，獲取已設(shè)置的別名雹拄。
舉個例子：
[MobPush getAliasWithResult:^(NSString *alias, NSError *error) { NSLog(@"%@", alias); }]; -
deleteAlias/** 刪除別名 @param handler 結(jié)果 */ + (void)deleteAlias:(void (^) (NSError *error))handler;刪除別名，別名唯一掌呜，所有無需指定滓玖，直接刪除。
舉個例子：
[MobPush deleteAlias:^(NSError *error) { }]; -
getRegistrationID/** 獲取注冊id（可與用戶id綁定质蕉，實現(xiàn)向指定用戶推送消息） @param handler 結(jié)果 */ + (void)getRegistrationID:(void(^)(NSString *registrationID, NSError *error))handler;獲取注冊id势篡，可與用戶id綁定，實現(xiàn)向指定用戶推送消息模暗。
舉個例子：
[MobPush getRegistrationID:^(NSString *registrationID, NSError *error) { NSLog(@"%@", registrationID); }]; -
setBadge/** 設(shè)置角標(biāo)值到Mob服務(wù)器 本地先調(diào)用setApplicationIconBadgeNumber函數(shù)來顯示角標(biāo)禁悠，再將該角標(biāo)值同步到Mob服務(wù)器， @param badge 新的角標(biāo)值（會覆蓋服務(wù)器上保存的值） */ + (void)setBadge:(NSInteger)badge;設(shè)置角標(biāo)值到 Mob 服務(wù)器兑宇，同步角標(biāo)
舉個例子：
[MobPush setBadge:99]; -
clearBadge/** 清除角標(biāo)碍侦，但不清空通知欄消息 */ + (void)clearBadge;清除角標(biāo)，但不清空通知欄消息隶糕。
舉個例子：
[MobPush clearBadge];
