您当前位置：首页 > 文章中心 > HTML5+CSS3 > HTML5puls

【HTML5puls】

下载

新闻

文章

Messaging模块管理设备通讯功能，可用于短信、彩信、邮件发送等。通过plus.messaging可获取设备通讯管理对象。另外也可以直接通过html中的href直接快速发送短信、拨打电话、发送邮件等。

常量：

TYPE_SMS简单短信类型常量
TYPE_MMS彩信类型常量
TYPE_EMAIL邮件类型常量

方法：

createMessage创建消息对象
sendMessage发送消息

对象：

Message消息对象
BodyType消息体内容类型

回调方法：

MessageSendSuccessCallback消息发送成功的回调函数
MessageErrorCallback消息发送失败的回调函数

createMessage

创建消息对象

Message plus.messaging.createMessage( type );

说明：

创建指定类型的消息，消息类型可取plus.messaging.TYPE_SMS、plus.messaging.TYPE_MMS、plus.messaging.TYPE_EMAIL。

参数：

type(Number) 可选要创建的消息类型常量，可取plus.messaging.TYPE_SMS、plus.messaging.TYPE_MMS、plus.messaging.TYPE_EMAIL。

返回值：

Message对象

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Messaging Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
}
//短信
function smsTest(){
	var msg = plus.messaging.createMessage(plus.messaging.TYPE_SMS);
	msg.to = ['18611497504', '15811140520'];
	msg.body = 'This is Pandora example test message';
	plus.messaging.sendMessage( msg );
}
	</script>
	</head>
	<body>
		<input type='button' onclick='smsTest();' value='sms'/>
	</body>
</html>

sendMessage

发送消息

void plus.messaging.sendMessage( msg, successCB, errorCB );

说明：

发送消息，发送成功回调successCB函数，发送失败回调errorCB函数。

参数：

msg (Message) 可选 要发送的消息对象
successCB (MessageSendSuccessCallback) 可选 消息发送成功回调函数
errorCB (MessageErrorCallback) 可选 消息发送失败回调函数

返回值：

无

示例：

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Messaging Example</title>
	<script type="text/javascript">
// 扩展API加载完毕后调用onPlusReady回调函数 
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕，现在可以正常调用扩展API
function onPlusReady() {
}
//邮件
function mailTest(){
	var msg = plus.messaging.createMessage(plus.messaging.TYPE_EMAIL);
	msg.to = ['test_163.com', 'test_173.com'];
	msg.cc = ['test_163.com', 'test_173.com'];
	msg.bcc = ['test_163.com', 'test_173.com'];
	msg.subject = '测试邮件';
	msg.body = 'This is Pandora example test message';
	plus.messaging.sendMessage( msg, function () {
		alert( "Send success!" );
	}, function () {
		alert( "Send failed!" );
	} );
}
	</script>
	</head>
	<body>
		<input type='button' onclick='mailTest();' value='Send Mail'/>
	</body>
</html>

TYPE_SMS

简单短信类型常量

plus.messaging.TYPE_SMS;

说明：

消息类型常量，Number类型，固定值为1，用于创建并发送短信。

TYPE_MMS

彩信类型常量

plus.messaging.TYPE_MMS;

说明：

消息类型常量，Number类型，固定值为2，用于创建并发送多媒体短信（彩信）。

TYPE_EMAIL

邮件类型常量

plus.messaging.TYPE_EMAIL;

说明：

消息类型常量，Number类型，固定值为3，用于创建并发送邮件。

Message

消息对象

方法：

addAttachment添加附件

属性：

to：DOMString[]，字符串数组类型，输入的地址收件人信息必须符合消息类型格式。
cc：DOMString[]，字符串数组类型，仅发送邮件时有效，输入的地址收件人信息必须符合消息类型格式。
bcc：DOMString[]，字符串数组类型，仅发送邮件时有效，输入的地址收件人信息必须符合消息类型格式。
subject：DOMString，字符串类型，仅发送邮件时有效。
body：DOMString，字符串类型，要发送的消息体内容，其格式必须与bodyType指定的一致。
bodyType：BodyType，要发送消息体内容的类型，可取值"text"表示文本内容，"html"表示为html页面，默认值为"text"。
silent：Boolean，布尔类型，可取值为true或false，true表示静默方式发送，不弹出界面；false表示非静默方式发送。默认采用非静默方式。

addAttachment

添加附件

msg.addAttachment( url );

说明：

向消息中添加附件，仅邮件类型消息支持，其它类型消息不支持。

参数：

url (DOMString) 可选 要添加的附件资源地址

返回值：

无

示例：

<!DOCTYPE html>
<html>
<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>Messaging Example</title>
	<script type="text/javascript">
// 监听plusready事件 
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
},false);
// send mail
function mailTest(){
	var msg = plus.messaging.createMessage(plus.messaging.TYPE_MAIL);
	msg.to = ['service_dcloud.io'];
	msg.body = 'This is an example mail';
	msg.addAttachment("_www/a.doc");
	plus.messaging.sendMessage( msg );
}
	</script>
	</head>
	<body>
		<input type='button' onclick='mailTest();' value='Mail'/>
	</body>
</html>

BodyType

消息体内容类型

说明：

用于设定消息的消息体内容。

属性：

"text/plain"：DOMString，纯文本类型消息体内容，默认消息体内容类型。
"text/html"：DOMString，网页数据类型消息体内容，可用于发送邮件。

MessageSendSuccessCallback

消息发送成功的回调函数

void onSuccess() {
	// Send message success code.
}

说明：

消息发送成功的回调函数

MessageErrorCallback

消息发送失败的回调函数

void onError( error ) {
	// Error code.
}

说明：

消息发送失败的回调函数

参数：

error (DOMException) 可选 失败信息

关键词: html5puls,Messaging 编辑时间: 2015-03-23 23:18:06

0
高兴
0
支持
0
搞笑
0
不解
0
谎言
0
枪稿
0
震惊
0
无奈
0
无聊
0
反对
0
愤怒

0%(0)

中搜索：Messaging
中搜索：Messaging

共有0 条评论发言请遵守【相关规定】

网友评论

发表同步腾讯微博验证码：点击更新

请先登陆

暂无评论

文章图片 article Pictrue