关于前端:MobPush-框架和-API

简介

MobPush 是 Mob 平台推出的一款推送 SDK。MobPush 反对 iOS 和 Android 两大平台，并且有 Cocoa2d，Unity3D，JavaScript 插件反对，并反对 Rest Api 轻松接入，集成更加不便简略快捷，且提供残缺的可视化数据和弱小的治理后盾。

推送是 App 必不可少的性能，能无效晋升用户留存率和活跃度，疾速高效的为 App 集成 MobPush 推送服务，可应答多样化的推送场景。

本文次要介绍 MobPush For iOS。

次要性能

推送流程

MobPush 提供两条通道：一条 APNs 通道，一条长连贯通道。

MOBPush 推送流程

上图能够看出：

当利用在前台时，走 MobPush 的长连贯通道，MobPush 收到长连贯，调用本地告诉，达到和 APNs 雷同的成果，大大增大了推送速度和成功率。
当利用在后盾时，走 APNs 通道，MobPush 服务器间接发消息给 APNs 服务器。
下面的 APNs 推送流程，就是苹果的 APNs 流程，请看下图：

MobPush API
上面次要介绍 MobPush 的 API 和根本应用。

MobPushDidReceiveMessageNotification

/**
收到音讯告诉（数据是 MPushMessage 对象，可能是推送数据、自定义音讯数据，APNs、本地告诉等的回调）
*/
extern NSString *const MobPushDidReceiveMessageNotification;
收到音讯告诉（数据是 MPushMessage 对象，可能是推送数据、自定义音讯数据，APNs、本地告诉等的回调），通过 NSNotificationCenter 监听这个告诉，依据 MPushMessage 对象内的 messageType 判断以后收到的告诉类型：自定义音讯数据，APNs、本地告诉。
将所有的告诉回调封装，对立用告诉核心监听，大大的缩小了代码量，不便开发者的接入，使开发者的接入门槛更低。
举个例子：

第一步监听告诉

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(didReceiveMessage:) name:MobPushDidReceiveMessageNotification object:nil];
第二步收到告诉

// 收到告诉回调

