短讯服务信息SmsMessage

内部类Nested Classes

enum

SmsMessage.MessageClass

短信服务类枚举

class

SmsMessage.SubmitPdu

常量Constants

int

ENCODING_16BIT

int

ENCODING_7BIT

int

ENCODING_8BIT

int

ENCODING_UNKNOWN

用户数据文本编码编程单元大小

int

MAX_USER_DATA_BYTES

用户每条信息最大输入字符数量

int

MAX_USER_DATA_BYTES_WITH_HEADER

包含用户数据头每条信息信息体最大字符数量

int

MAX_USER_DATA_SEPTETS

每条信息按7位字节算最大输入字符数量

int

MAX_USER_DATA_SEPTETS_WITH_HEADER

包含用户数据头每条信息信息体按7位字节算最大输入字符数量

公共方法Public Methods

Static int[]

calculateLength(CharSequence msgBody,boolean use7bitOnly)

计算短信服务所需要的信息体编码后的长度和剩余的字符长度直到下一条消息

参数

msgBody 被编码的信息

use7bitOnly 如果为真，则字符串被当作7－bit位计算。如果为假，信息体用的是非7－bit方式编码，信息长度将被用16－bit来计算。

返回值

int[4]内容如下：

int[0]为短信所需的长度

int[1]每个单元字符所使用的长度

int[2]直到下一个message剩余的长度

int[3]编码单元大小的指标

Static int[]

calculateLength(String msgBody,boolean use7bitOnly)

计算短信服务所需要的信息体编码后的长度和剩余的字符长度直到下一条消息

参数

msgBody 被编码的信息

use7bitOnly 如果为真，则字符串被当作7－bit位计算。如果为假，信息体用的是非7－bit方式编码，信息长度将被用16－bit来计算。

返回值

int[4]内容如下：

int[0]为短信所需的长度

int[1]每个单元字符所使用的长度

int[2]直到下一个message剩余的长度

int[3]编码单元大小的指标

Static SmsMessage

createFromPdu(byte[] pdu)

从原始的pdu创建一个SmsMessage

String

getDisplayMessageBody()

返回信息体，如果信息是从email网关获得的则返回email信息体。如果信息体无法获取则返回null

String

getDisplayOriginatingAddress()

返回发信人地址，如果是email获取的message则返回email地址。如果地址无法获取则返回null

String

getEmailBody()

如果判断是email则信息通过网关发出

String

getEmailFrom()

判断如果是email获取email发信人地址

Int

getIndexOnIcc()

返回集成电路卡（估计就是sim卡）上信息记录的索引（从1开始计数），如果该条SmsMessage不是ICC SMS EF 记录则返回－1

Int

getIndexOnSim()

该方法被舍弃，建议使用getIndexOnIcc()

String

getMessageBody()

如果该条信息存在并且是文本类型的则返回该条信息体Message Body as String

SmsMessage.MessageClass

getMessageClass()

返回Message这个类

String

getOriginatingAddress()

返回当前信息的发送人地址，如果不可用返回null

byte[]

getPdu()

通过当前message返回原始pdu

Int

getProtocolIdentifier()

获取协议标识符

String

getPseudoSubject()

获取非正式约定的主题，如果没有返回空字符串

String

getServiceCenterAddress()

返回当前短讯息所使用的短讯服务中心号码，如果没有返回null

Int

getStatus()

GSM:从状态报告中获取状态字段并返回。这个字段表面了之前提交的短讯状态。详见TS 23.040,9.2.3.15 TP-Status 状态描述

CDMA:为了不和GSM的状态代码互相干扰，数值转移到31－16位。数值由一个25－24位的错误类和23－16位的状态代码组成。可以通过C

.S0015-B,v2.0,4.5.21描述

Int

getStatusOnIcc()

返回ICC（估计是sim卡类似）上该条message状态。有以下几类：

SmsManager.STATUS_ON_ICC_FREE

SmsManager.STATUS_ON_ICC_READ

SmsManager.STATUS_ON_ICC_UNREAD

SmsManager.STATUS_ON_ICC_SEND

SmsManager.STATUS_ON_ICC_UNSEND

Int

getStatusOnSim()
建议使用getStatusOnIcc（）

返回sim中该条message状态
SmsManager.STATUS_ON_SIM_FREE

SmsManager.STATUS_ON_SIM_READ

SmsManager.STATUS_ON_SIM_UNREAD

SmsManager.STATUS_ON_SIM_SEND

SmsManager.STATUS_ON_SIM_UNSEND

Static SmsMessage.SubmitPdu

getSubmitPdu(String scAddress,String destinationAddress,short destinationPort,byte[] data,boolean statusReportRequested)

参数

scAddress 短讯服务中心地址，默认值null

destinationAddress 短讯目的地址

destinationPort 短讯目的端口

data 数据主体

statusReportRequested 报告返回状态

返回

提交的数据报文，包含编码后的信息，编码后的短信中心地址（如果有）。如遇编码错误返回null

Static SmsMessage.SubmitPdu

getSubmitPdu(String scAddress,String destinationAddress,String message,boolean statusReportRequested)

参数

scAddress 短讯服务中心地址，默认值null

destinationAddress 短讯目的地址

message 数据主体

statusReportRequested 报告返回状态

返回

提交的数据报文，包含编码后的信息，编码后的短信中心地址（如果有）。如遇编码错误返回null

Static int

getTPLayerLengthForPDU(String pdu)

返回给定的提交讯息基础上TP层长度，这个长度以字节为单位（非16进制字符）不包含SMSC头文件

Long

getTimestampMillis()

返回当前时间以currentTimeMillis()编码

byte[]

getUserDate()

返回用户数据段中减去用户数据头的数据。

Boolean

isCphsMwiMessage()

如果为true则是CPHS MWI 触发的信息。详见CPHS 4.2 中B.4.2章节

Boolean

isEmail()

如果为true，则信息为email。

Boolean

isMWIClearMessage()

如果返回true，则该信息是一条CPHS的语音邮件或者讯息等待（MWI）清除信息

Boolean

isMWISetMessage()

如果返回true，则该信息是一条CPHS的语音邮件或者讯息等待（MWI）设置信息

Boolean

isMWIDontStore()

如果为true，则该条信息为“讯息等待标记组：丢弃信息”提示，不需要存储

Boolean

isReplace()

如果为true表示该信息是一条“更换短信息”。详见TS 23.040 9.2.3.9

Boolean

isReplyPathPresent()

如果为true，则该条信息被设置了TP-Reply-Path位

Boolean

isStatusReportMessage()

返回真则该条信息为短信服务状态报告讯息