SMS涉及的主要类SmsManager
实现SMS主要用到SmsManager类,该类继承自java.lang.Object类,下面我们介绍一下该类的主要成员。
公有方法:
- 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_FAILURE、RESULT_ERROR_RADIO_OFF、RESULT_ERROR_NULL_PDU之一表示错误。对应RESULT_ERROR_GENERIC_FAILURE,sentIntent可能包括额外的“错误代码”包含一个无线电广播技术特定的值,通常只在修复故障时有用。
每一个基于SMS的应用程序控制检测sentIntent。如果sentIntent是空,调用者将检测所有未知的应用程序,这将导致在检测的时候发送较小数量的SMS。
6)、deliveryIntent——如果不为空,当消息成功传送到接收者这个PendingIntent就广播。
异常:如果destinationAddress或data是空时,抛出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
异常:如果destinationAddress或data是空时,抛出IllegalArgumentException异常。 - void sendTextMessage(String destinationAddress, String scAddress, String text, PendingIntent sentIntent,PendingIntent deliveryIntent)
发送一个基于SMS的文本。参数的意义和异常前面的已存在的一样,不再累述。
常量:
- public static final int RESULT_ERROR_GENERIC_FAILURE
表示普通错误,值为1(0x00000001) - public static final int RESULT_ERROR_NO_SERVICE
表示服务当前不可用,值为4 (0x00000004) - public static final int RESULT_ERROR_NULL_PDU
表示没有提供pdu,值为3 (0x00000003) - public static final int RESULT_ERROR_RADIO_OFF
表示无线广播被明确地关闭,值为2 (0x00000002) - public static final int STATUS_ON_ICC_FREE
表示*空间,值为0 (0x00000000) - public static final int STATUS_ON_ICC_READ
表示接收且已读,值为1 (0x00000001) - public static final int STATUS_ON_ICC_SENT
表示存储且已发送,值为5 (0x00000005) - public static final int STATUS_ON_ICC_UNREAD
表示接收但未读,值为3 (0x00000003) - public static final int STATUS_ON_ICC_UNSENT
表示存储但为发送,值为7 (0x00000007)
第一:调用系统短信接口直接发送短信;主要代码如下:
/**
* 直接调用短信接口发短信
*
* @param phoneNumber
* @param message
*/
public void sendSMS(String phoneNumber, String message) {
// 获取短信管理器
android.telephony.SmsManager smsManager = android.telephony.SmsManager
.getDefault();
// 拆分短信内容(手机短信长度限制)
List<String> divideContents = smsManager.divideMessage(message);
for (String text : divideContents) {
smsManager.sendTextMessage(phoneNumber, null, text, sentPI,
deliverPI);
}
}
第二:调起系统发短信功能;主要代码如下:
/**
* 调起系统发短信功能
* @param phoneNumber
* @param message
*/
public void doSendSMSTo(String phoneNumber,String message){
if(PhoneNumberUtils.isGlobalPhoneNumber(phoneNumber)){
Intent intent = new Intent(Intent.ACTION_SENDTO, Uri.parse("smsto:"+phoneNumber));
intent.putExtra("sms_body", message);
startActivity(intent);
}
}
下面来主要讲解第一种方法,第一种方法可以监控发送状态和对方接收状态使用的比较多。
处理返回的状态代码如下:
//处理返回的发送状态
String SENT_SMS_ACTION = "SENT_SMS_ACTION";
Intent sentIntent = new Intent(SENT_SMS_ACTION);
sentPI= PendingIntent.getBroadcast(this, 0, sentIntent,
0);
// register the Broadcast Receivers
this.registerReceiver(new BroadcastReceiver() {
@Override
public void onReceive(Context _context, Intent _intent) {
switch (getResultCode()) {
case Activity.RESULT_OK:
Toast.makeText(MainActivity.this,
"短信发送成功", Toast.LENGTH_SHORT)
.show();
break;
case SmsManager.RESULT_ERROR_GENERIC_FAILURE:
break;
case SmsManager.RESULT_ERROR_RADIO_OFF:
break;
case SmsManager.RESULT_ERROR_NULL_PDU:
break;
}
}
}, new IntentFilter(SENT_SMS_ACTION)); //处理返回的接收状态
String DELIVERED_SMS_ACTION = "DELIVERED_SMS_ACTION";
// create the deilverIntent parameter
Intent deliverIntent = new Intent(DELIVERED_SMS_ACTION);
deliverPI = PendingIntent.getBroadcast(this, 0,
deliverIntent, 0);
this.registerReceiver(new BroadcastReceiver() {
@Override
public void onReceive(Context _context, Intent _intent) {
Toast.makeText(MainActivity.this,
"收信人已经成功接收", Toast.LENGTH_SHORT)
.show();
}
}, new IntentFilter(DELIVERED_SMS_ACTION));
以下是对以上代码的封装
1、短信的发送
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.telephony.SmsManager; import java.util.ArrayList;
import java.util.List; /**
* Created by Javen on 2016-03-15.
*/
public class SMSMethod {
private static SMSMethod mSMSmsMethod;
/* 自定义ACTION常数,作为广播的Intent Filter识别常数 */
public static String SMS_SEND_ACTIOIN = "SMS_SEND_ACTIOIN";
public static String SMS_DELIVERED_ACTION = "SMS_DELIVERED_ACTION"; /* 建立两个mServiceReceiver对象,作为类成员变量 */
private SMSReceiver mSendSMSReceiver, mDeliveredSMSReceiver; private Context mContext; private SMSMethod(Context context){
mContext=context;
registerReceiver(); } public static SMSMethod getInstance(Context context){
if (mSMSmsMethod==null){
synchronized (SMSMethod.class){
if (mSMSmsMethod==null){
mSMSmsMethod=new SMSMethod(context);
}
}
}
return mSMSmsMethod;
} /**
* 注册
*/
public void registerReceiver(){
/* 自定义IntentFilter为SENT_SMS_ACTIOIN Receiver */
IntentFilter mFilter01;
mFilter01 = new IntentFilter(SMS_SEND_ACTIOIN);
mSendSMSReceiver = new SMSReceiver();
mContext.registerReceiver(mSendSMSReceiver, mFilter01); /* 自定义IntentFilter为DELIVERED_SMS_ACTION Receiver */
mFilter01 = new IntentFilter(SMS_DELIVERED_ACTION);
mDeliveredSMSReceiver = new SMSReceiver();
mContext.registerReceiver(mDeliveredSMSReceiver, mFilter01);
} public void unregisterReceiver(){
/* 取消注册自定义Receiver */
if (mSendSMSReceiver!=null){
mContext.unregisterReceiver(mSendSMSReceiver);
}
if (mDeliveredSMSReceiver!=null) {
mContext.unregisterReceiver(mDeliveredSMSReceiver);
}
} public void SendMessage(String strDestAddress,String strMessage){
/* 建立SmsManager对象 */
SmsManager smsManager = SmsManager.getDefault();
try {
/* 建立自定义Action常数的Intent(给PendingIntent参数之用) */
Intent itSend = new Intent(SMS_SEND_ACTIOIN);
Intent itDeliver = new Intent(SMS_DELIVERED_ACTION); /* sentIntent参数为传送后接受的广播信息PendingIntent */
PendingIntent mSendPI = PendingIntent.getBroadcast(mContext, 0, itSend, 0); /* deliveryIntent参数为送达后接受的广播信息PendingIntent */
PendingIntent mDeliverPI = PendingIntent.getBroadcast(mContext, 0, itDeliver, 0);
List<String> divideContents = smsManager.divideMessage(strMessage);
for (String text:divideContents) {
/* 发送SMS短信,注意倒数的两个PendingIntent参数 */
smsManager.sendTextMessage(strDestAddress, null, text, mSendPI, mDeliverPI);
} }catch(Exception e) {
e.printStackTrace();
}
}
public void SendMessage2(String strDestAddress,String strMessage){
ArrayList<PendingIntent> sentPendingIntents = new ArrayList<PendingIntent>();
ArrayList<PendingIntent> deliveredPendingIntents = new ArrayList<PendingIntent>(); /* 建立SmsManager对象 */
SmsManager smsManager = SmsManager.getDefault();
try {
/* 建立自定义Action常数的Intent(给PendingIntent参数之用) */
Intent itSend = new Intent(SMS_SEND_ACTIOIN);
Intent itDeliver = new Intent(SMS_DELIVERED_ACTION); /* sentIntent参数为传送后接受的广播信息PendingIntent */
PendingIntent mSendPI = PendingIntent.getBroadcast(mContext, 0, itSend, 0); /* deliveryIntent参数为送达后接受的广播信息PendingIntent */
PendingIntent mDeliverPI = PendingIntent.getBroadcast(mContext, 0, itDeliver, 0);
ArrayList<String> mSMSMessage = smsManager.divideMessage(strMessage); for (int i = 0; i < mSMSMessage.size(); i++) {
sentPendingIntents.add(i, mSendPI);
deliveredPendingIntents.add(i, mDeliverPI);
}
/* 发送SMS短信,注意倒数的两个PendingIntent参数 */
smsManager.sendMultipartTextMessage(strDestAddress,null,mSMSMessage ,sentPendingIntents,deliveredPendingIntents); }catch(Exception e) {
e.printStackTrace();
}
}
}
2、短信发送状态的监听
package com.javen.sms.receiver; import android.app.Activity;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.telephony.SmsManager;
import android.widget.Toast; /**
* Created by Javen on 2016-03-15.
*/
public class SMSReceiver extends BroadcastReceiver{ @Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals(SMSMethod.SMS_SEND_ACTIOIN)){
try{
/* android.content.BroadcastReceiver.getResultCode()方法 */
//Retrieve the current result code, as set by the previous receiver.
switch (getResultCode()){
case Activity.RESULT_OK:
System.out.println("短信发送成功");
Toast.makeText(context, "短信发送成功", Toast.LENGTH_SHORT).show();
break;
case SmsManager.RESULT_ERROR_GENERIC_FAILURE:
System.out.println("短信发送失败");
Toast.makeText(context, "短信发送失败", Toast.LENGTH_SHORT).show();
break;
case SmsManager.RESULT_ERROR_RADIO_OFF:
break;
case SmsManager.RESULT_ERROR_NULL_PDU:
break;
}
}catch (Exception e){
e.printStackTrace();
}
} else if(intent.getAction().equals(SMSMethod.SMS_DELIVERED_ACTION)){
/* android.content.BroadcastReceiver.getResultCode()方法 */
switch(getResultCode()){
case Activity.RESULT_OK:
System.out.println("短信已送达");
Toast.makeText(context, "短信已送达", Toast.LENGTH_SHORT).show();
break;
case SmsManager.RESULT_ERROR_GENERIC_FAILURE:
System.out.println("短信未送达");
/* 短信未送达 */
Toast.makeText(context, "短信未送达", Toast.LENGTH_SHORT).show();
break;
case SmsManager.RESULT_ERROR_RADIO_OFF:
break;
case SmsManager.RESULT_ERROR_NULL_PDU:
break;
}
}
}
}
<!-- 短信发送送达-->
<receiver android:name="com.javen.sms.receiver.SMSReceiver"/>
测试代码:
public void sendTextMessage(View view){
SMSMethod.getInstance(this).SendMessage("xxxx","测试短信。。。");
}
public void sendMultipartTextMessage(View view){
SMSMethod.getInstance(this).SendMessage2("xxxx", "测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。测试短信wwww。。。");
} @Override
protected void onPause() {
SMSMethod.getInstance(this).unregisterReceiver();
super.onPause();
}
别忘了权限的问题:
<uses-permission android:name="android.permission.SEND_SMS" />
源码下载地址:http://download.csdn.net/detail/zyw_java/8917057