转自: http://hi.baidu.com/coolnote/blog/item/a62d26fc66cee1ebfc037f32.html 看不到的图请到原文看.
1、温故知新
广播接收者 :一个广播接收者是这样一个组件,它不做什么事,仅是接受广播公告并作出相应的反应。许多广播源自于系统代码,例如公告时区的改变、电池电量低、已采取图片、用户改变了语言偏好。应用程序也可以发起广播,例如为了他其他程序知道某些数据已经下载到设备且他们可以使用这些数据
BroadcastReceiver 类:是接受 sendBroadcast() 发送的意图(intents)的基类。可以用 Context.registerReceiver() 动态地注册这个类的实例,或者通过 AndroidManifest.xml 中<receiver>标签静态发布。
广播接收者不显示一个用户界面。然而,它们启动一个活动去响应收到的信息,或者他们可能使用
NotificationManager
去通知用户。通知可以使用多种方式获得用户的注意——闪烁的背光、振动设备、播放声音等等。典型的是放在一个持久的图标在状态栏,用户可以打开获取信息。
2、准备工作: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)
3、简单的SMS发送程序
1)、首先,编辑布局文件 res/layout/main.xml ,达到我们想要的结果,界面如下:
图1、程序运行界面
对应的xml代码如下:
<? xml version="1.0" encoding="utf-8" ?> < LinearLayout xmlns : android = "http://schemas.android.com/apk/res/android" android : orientation = "vertical" android : layout_width = "fill_parent" android : layout_height = "fill_parent" > < TextView android : layout_width = "fill_parent" android : layout_height = "wrap_content" android : text = "@string/txtPhoneNo" />
<!-- text's value define in res/values/strings.xml --> < EditText android : layout_width = "fill_parent" android : layout_height = "wrap_content" android : id = "@+id/edtPhoneNo" /> < TextView android : layout_width = "fill_parent" android : layout_height = "wrap_content" android : text = "@string/txtContent" /> < EditText android : layout_width = "fill_parent" android : layout_height = "wrap_content" android : minLines = "3" android : id = "@+id/edtContent" /> < Button android : layout_width = "wrap_content" android : layout_height = "wrap_content" android : text = "@string/btnText" android : id = "@+id/btnSend" /> </ LinearLayout >
相应的要在 res/values/strings.xm 中添加上面定义的视图的text的值,如下:
<? xml version="1.0" encoding="utf-8" ?> < resources > < string name = "txtPhoneNo" > Please input phone NO: </ string > < string name = "txtContent" > Please input SMS\'s content: </ string > < string name = "btnText" > send! </ string > < string name = "app_name" > SMS </ string > </ resources >
2)、做完这些准备工作之后,我么要开始编写代码实现简单的短信发送了。
通过第一步我们构建好界面之后,现在要在上面的基础上编写业务逻辑了。大致过程为:在java源文件中,获取用户在edtPhoneNo中输入的电话号码,edtContent中输入要发送的内容;然后点击btnSend按钮发送短信,要达到这个目的我们要设置btnSend的OnClickListener以达到当点击它触发发送短信的功能,而且要发送短信就要用到我们前面介绍的 SmsManager 类提供的方法接口。
设置btnSend的OnClickListener的代码如下:
btnSend.setOnClickListener( new View.OnClickListener() { public void onClick(View v) { String phoneNo = edtPhoneNo.getText().toString(); String message = edtContent.getText().toString(); if (phoneNo.length() > 0 && message.length() > 0){ //call sendSMS to send message to phoneNo sendSMS(phoneNo, message); } else Toast.makeText(getBaseContext(), " Please enter both phone number and message. ", Toast.LENGTH_SHORT).show(); } });
发送短信的功能的代码如下:
private void sendSMS(String phoneNumber, String message) { // ---sends an SMS message to another device--- SmsManager sms = SmsManager.getDefault(); PendingIntent pi = PendingIntent.getActivity( this , 0,
new Intent( this ,TextMessage. class ), 0); //if message's length more than 70 , //then call divideMessage to dive message into several part
//and call sendTextMessage() //else direct call sendTextMessage() if (message.length() > 70) { ArrayList<String> msgs = sms.divideMessage(message); for (String msg : msgs) { sms.sendTextMessage(phoneNumber, null , msg, pi, null ); } } else { sms.sendTextMessage(phoneNumber, null , message, pi, null ); } Toast.makeText(TextMessage. this , " 短信发送完成 ", Toast.LENGTH_LONG).show(); }
如果你已经看了第2节介绍的 SmsManager 类的介绍,代码应该很好理解。在这里要说明的是,sendTextMessage方法中的第4个和第5个参数PendingIntent设为null,这样的话不能根据短信发出之后的状态做相应的事情,如短信发送失败后的提醒、接收者成功接收后的回执……完整的流程源码如下:
package
skynet.com.cnblogs.www;
import
java.util.ArrayList;
import
android.app.Activity;
import
android.app.PendingIntent;
import
android.content.Intent;
import
android.os.Bundle;
import
android.telephony.SmsManager;
import
android.view.View;
import
android.widget.*;
public
class
TextMessage
extends
Activity {
/** Called when the activity is first created. */
@Override
public
void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
setContentView(R.layout.main);
btnSend = (Button) findViewById(R.id.btnSend);
edtPhoneNo = (EditText) findViewById(R.id.edtPhoneNo);
edtContent = (EditText) findViewById(R.id.edtContent);
btnSend.setOnClickListener(
new
View.OnClickListener() {
public
void
onClick(View v) {
String phoneNo = edtPhoneNo.getText().toString();
String message = edtContent.getText().toString();
if
(phoneNo.length() > 0 && message.length() > 0) {
// call sendSMS to send message to phoneNo
sendSMS(phoneNo, message);
}
else
Toast.makeText(getBaseContext(),
"
Please enter both phone number and message.
",
Toast.LENGTH_SHORT).show();
}
});
}
private
Button btnSend;
private
EditText edtPhoneNo;
private
EditText edtContent;
private
void
sendSMS(String phoneNumber, String message) {
// ---sends an SMS message to another device---
SmsManager sms = SmsManager.getDefault();
PendingIntent pi = PendingIntent.getActivity(
this
, 0,
new
Intent(
this
,
TextMessage.
class
), 0);
// if message's length more than 70 ,
// then call divideMessage to dive message into several part ,and call
// sendTextMessage()
// else direct call sendTextMessage()
if
(message.length() > 70) {
ArrayList<String> msgs = sms.divideMessage(message);
for
(String msg : msgs) {
sms.sendTextMessage(phoneNumber,
null
, msg, pi,
null
);
}
}
else
{
sms.sendTextMessage(phoneNumber,
null
, message, pi,
null
);
}
Toast.makeText(TextMessage.
this
, "
短信发送完成
", Toast.LENGTH_LONG).show();
}
}
3)运行前,还要在清单文件AndroidManifest.xml中加入允许发送短信的权限:
<?xml version="
1.0
" encoding="
utf-8
"?>
<manifest xmlns:android="
http://schemas.android.com/apk/res/android
"
package
="
skynet.com.cnblogs.www
"
android:versionCode="
1
"
android:versionName="
1.0
">
<application android:icon="
@drawable/icon
" android:label="
@string/app_name
">
<activity android:name="
.TextMessage
"
android:label="
@string/app_name
">
<intent-filter>
<action android:name="
android.intent.action.MAIN
" />
<category android:name="
android.intent.category.LAUNCHER
" />
</intent-filter>
</activity>
</application>
<uses-permission android:name="
android.permission.SEND_SMS
"/>
</manifest>