帮助与文档

> >

1、获取AppKey

 

申请Appkey的流程,请点击 这里

2、下载SDK

下载解压后,如下图:

目录结构

 

3、导入SDK

(1)手动下载SDK导入

解压下载的ZIP包,将解压后的SDK添加到项目中。
注意:该步骤中添加时,请选择“Create groups for any added folders”单选按钮组。如果你选择“Create folder references for any added folders”,一个蓝色的文件夹引用将被添加到项目并且将无法找到它的资源。

(2)pod导入

1、首先 cd 至项目的根目录,执行 pod setup;

2、按需在 Podfile 文件中添加命令:

3、如果之前没有安装过,第一次使用请先执行

安装库:pod install

如果之前已经安装过,那只需要再执行

更新库:pod update

4、添加项目依赖库

必须添加的依赖库如下:

5MobPush的初始化配置和功能接口。

5.1 配置AppKeyAppSecret

在项目的Info.plist中添加2个字段:MOBAppKey和MOBAppSecret,对应的值是在mob.com官方申请的应用的AppKey和AppSecret。

在Info.plist配置 Privacy – Location When In Use Usage Description 权限以及App Transport Security Settings

 

 

 

证书里需要开通apns功能,然后在项目里设置,如下:

5.2 推送配置(以下代码具有通用性,可直接粘贴使用)

在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions中进行推送配置即可。

引入头文件:

调用方法:

5.3 功能接口调用

所有的功能接口都在MobPush.h中。

目前的MobPush的推送机制是:当应用在前台时,维持与推送服务器的长连接,实时接收推送消息;当应用在后台时,通过苹果APNs推送通知。

当应用处于前台,通过监听@“MobPushDidReceiveMessageNotification”服务,即可收到所有通知或者自定义消息的回调(应用处于后台不可接收该回调)。另外:点击通知栏消息也可以收到该回调。

先引入头文件:

再调用方法:

收到的消息数据可能是:1、UDP自定义消息,2、APNs,3、本地通知。根据不同的类型做相应显示即可,具体例子如下:

推送打开指定链接页面

如果开发者想要对通知消息进行点击跳转到H5页面的操作,可以在开发者管理后台配置url额外字段。

当用户点击带有url链接的通知时,需要在回调中获取message.msgInfo[@“url”],进行业务相关的跳转,可参考demo。

推送打开指定应用内指定页面

1.如果开发者想要对通知消息进行点击跳转到app内指定页面的操作,可以在开发者管理后台打开配置开关和参数设置。

Scheme地址:为开发者自定义的控制器路径。

传递参数:为跳转控制器的初始化参数。

2.开发者需要在自己的应用内对所跳转的控制器进行相关代码设置。如下:(可参照demo中PushViewController.m)

引入头文件

6.富媒体推送

iOS10以上新增了Notification Service Extension机制,可在消息送达时进行业务处理。这意味着在APNs到达我们的设备之前,还会经过一层允许用户自主设置的Extension服务进行处理,为APNs增加了多样性。

6.1 在项目中添加 Notification Service Extension

首先我们需要创建一个Service Extension服务,如下:

填写Target信息时需要注意以下两点:

  • Extension 的 Bundle Identifier 不能和 Main Target(也就是你自己的 App Target)的 Bundle Identifier 相同,否则会报 BundeID 重复的错误。

  • Extension 的 Bundle Identifier 需要在 Main Target 的命名空间下,比如说 Main Target 的 BundleID 为 com.mob.xxx,那么Extension的BundleID应该类似与com.mob.xxx.yyy这样的格式。如果不这么做,会引起命名错误。

Notification Service Extension 添加成功后会在项目中自动生成 NotificationService.hNotificationService.m 两个类,包含以下两个方法:

我们可以在这个方法中处理我们的 APNs 通知,并个性化展示给用户。APNs 推送的消息送达时会调用这个方法,此时你可以对推送的内容进行处理,然后使用contentHandler方法结束这次处理。但是如果处理时间过长,将会进入serviceExtensionTimeWillExpire方法进行最后的紧急处理。

如果didReceiveNotificationRequest方法在限定时间内没有调用 contentHandler方法结束处理,则会在过期之前进行回调本方法。此时你可以对你的 APNs 消息进行紧急处理后展示,如果没有处理,则显示原始 APNs 推送。

6.2  Notification Service Extension Target相关设置

1)添加 MobPushServiceExtension 依赖库

2)设置 Notification Service 最低运行版本为 10.0:

3)开启富媒体地址Http访问支持

6.3 使用 MobPushServiceExtension 进行富媒体推送

NotificationService.m 文件中,导入 MobPushServiceExtension 的头文件:

1)进入MobPush开发者后台通过url(带有后缀格式的文件地址)或者文件的方式发送富媒体通知。(必须勾选mutable-content选项)

2) 调用handelNotificationServiceRequestUrl方法。接收到 APNs 通知后,SDK 判断是否有富媒体资源request.content.userInfo[@“attachment”],如果富媒体资源存在则SDK下载资源,下载完成后以 Block 方式回调返回 attachments 资源数组对象和error错误信息。示例代码如下:

3).多媒体大小限制:

 

具体应用可以参考 demo

相关文档