Push

稿件来源: 互联网   撰稿作者: 匿名   发表日期: 2015-03-23   阅读次数: 37   查看权限: 游客查看

Push模块管理推送消息功能,可以实现在线、离线的消息推送,通过plus.push可获取推送消息管理对象。

方法:

对象:

回调方法:

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

    愤怒
0%(0)
0%(0)
上一篇:Payment
下一篇:Runtime
共有0 条评论 发言请遵守【相关规定

网友评论

会员头像
发 表同步腾讯微博    验证码:  点击更新请先登陆
  • 暂无评论
关闭模块文章图片 article Pictrue
  • 我的妈妈爸爸
  • 基于koa2+mysql+vue2.0+Element阳光内容管理系统
  • 代码覆盖率工具 Istanbul 入门教程
  • 全栈工程师的武器——MEAN
  • 9款超炫的 CSS3 复选框(Checkbox)
  • 微信开发在线翻译功能
  • CSS3那些不为人知的高级属性
  • 给easyui的datebox添加清空事件
  • flash写字效果
  • kendoUI系列教程之DropDownList下拉菜单
  • kendoUI系列教程之datetimepicker日期时间选择
  • kendoUI系列教程之datepicker日期选择
  • kendoUI系列教程之combobox下拉列表框
  • kendoUI系列教程之colorpicker
  • kendoUI系列教程之calendar日历表
  • kendoUI系列教程之autocomplete自动补齐