首页 > 代码库 > Android开发之SmsManager(短信管理器)详解

Android开发之SmsManager(短信管理器)详解

        SmsManager是Android提供的另一个非常常见的服务,SmsManager提供了系列sendXxxMessage()方法用于发送短信。

SmsManager:管理短信操作,如发送数据,文本和PDU短信。通过调用静态方法SmsManager.getDefault()获取此对象。

Public Methods

 

ArrayList<String>

divideMessage(String text)

当短信超过SMS消息的最大长度时,将短信分割为几块。

 

 

 

 

 

 

 

 

 

 

static SmsManager

getDefault()

获取SmsManager的默认实例。 

 

 

 

 

 

 

 

 

 

 

void

sendDataMessage(String destinationAddress, String scAddress, short destinationPort, byte[] data, PendingIntent sentIntent, PendingIntent deliveryIntent)

发送一个基于SMS的数据到指定的应用程序端口。

 

 

 

 

 

 

 

 

 

 

void

sendMultipartTextMessage(String destinationAddress, String scAddress, ArrayList<String> parts, ArrayList<PendingIntent> sentIntents, ArrayList<PendingIntent> deliveryIntents)

发送一个基于SMS的多部分文本,调用者应用已经通过调用

divideMessage(String text)将消息分割成正确的大小。

 

 

 

 

 

 

 

 

 

 

void

sendTextMessage(String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent)

发送一个基于SMS的文本。

 

 

 

 

 

 

 

 

 

 

说明:

·      ArrayList<String> divideMessage(String text) 
当短信超过SMS消息的最大长度时,将短信分割为几块。 
参数text——初始的消息,不能为空 
返回值:有序的ArrayList<String>,可以重新组合为初始的消息

·      static SmsManager getDefault() 
获取SmsManager的默认实例。 
返回值SmsManager的默认实例

·      void SendDataMessage(String destinationAddress, String scAddress, short destinationPort, byte[] data,PendingIntent sentIntent, PendingIntent deliveryIntent) 发送一个基于SMS的数据到指定的应用程序端口。 
参数 
1)
destinationAddress——消息的目标地址 
2)
scAddress——服务中心的地址or为空使用当前默认的SMSC 3)destinationPort——消息的目标端口号 
4)
data——消息的主体,即消息要发送的数据 
5)
sentIntent——如果不为空,当消息成功发送或失败这个PendingIntent就广播。结果代码是Activity.RESULT_OK表示成功,或RESULT_ERROR_GENERIC_FAILURERESULT_ERROR_RADIO_OFFRESULT_ERROR_NULL_PDU之一表示错误。对应RESULT_ERROR_GENERIC_FAILUREsentIntent可能包括额外的错误代码包含一个无线电广播技术特定的值,通常只在修复故障时有用。 
每一个基于SMS的应用程序控制检测sentIntent。如果sentIntent是空,调用者将检测所有未知的应用程序,这将导致在检测的时候发送较小数量的SMS 
6)
deliveryIntent——如果不为空,当消息成功传送到接收者这个PendingIntent就广播。
异常:如果destinationAddressdata是空时,抛出IllegalArgumentException异常。

·      void sendMultipartTextMessage(String destinationAddress, String scAddress, ArrayList<String> parts,ArrayList<PendingIntent> sentIntents,ArrayList<PendingIntent>  deliverIntents) 
发送一个基于SMS的多部分文本,调用者应用已经通过调用divideMessage(String text)将消息分割成正确的大小。 
参数 
1)
destinationAddress——消息的目标地址 
2)
scAddress——服务中心的地址or为空使用当前默认的SMSC 
3)parts——有序的ArrayList<String>,可以重新组合为初始的消息 
4)
sentIntents——SendDataMessage方法中一样,只不过这里的是一组PendingIntent 
5)deliverIntents——SendDataMessage方法中一样,只不过这里的是一组PendingIntent 
异常:如果destinationAddressdata是空时,抛出IllegalArgumentException异常。

·      void sendTextMessage(String destinationAddress, String scAddress, String text, PendingIntent sentIntent,PendingIntent deliveryIntent) 
发送一个基于SMS的文本。参数的意义和异常前面的已存在的一样,不再累述。

 关于SmsManager的应用实例大家可以参照Android开发之发送短信

Android开发之SmsManager(短信管理器)详解