• (void)didReceiveMessage:(NSNotification *)notification
  {
  MPushMessage *message = notification.object;

  switch (message.messageType)
  {

     case MPushMessageTypeCustom:
     {// 自定义音讯}
         break;
         
     case MPushMessageTypeAPNs:
     {// APNs 回调}
         break;
         
     case MPushMessageTypeLocal:
     {// 本地告诉回调}
         break;
         
     default:
         break;

  }
  }

   第三步在 dealloc 移除告诉 

• (void)dealloc
  {
  [[NSNotificationCenter defaultCenter] removeObserver:self];
  }
  setAPNsForProduction

  /**
  设置推送环境

  @param isProduction 是否生产环境。如果为开发状态，设置为 NO；如果为生产状态，应改为 YES。Default 为 YES 生产状态
  */

• (void)setAPNsForProduction:(BOOL)isProduction;
  设置推送环境，设置以后推送的环境是否为生产环境，如果为开发状态，设置为 NO；如果为生产状态，应改为 YES。默认为 YES 生产状态。这行代码写在 didFinishLaunchingWithOptions，通知 MobPush 服务器，将要在哪个环境进行推送。

  举个例子：

  // 设置推送环境

  ifdef DEBUG
  [MobPush setAPNsForProduction:NO];
  else
  [MobPush setAPNsForProduction:YES];
  endif

通常咱们都是 DEBUG 模式下设置开发状态，Release 模式下设置生产状态。
setupNotification

/**
设置推送配置

@param configuration 配置信息
*/

• (void)setupNotification:(MPushNotificationConfiguration *)configuration;
  设置推送配置，这里次要设置推送的一些配置参数，你能够设置在任何中央。

举个例子：

//MobPush 推送设置（取得角标、声音、弹框揭示权限）
MPushNotificationConfiguration *configuration = [[MPushNotificationConfiguration alloc] init];
configuration.types = MPushAuthorizationOptionsBadge | MPushAuthorizationOptionsSound | MPushAuthorizationOptionsAlert;
[MobPush setupNotification:configuration];
下面的代码就是最根本的配置，设置推送的角标、声音、弹框揭示权限。

addLocalNotification

/**
增加本地推送告诉

@param message 音讯数据
*/

• (void)addLocalNotification:(MPushMessage *)message;
  增加本地推送告诉，能够定制本地告诉的内容，题目，子标题，声音，角标，什么工夫触发等等。

举个例子：

MPushMessage *message = [[MPushMessage alloc] init];
message.messageType = MPushMessageTypeLocal;
MPushNotification *noti = [[MPushNotification alloc] init];
noti.body = @” 推送内容 ”;
noti.title = @” 题目 ”;
noti.subTitle = @” 子标题 ”;
noti.sound = @”unbelievable.caf”;
noti.badge = 999;
message.notification = noti;

NSDate *currentDate = [NSDate dateWithTimeIntervalSinceNow:0];
NSTimeInterval nowtime = [currentDate timeIntervalSince1970] * 1000;

// 设置立刻触发
//message.isInstantMessage = YES;

// 设置几分钟后发动本地推送
NSTimeInterval taskDate = nowtime + self.timeValue601000;
message.taskDate = taskDate;
[MobPush addLocalNotification:message];
addTags

/**
增加标签

@param tags 标签组
@param handler 后果
*/

• (void)addTags:(NSArray<NSString *> )tags result:(void (^) (NSError error))handler;
  增加标签，能够增加多个，不笼罩，标签：给用户分组的作用，比方一个新闻类 App，用户喜爱体育、科技。给用户增加体育、科技的标签，当有体育和科技的文章，就能够推送给该用户。

举个例子：

[MobPush addTags:@[@” 体育 ”, @” 科技 ”] result:^(NSError *error) {

}];
getTagsWithResult

/**
获取所有标签

@param handler 后果
*/

• (void)getTagsWithResult:(void (^) (NSArray tags, NSError error))handler;
  获取所有已增加的标签列表

举个例子：

[MobPush getTagsWithResult:^(NSArray tags, NSError error) {

NSLog(@"%@", tags);

}];
deleteTags

/**
删除标签

@param tags 须要删除的标签
@param handler 后果
*/

• (void)deleteTags:(NSArray<NSString *> )tags result:(void (^) (NSError error))handler;
  删除标签，删除指定的标签

举个例子：

[MobPush deleteTags:@” 体育 ” result:^(NSError *error) {

}];
cleanAllTags

/**
清空所有标签

@param handler 后果
*/

• (void)cleanAllTags:(void (^) (NSError *error))handler;
  清空所有标签

举个例子：

[MobPush cleanAllTags:^(NSError *error) {

}];
setAlias

/**
设置别名

@param alias 别名
@param handler 后果
*/

• (void)setAlias:(NSString )alias result:(void (^) (NSError error))handler;
  设置别名，别名惟一，会笼罩，个别用作指定用户，能够将 userId 设置为别名。

举个例子：

[MobPush setAlias:@”userId” result:^(NSError *error) {

}];
getAliasWithResult

/**
获取别名

@param handler 后果
*/

• (void)getAliasWithResult:(void (^) (NSString alias, NSError error))handler;
  获取别名，获取已设置的别名。

举个例子：

[MobPush getAliasWithResult:^(NSString alias, NSError error) {

NSLog(@"%@", alias);

}];
deleteAlias

/**
删除别名

@param handler 后果
*/

• (void)deleteAlias:(void (^) (NSError *error))handler;
  删除别名，别名惟一，所有无需指定，间接删除。

举个例子：

[MobPush deleteAlias:^(NSError *error) {

}];
getRegistrationID

/**
获取注册 id（可与用户 id 绑定，实现向指定用户推送音讯）

@param handler 后果
*/

• (void)getRegistrationID:(void(^)(NSString registrationID, NSError error))handler;
  获取注册 id，可与用户 id 绑定，实现向指定用户推送音讯。

举个例子：

[MobPush getRegistrationID:^(NSString registrationID, NSError error) {

NSLog(@"%@", registrationID);

}];
setBadge

/**
设置角标值到 Mob 服务器
本地先调用 setApplicationIconBadgeNumber 函数来显示角标，再将该角标值同步到 Mob 服务器，
@param badge 新的角标值（会笼罩服务器上保留的值）
*/

• (void)setBadge:(NSInteger)badge;
  设置角标值到 Mob 服务器，同步角标

举个例子：

[MobPush setBadge:99];
clearBadge

/**
革除角标，但不清空告诉栏音讯
*/

• (void)clearBadge;
  革除角标，但不清空告诉栏音讯。

举个例子：

[MobPush clearBadge];