Push
Push模块管理推送消息功能，可以实现在线、离线的消息推送，通过plus.push可获取推送消息管理对象。
方法：
- addEventListener添加推送消息事件监听器
- clear清空所有推送消息
- createMessage创建本地消息
- getAllMessage获取所有推送消息
- getClientInfo获取客户端推送标识信息
- setAutoNotification设置客户端是否显示离线推送消息
- remove删除推送消息
对象：
- ClientInfoJSON对象，获取的客户端标识信息
- PushMessageJSON对象，推送消息对象
- MessageOptionJSON对象，获客户端创建本地消息的参数
回调方法：
- PushReceiveCallback客户端接收到推动消息的回调函数
- PushClickCallback用户点击推送消息事件的回调函数
addEventListener
添加推送消息事件监听器
void plus.push.addEventListener( event, listener, Boolean );
说明：
添加推送消息事件监听器，当指定推送事件发出时触发。
参数：
- type (DOMString) 可选 事件类型
- listener (PushReceiveCallback) 可选 事件监听器回调函数，在接收到推送消息时调用
- capture (Boolean) 可选 是否捕获事件，此处可忽略
返回值：
无
平台支持：
Android : 2.2+
iOS : 4.3+
支持，只有在客户端在运行时收到推送消息才能触发receive事件，离线接收到的推送消息全部进入系统消息中心。
WP : 不支持
示例：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Push Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 添加监听从消息中心点击某条消息启动应用事件
plus.push.addEventListener( "click", function ( msg ) {
// 分析msg.payload处理业务逻辑
alert( "You clicked: " + msg.content );
}, false );
}, false );
</script>
</head>
<body>
</body>
</html>
clear
清空所有推送消息
void plus.push.clear();
说明：
清空系统消息中心中所有的推送消息。
返回值：
无
createMessage
创建本地消息
void plus.push.createMessage( content, payload, option );
说明：
在本地直接创建推送消息，并添加到系统消息中心。
参数：
- content (DOMString) 可选 消息显示的内容，在系统通知中心中显示的文本内容。
- payload (DOMString) 可选 消息承载的数据，可根据业务逻辑自定义数据格式。
- option (MessageOption) 可选 创建消息的额外参数，参考MessageOption。
返回值：
无
平台支持：
Android : 2.2+
iOS : 4.3+
WP : 不支持
getAllMessage
获取所有推送消息
PushMessage[] plus.push.getAllMessage();
说明：
获取客户端接收到的所有推送消息。仅包括在系统消息中心中显示的推送消息，不包括调用setAutoNotification(false)方法设置不显示推送消息后接收到的消息。
返回值：
Array[PushMessage]对象，推送消息PushMessage数组。
平台支持：
Android : 2.2+
iOS : 不支持 无法获取系统消息中心中的消息列表，调用此方法将返回空数组。
WP : 不支持
getClientInfo
获取客户端推送标识信息
ClientInfo plus.push.getClientInfo();
说明：
客户端标识信息用于业务服务器下发推送消息时提交给推送服务器的数据，用于说明下发推送消息的接收者（客户端）。需要客户端在第一次运行时提交到业务服务器保存。
返回值：
客户端推送标识信息对象
示例：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Push Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 获取客户端标识信息
var info = plus.push.getClientInfo();
alert( JSON.stringify( info ) );
// 添加监听从消息中心启动事件
plus.push.addEventListener( "click", function ( msg ) {
// 分析msg.payload处理业务逻辑
alert( "You clicked: " + msg.content );
}, false );
}, false );
</script>
</head>
<body>
</body>
</html>
setAutoNotification
设置客户端是否显示离线推送消息
void plus.push.setAutoNotification( notify );
说明：
默认情况下客户端在接收到推送消息后将会在系统消息中心中显示，通过此方法可关闭默认行为，接收到推送消息后不在消息中心中显示，通过addEventListener方法的“receive”事件监听处理接收到的消息。可通过createMessage方法创建在消息中心中显示的消息。
参数：
- notify (Boolean) 可选 可取值true或false，true表示自动显示推送消息，false则不显示。默认值为true。
返回值：
无
平台支持：
Android : 2.2+
iOS : 4.3+
仅在客户端在前台运行时设置的值生效。
WP : 不支持
示例：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
<title>Push Example</title>
<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
// 扩展API加载完毕，现在可以正常调用扩展API
// 在程序运行时接收到的消息不显示在系统消息中心
plus.push.setAutoNotification( false );
}, false );
</script>
</head>
<body>
</body>
</html>
remove
删除推送消息
void plus.push.remove( message )
说明：
删除系统消息中心中指定的推送消息。可通过getAllMessage方法获取所有的消息
参数：
- message (PushMessage) 可选 要删除的消息对象，可通过getAllMessage()方法来获取消息。
返回值：
无
平台支持：
Android : 2.2+
iOS : 不支持 无法对单条消息进行删除操作，可调用clear()方法清空所有消息。
WP : 不支持
ClientInfo
JSON对象，获取的客户端标识信息
属性：
- token：DOMString，设备令牌（iOS设备唯一标识），用于APNS服务推送中标识设备的身份
- clientid：DOMString，第三方推送服务器管理的设备唯一标识，在iOS平台此值通常与token不同；在其它平台此值通常与token值一致。
- appid：DOMString，第三方推送服务器管理的应用标识，通常需要在第三方推送服务器平台进行注册获取。
- appkey：DOMString，第三方推送服务器管理的应用键值，通常需要在第三方推送服务器平台进行注册获取。
PushMessage
JSON对象，推送消息对象
属性：
- title：DOMString，推送消息显示的标题
- content：DOMString，推送消息显示的内容
- payload：JSON，如果推送消息中传输的数据不符合JSON格式，则作为String类型数据保存。
- aps：JSON，Apple APNS推送协议数据
MessageOption
JSON对象，获客户端创建本地消息的参数
属性：
- title：DOMString，在系统消息中心显示，默认值为程序的名称。若不支持此属性，在系统通知中心显示的标题固定为程序的名称
- cover：Boolean，可取值true或false，true为覆盖，false不覆盖，默认为permission中设置的cover值。
- when：Date，默认为当前时间，如果使用的延迟显示则默认使用延时后的时间。
- delay：Number，当设备接收到推送消息后，可不立即显示，而是延迟一段时间显示，延迟时间单位为s，默认为0s，立即显示。
PushReceiveCallback
客户端接收到推动消息的回调函数
void onReceive( msg ) {
// Recieved push message code.
}
说明：
客户端接收到推动消息的回调函数
参数：
- msg (DOMString) 必选 接收到的推送信息msg
PushClickCallback
用户点击推送消息事件的回调函数
void onClick( msg ) {
// Clicked push message code.
}
说明：
用户点击推送消息事件的回调函数
参数：
- msg (DOMString) 必选 用户点击的推送信息msg
关键词: html5puls,Push 编辑时间: 2015-03-23 23:21:01
0
高兴
0
支持
0
搞笑
0
不解
0
谎言
0
枪稿
0
震惊
0
无奈
0
无聊
0
反对
0
愤怒
中搜索：
中搜索：
- 暂无评论
文章图片 article Pictrue
网友评论