SMS Messaging in Android(1)

可以安全的说，在过去的近20年里卖的每一款移动电话都拥有SMS消息功能。事实上，SMS消息是移动手机中一个杀手级的应用程序，它为移动运营商创造了稳定的收入源。理解如何在你的应用程序中使用SMS消息能帮助你产生灵感来创建下一个杀手级程序。

 

在这篇文章里，我将一览如何在你的Android应用程序中发送和接收SMS消息。对Android开发者来说，有个好消息是你不需要一款真实的设备来测试SMS消息——免费的Android模拟器提供这一功能。

 

发送SMS消息

 

开始，先启动Eclipse并创建一个新的Android工程。命名工程如图1所示。

图1 使用Eclipse创建一个新的Android工程

Android使用一种基于权限的策略，应用程序所需的所有权限需要在AndroidManifest.xml文件中指定。通过这样做，当应用程序安装后，用户就能清楚地知晓应用程序需要哪些特定的访问权限。举个例子，发送SMS消息会引起用户的额外费用，在AndroidManifest.xml文件中指明SMS权限能让用户决定应用程序是否安装。

 

在AndroidManifest.xml文件中，添加两个权限——SEND_SMS和RECEIVE_SMS：

 

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="net.learn2develop.SMSMessaging"
      android:versionCode="1"
      android:versionName="1.0.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".SMS"
                  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">
    </uses-permission>
    <uses-permission android:name="android.permission.RECEIVE_SMS">
    </uses-permission>
</manifest>

 

在res/layout文件夹下的main.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="Enter the phone number of recipient"
        />    
    <EditText
        android:id="@+id/txtPhoneNo" 
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"       
        />
    <TextView 
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"        
        android:text="Message"
        />    
    <EditText
        android:id="@+id/txtMessage" 
        android:layout_width="fill_parent"
        android:layout_height="150px"
        android:gravity="top"        
        />         
    <Button
        android:id="@+id/btnSendSMS" 
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="Send SMS"
        />   
</LinearLayout>

 

上面的代码创建的UI如图2所示。

 

图2 创建发送SMS消息的UI

接下来，在SMS Activity中，我们连接Button View，这样当用户点击它时，我们可以检查接收者的电话号码和输入的消息，然后使用sendSMS函数来发送消息。

 

package net.learn2develop.SMSMessaging;
 
import android.app.Activity;
import android.app.PendingIntent;
import android.content.Intent;
import android.os.Bundle;
import android.telephony.gsm.SmsManager;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;
 
public class SMS extends Activity
{
    Button btnSendSMS;
    EditText txtPhoneNo;
    EditText txtMessage;
 
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);       
 
        btnSendSMS = (Button) findViewById(R.id.btnSendSMS);
        txtPhoneNo = (EditText) findViewById(R.id.txtPhoneNo);
        txtMessage = (EditText) findViewById(R.id.txtMessage);
 
        btnSendSMS.setOnClickListener(new View.OnClickListener()
        {
            public void onClick(View v)
            {               
                String phoneNo = txtPhoneNo.getText().toString();
                String message = txtMessage.getText().toString();                
                if (phoneNo.length()>0 && message.length()>0)               
                    sendSMS(phoneNo, message);               
                else
                    Toast.makeText(getBaseContext(),
                        "Please enter both phone number and message.",
                        Toast.LENGTH_SHORT).show();
            }
        });       
    }   
}

 

sendSMS函数定义如下：

 

public class SMS extends Activity
{
    //...
 
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState)
    {
        //...
    }
 
    //---sends an SMS message to another device---
    private void sendSMS(String phoneNumber, String message)
    {       
        PendingIntent pi = PendingIntent.getActivity(this, 0,
            new Intent(this, SMS.class), 0);               
        SmsManager sms = SmsManager.getDefault();
        sms.sendTextMessage(phoneNumber, null, message, pi, null);       
    }   
}

 

为了发送一个SMS消息，你需要使用SmsManager类。不同于其它的类，你不需要直接实例化这个类；取而代之的是调用getDefault()静态方法来获取一个SmsManager对象。sendTextMessage()方法发送SMS消息和一个PendingIntent。PendingIntent对象用于在以后的时间识别触发的目标。例如，发送消息后，你可以使用PendingIntent对象来显示其它的Activity。在这里，PendingIntent对象（pi）简单指向相同的Activity（SMS.java），所以，当SMS发送后，什么事情也不会发生。

 

如果你需要监视SMS消息的发送过程状况，你可以使用两个PendingIntent对象以及两个BroadcastReceiver对象，像这样：

 

    //---sends an SMS message to another device---
    private void sendSMS(String phoneNumber, String message)
    {       
        String SENT = "SMS_SENT";
        String DELIVERED = "SMS_DELIVERED";
 
        PendingIntent sentPI = PendingIntent.getBroadcast(this, 0,
            new Intent(SENT), 0);
 
        PendingIntent deliveredPI = PendingIntent.getBroadcast(this, 0,
            new Intent(DELIVERED), 0);
 
        //---when the SMS has been sent---
        registerReceiver(new BroadcastReceiver(){
            @Override
            public void onReceive(Context arg0, Intent arg1) {
                switch (getResultCode())
                {
                    case Activity.RESULT_OK:
                        Toast.makeText(getBaseContext(), "SMS sent",
                                Toast.LENGTH_SHORT).show();
                        break;
                    case SmsManager.RESULT_ERROR_GENERIC_FAILURE:
                        Toast.makeText(getBaseContext(), "Generic failure",
                                Toast.LENGTH_SHORT).show();
                        break;
                    case SmsManager.RESULT_ERROR_NO_SERVICE:
                        Toast.makeText(getBaseContext(), "No service",
                                Toast.LENGTH_SHORT).show();
                        break;
                    case SmsManager.RESULT_ERROR_NULL_PDU:
                        Toast.makeText(getBaseContext(), "Null PDU",
                                Toast.LENGTH_SHORT).show();
                        break;
                    case SmsManager.RESULT_ERROR_RADIO_OFF:
                        Toast.makeText(getBaseContext(), "Radio off",
                                Toast.LENGTH_SHORT).show();
                        break;
                }
            }
        }, new IntentFilter(SENT));
 
        //---when the SMS has been delivered---
        registerReceiver(new BroadcastReceiver(){
            @Override
            public void onReceive(Context arg0, Intent arg1) {
                switch (getResultCode())
                {
                    case Activity.RESULT_OK:
                        Toast.makeText(getBaseContext(), "SMS delivered",
                                Toast.LENGTH_SHORT).show();
                        break;
                    case Activity.RESULT_CANCELED:
                        Toast.makeText(getBaseContext(), "SMS not delivered",
                                Toast.LENGTH_SHORT).show();
                        break;                       
                }
            }
        }, new IntentFilter(DELIVERED));       
 
        SmsManager sms = SmsManager.getDefault();
        sms.sendTextMessage(phoneNumber, null, message, sentPI, deliveredPI);       
    }

 

