Messaging模块管理设备通讯功能，可用于短信、彩信、邮件发送等。通过plus.messaging ...

常量：

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

方法：

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

对象：

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

回调方法：

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

权限：

5+功能模块（permissions）

TYPE_SMS

简单短信类型常量

说明：

Number 类型

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

平台支持

• Android - 2.2+ (支持) :

  支持

• iOS - 4.3+ (支持) :

  支持

TYPE_MMS

彩信类型常量

说明：

Number 类型

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

平台支持

• Android - 2.2+ (支持) :

  支持

• iOS - 4.3+ (不支持) :

  不支持彩信的发送

TYPE_EMAIL

邮件类型常量

说明：

Number 类型

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

平台支持

• Android - 2.2+ (支持) :

  支持

• iOS - 4.3+ (支持) :

  支持

createMessage

创建消息对象

说明：

创建指定类型的消息，消息类型可取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 : Message对象

平台支持：

• Android - 2.2+ (支持) :

  支持

• iOS - 4.3+ (支持) :

  支持

示例：

uni-app使用plus注意事项

sendMessage

发送消息

说明：

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

参数：

• msg: ( Message ) 必选 要发送的消息对象

• successCB: ( MessageSendSuccessCallback ) 可选 消息发送成功回调函数

• errorCB: ( MessageErrorCallback ) 可选 消息发送失败回调函数

返回值：

void : 无

平台支持：

• Android - 2.2+ (支持) :

  支持

• iOS - 4.3+ (支持) :

  支持

示例：

uni-app使用plus注意事项

Message

消息对象

属性：

• to: 收件人信息
• cc: 抄送人信息
• bcc: 暗送人信息
• from: 发件人信息
• subject: 发送消息主题
• body: 发送消息内容
• bodyType: 发送消息内容类型
• silent: 是否采用静默方式发送消息

方法：

• addAttachment: 添加附件

to

收件人信息

说明：

Array[String] 类型 可选属性

字符串数组类型，输入的地址收件人信息必须符合消息类型格式。

cc

抄送人信息

说明：

Array[String] 类型 可选属性

字符串数组类型，仅发送邮件时有效，输入的地址收件人信息必须符合消息类型格式。

bcc

暗送人信息

说明：

Array[String] 类型 可选属性

字符串数组类型，仅发送邮件时有效，输入的地址收件人信息必须符合消息类型格式。

from

发件人信息

说明：

String 类型 可选属性

仅在监听接收到的信息时有效。

subject

发送消息主题

说明：

String 类型 可选属性

字符串类型，仅发送邮件时有效。

body

发送消息内容

说明：

String 类型 可选属性

字符串类型，要发送的消息体内容，其格式必须与bodyType指定的一致。

bodyType

发送消息内容类型

说明：

BodyType 类型 可选属性

要发送消息体内容的类型，可取值"text"表示文本内容，"html"表示为html页面，默认值为"text"。

平台支持：

• iOS - 4.3+ (支持) :

  支持指定消息体内容类型，可支持html和text模式。

• Android - 2.2+ (不支持) :

  不支持指定消息体内容类型，仅支持text模式。

示例：

uni-app使用plus注意事项

silent

是否采用静默方式发送消息

说明：

Boolean 类型 可选属性

布尔类型，可取值为true或false，true表示静默方式发送，不弹出界面；false表示非静默方式发送。默认采用非静默方式。

平台支持：

• iOS - 4.3+ (不支持) :

  不支持静默方式发送消息，将忽略此属性值。

• Android - 2.2+ (支持) :

  支持静默方式发送短信（彩信和邮件不支持），发送成功后不会保留在系统的已发送信箱中，默认采用非静默方式发送消息。

示例：

uni-app使用plus注意事项

addAttachment

添加附件

说明：

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

参数：

• url: ( String ) 必选 要添加的附件资源地址

  附件资源必须是本地文件，支持相对路径及本地文件相对路径格式。

返回值：

void : 无

示例：

uni-app使用plus注意事项

BodyType

消息体内容类型

说明：

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

MessageSendSuccessCallback

消息发送成功的回调函数

参数：

无

返回值：

void : 无

MessageErrorCallback

消息发送失败的回调函数

参数：

• error: ( Exception ) 必选 失败信息

返回值：

void : 无