JPush相关概念

连接极光服务器前提

在连接极光服务器之前需要先将APP进行注册&＃xff0c;连接Server时需要用到下发的两个字段&＃xff1a;
AppKey&＃xff1a;应用唯一标识。
Master Secret&＃xff1a;服务器秘钥&＃xff0c;用于服务器端调用API请求时对发送内容做签名。客户端调用时传输这两个字段进行验证
HTTP Header(头)里加一个字段(Key/Value对)&＃xff1a; Authorization: Basic base64authstring 其中 base64authstring 的生成算法为&＃xff1a;base64(appKey:masterSecret) 即&＃xff0c;对 appKey 加上冒号&＃xff0c;加上 masterSecret 拼装起来的字符串&＃xff0c;再做 base64 转换。

消息形式

JPush提供四种消息形式&＃xff1a;通知&＃xff0c;自定义消息&＃xff0c;富媒体和本地通知。通知
或者说 Push Notification&＃xff0c;即指在手机的通知栏(状态栏)上会显示的一条通知信息。 通知主要用于提示用户的目的&＃xff0c;应用于新闻内容、促销活动、产品信息、版本更新提醒、订单状态提醒等多种场景 自定义消息
自定义消息不是通知&＃xff0c;所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。 自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来&＃xff0c;有可能没有任何界面显示。富媒体
JPush支持开发者发送图文并茂的通知&＃xff0c;从而更好的传达信息&＃xff0c;带来更丰富的用户互动。 JPush提供了5种模板&＃xff0c;开发者可以通过填充模板的内容&＃xff0c;发送landing page、弹窗、信息流形式的富媒体通知。 开发者还可以直接通过URL发送预先编辑好的页面。 富媒体当前支持Android平台&＃xff0c;为更好的使用富媒体的功能&＃xff0c;建议更新当前SDK版本至v2.1.8及以上。 暂时只能通过极光推送的控制台发送&＃xff0c;不支持API形式。本地通知
本地通知API不依赖于网络&＃xff0c;无网条件下依旧可以触发&＃xff1b;本地通知的定时时间是自发送时算起的&＃xff0c;不受中间关机等操作的影响。 本地通知与网络推送的通知是相互独立的&＃xff0c;不受保留最近通知条数上限的限制。 本地通知适用于在特定时间发出的通知&＃xff0c;如一些Todo和闹钟类的应用&＃xff0c;在每周、每月固定时间提醒用户回到应用查看任务。

名词解释

设备标识 Registration ID
集成了 JPush SDK 的应用程序在第一次 App 启动后&＃xff0c;成功注册到 JPush 服务器时&＃xff0c;JPush 服务器会给客户端返回唯一的该设备的标识 – RegistrationID。JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。 有了这个标识&＃xff0c;App 编程可以把这个 RegistrationID 保存到自己的应用服务器上&＃xff0c;然后就可以根据 RegistrationID 来向设备推送消息或者通知。 RegistrationID在卸载重装后是否可变&＃xff1a;http://blog.jiguang.cn/registrationid/

别名 alias
为安装了应用程序的用户&＃xff0c;取个别名来标识。以后给该用户 Push 消息时&＃xff0c;就可以用此别名来指定。每个用户只能指定一个别名。 同一个应用程序内&＃xff0c;对不同的用户&＃xff0c;建议取不同的别名。这样&＃xff0c;尽可能根据别名来唯一确定用户。 系统不限定一个别名只能指定一个用户。如果一个别名被指定到了多个用户&＃xff0c;当给指定这个别名发消息时&＃xff0c;服务器端API会同时给这多个用户发送消息。 举例&＃xff1a;在一个用户要登录的游戏中&＃xff0c;可能设置别名为 userid。游戏运营时&＃xff0c;发现该用户 3 天没有玩游戏了&＃xff0c;则根据 userid 调用服务器端API发通知到客户端提醒用户。标签 tag
为安装了应用程序的用户&＃xff0c;打上标签。其目的主要是方便开发者根据标签&＃xff0c;来批量下发 Push 消息。 可为每个用户打多个标签。 举例&＃xff1a; game, old_page, women用户分群
用户分群的筛选条件有&＃xff1a;标签、地理位置、系统版本、注册时间、活跃用户和在线用户。 开发者可以通过在控制台(官网)设置好用户分群之后&＃xff0c;在控制台推送时指定该分群的名称或使用API调用该分群的id发送。 比如&＃xff0c;开发者可以设置这样的用户分群&＃xff1a;位于北京、上海、广州和深圳&＃xff0c;并且最近7天在线的用户。

推送对象

一个推送对象&＃xff0c;以 JSON 格式表达&＃xff0c;表示一条推送相关的所有信息。
关键字 选项 含义 platform 必填 推送平台设置 audience 必填 推送设备指定 notification 可选 通知内容体。是被推送到客户端的内容。与 message 一起二者必须有其一&＃xff0c;可以二者并存 message 可选 消息内容体。是被推送到客户端的内容。与 notification 一起二者必须有其一&＃xff0c;可以二者并存 sms_message 可选 短信渠道补充送达内容体 options 可选 推送参数 cid 可选 用于防止 api 调用端重试造成服务端的重复推送而定义的一个标识符。