上面的代码使用一个PendingIntent对象（sendPI）来监视发送过程。当SMS消息发送后，第一个BroadcastReceiver的onReceive事件会触发。在这里你可以检查发送过程的状态。第二个PendingIntent对象（deliveredPI）监视传送过程。当SMS消息成功送达时会触发第二个BroadcastReceiver的onReceive事件。

 

现在，你可以按下F11来测试应用程序了。为了从一个模拟器实例发送SMS消息到另一个实例，进入SDK的Tools文件夹并运行Emulator.exe来简单启动另一个Android模拟器实例。

图3 发送SMS消息

图3演示了如何从一个模拟器发送SMS消息到另一个模拟器；使用目标模拟器的端口号（显示在窗口的左上角）作为它的电话号码。当SMS发送成功时，它会显示一个“SMS sent”消息。当它成功送达时，它会显示一个“SMS delivered”消息。注意，使用模拟器进行测试时，当SMS成功送达时，“SMS delivered”消息不会显示；它仅在真机上工作。

 

图4显示了接收模拟器中SMS消息接收后的样子。消息一开始显示在通知条上（屏幕的上方）。往下拖拽通知条，显示出接收到的消息。查看完整的消息，点击那个消息。

图4 Android模拟器接收SMS消息

如果你不想触及发送SMS消息的所有麻烦，你可以使用一个Intent对象来帮助你发送SMS消息。下面的代码就演示了如何引发内建的SMS程序来帮助你发送SMS消息：

 

        Intent sendIntent = new Intent(Intent.ACTION_VIEW);
        sendIntent.putExtra("sms_body", "Content of the SMS goes here...");
        sendIntent.setType("vnd.android-dir/mms-sms");
        startActivity(sendIntent);

 

图5显示了内建的SMS应用程序发送SMS消息。

图5 引发内建的SMS程序

接收SMS消息

 

除了可以程序化的发送SMS消息，你还可以使用一个BroadcastReceiver对象来拦截新的SMS消息。

 

想看如何在Android应用程序中接收SMS消息的话，可以在AndroidManifest.xml文件中添加<receiver>元素，这样，新来的SMS消息就能被SmsReceiver类拦截：

 

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="net.learn2develop.SMSMessaging"
      android:versionCode="1"
      android:versionName="1.0.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".SMS"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>       
 
        <receiver android:name=".SmsReceiver">
            <intent-filter>
                <action android:name=
                    "android.provider.Telephony.SMS_RECEIVED" />
            </intent-filter>
        </receiver>
 
    </application>
    <uses-permission android:name="android.permission.SEND_SMS">
    </uses-permission>
    <uses-permission android:name="android.permission.RECEIVE_SMS">
    </uses-permission>
</manifest>

 

添加一个新的类文件并命名为SmsReceiver.java（如图6）。

图6 添加SmsReceiver.java文件到工程中

在SmsReceiver类中，扩展BroadcastReceiver类，并重写onReceive方法：

 

package net.learn2develop.SMSMessaging;
 
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
 
public class SmsReceiver extends BroadcastReceiver
{
        @Override
        public void onReceive(Context context, Intent intent)
       {        
        }
}

 

当SMS消息接收后，onReceive()方法会触发。SMS消息附着在Intent对象上（onReceive方法的第二个参数，intent）的Bundle对象里。消息以PDU格式储存在一个对象数组里。要提取每个消息，可以使用SmsMessage类的createFromPdu（）静态方法。然后，使用Toast类显示SMS消息：

 

package net.learn2develop.SMSMessaging;
 
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.telephony.gsm.SmsMessage;
import android.widget.Toast;
 
public class SmsReceiver extends BroadcastReceiver
{
    @Override
    public void onReceive(Context context, Intent intent)
    {
        //---get the SMS message passed in---
        Bundle bundle = intent.getExtras();       
        SmsMessage[] msgs = null;
        String str = "";           
        if (bundle != null)
        {
            //---retrieve the SMS message received---
            Object[] pdus = (Object[]) bundle.get("pdus");
            msgs = new SmsMessage[pdus.length];           
            for (int i=0; i<msgs.length; i++){
                msgs[i] = SmsMessage.createFromPdu((byte[])pdus[i]);               
                str += "SMS from " + msgs[i].getOriginatingAddress();                    
                str += " :";
                str += msgs[i].getMessageBody().toString();
                str += "\n";       
            }
            //---display the new SMS message---
            Toast.makeText(context, str, Toast.LENGTH_SHORT).show();
        }                        
    }
}