极光推送是为 App 提供第三方推送服务的平台之一,它提供四种消息形式:

  • 通知
  • 自定义消息
  • 富媒体
  • 本地通知

1.通知

  • Push Notification,即指在手机的通知栏(状态栏)上会显示的一条通知信息。 
  • Android:依靠 JPush service ,由 JPush SDK 实现在手机通知栏的展示。

Android 通知消息的流程:
我们可以调用极光的 API 发起推送请求,也可以通过极光官网控制台推送。
请求在参数要求上基本正确——请求成功,返回 msgid (这条消息的 ID 标识),返回 200(成功)或由极光判断的推送失败,一般是 1011 找不到目标的错误,参数错误有返回错误码,可对应查看。

极光服务器处理该请求: 

  • 若该 App 长连接正常,极光服务器就会把这条消息在线下发给它。
  • 如果长连接是断开的,那么就会免费保存 5 条离线消息。 
  • 如果该 App 在你推送消息时设定的离线保存时间(time_to_live) 时间内,重连上了长连接,该条消息就会下发给 App 。
  • 如果离线时间内,推送的消息超过5条,最先保存的消息会被删掉。
  • 如果过了time_to_live,该条消息也会被删掉,没有收到的 App 就不会再收到了。

涉及到长连接断开的问题: 

  • RTC 会定时发送心跳去触发连接。
  • 断网,关机,进程不在(被杀死),主动调用 stoppush 都会导致断开。
  • 一些手机系统的限制会导致断网和进程不在。

解决办法:

  • 添加极光提供的拉起服务
  • 文档提示用户对 App 进行保护

Android 收不到消息的情况,极光社区也有一个总结说明。
App 收到了通知,由 JPush SDK 进行展示,和 iOS 一样,如果通知内容( alert )为空,也是默认不展示的, 但能获取到消息中的数据,以作他用。 
我们可以简单的修改这个通知栏的样式。在客户端定制了通知栏样式后,需要使用该通知栏时,在推送的时候就 记得要写对应的通知栏编号。

Android 关闭通知: 

可以达到关闭通知效果的有两个办法,我们可以根据自己的需求去选用,如果在 UI 层面加一个关闭的按钮,那么对应的代码层面也是去选用这两种 API 。 
调用 stoppush : 一种本地的状态操作,相当于手动终止 push 服务的效果,这个会导致同时关掉对所有类型消息的接收。
极光推送所有的其他 API 调用都无效。必须调用 resumepush 才能恢复推送服务。恢复后,如果推送的消息还在time_to_live内,客户端会收到这条消息。

别名/标签:

需要注意,别名置空至重设别名期间,推送的消息, 在重设别名后,设备不会收到。 若需要这期间的消息也被收到,需要自己服务器对此进行判断、保存、并在客户端重设别名后,重新向极光发起推送请求。 若需要用户的历史推送消息可被查询,需要自己服务器那边去保存。

2.自定义消息

Android 不需要处于前台,其他特点:

  1. 只接收,不展示,需要我们自己做接收处理,并且自己代码实现 消息的展示。
  2. 自定义消息内容msg_content为空时,SDK 不会对消息进行广播,App 无法接收到推送的消息。
  3. 需要依靠 App 与极光服务器建立的长连接。

Android 需要我们在AndroidManifest.xml里配置Action - cn.jpush.android.intent.MESSAGE_RECEIVED,并且在自己写的BroadcastReceiver里接收处理,详细看官方文档说明。
什么时候使用它?
主要用于应用的内部业务逻辑和特殊展示需求,譬如: 

  1. 需要自定义通知栏时(Android 要播放自定义的声音文件等情况)。 
  2. 在 App 项目内的消息提醒。 
  3. 有条件的消息提醒(譬如只让处在某一页面的用户看到该条消息)。

注意问题:

  • 弄混自定义内容(字段 extras)与自定义消息(Message) 
  • 一般会出现的疑问是: Android 点击通知栏无法获取到自定义的内容 
  • 推送时 extras 是写在 Notification 下还是 Message 下? 
  • 点击 SDK 的通知栏 用JPushInterface.EXTRA_EXTRA获取的是写在 Notification 下的 extras 信息,没法获取写在 Message 下的 extras。 
  • Message 消息和 Notification 消息 分别有各自的参数,不要混用。

3.富媒体

可以推送 Web页面、图片、声音等除普通文本之外更丰富的内容。

  • 信息流模板推送
  • URL富媒体链接推送 

信息流模板推送 

  1. 推送 Web 页面(富文本);
  2. 极光官网控制台上有创建富文本页面的功能模块,提供了5种模板;
  3. 富文本作为通知推送到客户端;
  4. 客户端点击通知,自动展示该富文本页面。

URL 富媒体链接推送 

  1. 推送某个页面的 URL ,点击通知栏消息后跳转到这个 URL 指定的页面。
  2. 仅支持 Android ,需要JPush Android SDK 1.8.0 及以上。
  3. 只能通过极光推送的控制台发送。

必须将压缩包 res 中的资源放到我们自己的项目的对应文件夹,并按照官方示例 AndroidManifest配置 PushActivity 组件。

4.本地通知

适用于在特定时间发出的通知,如一些Todo和闹钟类的应用,在每周、每月固定时间提醒用户回到应用查看任务

特点:

  • 不依赖于网络,无网也可以触发。
  • 定时时间是自发送时算起,不受中间关机等操作的影响。
  • 本地通知与远程推送的通知是相互独立的,不受 保留最近通知条数上限(Android)的限制。
  • Android 依旧需要 App 应用程序在运行。

规则:

  • 本地推送保存在本地的 db 中,时间上的控制也是从 db 里面取。
  • 关机或者杀进程后将收不到本地通知。
  • 进程重启后,会检测 db ,准备设定时间在此之后的本地通知的推送。
  • 本地通知的时间也依赖于每4分50秒的心跳来检测,所以会有一定偏差。