示例与说明

platform

JPush 当前支持 Android, iOS, Windows Phone 三个平台的推送。其关键字分别为&＃xff1a;"android", "ios", "winphone"。
推送到所有平台&＃xff1a;
{ "platform" : "all" }
指定特定推送平台&＃xff1a;
{ "platform" : ["android", "ios"] }

audience

推送设备对象&＃xff0c;表示一条推送可以被推送到哪些设备列表。确认推送设备对象&＃xff0c;JPush 提供了多种方式&＃xff0c;比如&＃xff1a;别名、标签、注册ID、分群、广播等。
all 如果要发广播(全部设备)&＃xff0c;则直接填写 “all”。

单播(unicast) 向指定的设备发送消息&＃xff0c;包括向单个devicetoken或者单个alias发消息。列播(listcast) 向指定的一批设备发送消息&＃xff0c;包括向多个devicetoken或者多个alias发消息。广播(broadcast) 向安装该App的所有设备发送消息(对 app_key 下的所有用户推送消息。)

推送目标(即设备)

广播外的设备选择方式&＃xff0c;有如下几种&＃xff1a;

示例

推送给全部(广播)&＃xff1a;

推送给多个标签(只要在任何一个标签范围内都满足)&＃xff1a;在深圳、广州、或者北京

推送给多个标签(需要同时在多个标签范围内)&＃xff1a;在深圳并且是“女”

推送给多个别名&＃xff1a;

推送给多个注册ID&＃xff1a;

可同时推送指定多类推送目标&＃xff1a;在深圳或者广州&＃xff0c;并且是 “女” “会员”

notification

推送实体内容对象&＃61;通知(notification)&＃43;消息(message)
notification对象&＃xff1a;下属属性包含 4 种(alert&＃43;3个平台属性)
alert
通知的内容在各个平台上&＃xff0c;都可能只有这一个最基本的属性 "alert"。
这个位置的 "alert" 属性(直接在 notification 对象下)&＃xff0c;是一个快捷定义&＃xff0c;各平台的 alert 信息如果都一样&＃xff0c;则可不定义。如果各平台有定义&＃xff0c;则覆盖这里的定义。

上面定义的 notification 对象&＃xff0c;将被推送到 "platform" 指定的多个平台&＃xff0c;并且其通知 alert 信息都一样。

android Android 平台上的通知&＃xff0c;JPush SDK 按照一定的通知栏样式展示。

iOS iOS 平台上 APNs 通知结构。该通知内容会由 JPush 代理发往 Apple APNs 服务器&＃xff0c;并在 iOS 设备上在系统通知的方式呈现。 该通知内容满足 APNs 的规范&＃xff0c;支持的字段如下&＃xff1a;

iOS 通知 JPush 要转发给 APNs 服务器。APNs 协议定义通知长度为 2048 字节。

JPush 因为需要重新组包&＃xff0c;并且考虑一点安全冗余&＃xff0c;要求"iOS":{ } 及大括号内的总体长度不超过&＃xff1a;2000 个字节。JPush 使用 utf-8 编码&＃xff0c;所以一个汉字占用 3 个字节长度。

服务端发送消息串&＃xff1a;

客户端收到apns&＃xff1a;

winphone
Windows Phone 平台上的通知。该通知由 JPush 服务器代理向微软的 MPNs 服务器发送&＃xff0c;并在 Windows Phone 客户端的系统通知栏上展示。

该通知满足 MPNs 的相关规范。当前 JPush 仅支持 toast 类型&＃xff1a;

message

message&＃xff1a;自定义消息
应用内消息。或者称作&＃xff1a;自定义消息&＃xff0c;透传消息。 此部分内容不会展示到通知栏上&＃xff0c;JPush SDK 收到消息内容后透传给 App。需要 App 自行处理。 iOS 平台上&＃xff0c;此部分内容在推送应用内消息通道(非APNS)获取。Windows Phone 暂时不支持应用内消息。

sms_message

用于设置短信推送内容以及短信发送的延迟时间。手机接收号码,开发者需要先把用户的手机号码与设备的registration id匹配。

options

cid

cid 是用于防止 api 调用端重试造成服务端的重复推送而定义的一个推送参数。 用户使用一个 cid 推送后&＃xff0c;再次使用相同的 cid 进行推送&＃xff0c;则会直接返回第一次成功推送的结果&＃xff0c;不会再次进行推送。 CID的有效期为1天。CID的格式为&＃xff1a;{appkey}-{uuid} 在使用cid之前&＃xff0c;必须通过接口获取你的 cid 池。获取时type&＃61;push或者不传递type值。