Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public final class

SmsManager

extends Object
java.lang.Object
   ↳ android.telephony.gsm.SmsManager

This class was deprecated in API level 4.
Replaced by android.telephony.SmsManager that supports both GSM and CDMA.

Class Overview

Manages SMS operations such as sending data, text, and pdu SMS messages. Get this object by calling the static method SmsManager.getDefault().

Summary

Constants
int RESULT_ERROR_GENERIC_FAILURE This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int RESULT_ERROR_NO_SERVICE This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int RESULT_ERROR_NULL_PDU This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int RESULT_ERROR_RADIO_OFF This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int STATUS_ON_SIM_FREE This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int STATUS_ON_SIM_READ This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int STATUS_ON_SIM_SENT This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int STATUS_ON_SIM_UNREAD This constant was deprecated in API level 4. Use android.telephony.SmsManager.
int STATUS_ON_SIM_UNSENT This constant was deprecated in API level 4. Use android.telephony.SmsManager.
Public Methods
final ArrayList < String > divideMessage ( String text)
This method was deprecated in API level 4. Use android.telephony.SmsManager.
final static SmsManager getDefault ()
This method was deprecated in API level 4. Use android.telephony.SmsManager.
final void sendDataMessage ( String destinationAddress, String scAddress, short destinationPort, byte[] data, PendingIntent sentIntent, PendingIntent deliveryIntent)
This method was deprecated in API level 4. Use android.telephony.SmsManager.
final void , java.util.ArrayList , java.util.ArrayList )">sendMultipartTextMessage ( String destinationAddress, String scAddress, ArrayList < String > parts, ArrayList < PendingIntent > sentIntents, ArrayList < PendingIntent > deliveryIntents)
This method was deprecated in API level 4. Use android.telephony.SmsManager.
final void sendTextMessage ( String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent)
This method was deprecated in API level 4. Use android.telephony.SmsManager.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final int RESULT_ERROR_GENERIC_FAILURE

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Generic failure cause

Constant Value: 1 (0x00000001)

public static final int RESULT_ERROR_NO_SERVICE

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Failed because service is currently unavailable

Constant Value: 4 (0x00000004)

public static final int RESULT_ERROR_NULL_PDU

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Failed because no pdu provided

Constant Value: 3 (0x00000003)

public static final int RESULT_ERROR_RADIO_OFF

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Failed because radio was explicitly turned off

Constant Value: 2 (0x00000002)

public static final int STATUS_ON_SIM_FREE

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Free space (TS 51.011 10.5.3).

Constant Value: 0 (0x00000000)

public static final int STATUS_ON_SIM_READ

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Received and read (TS 51.011 10.5.3).

Constant Value: 1 (0x00000001)

public static final int STATUS_ON_SIM_SENT

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Stored and sent (TS 51.011 10.5.3).

Constant Value: 5 (0x00000005)

public static final int STATUS_ON_SIM_UNREAD

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Received and unread (TS 51.011 10.5.3).

Constant Value: 3 (0x00000003)

public static final int STATUS_ON_SIM_UNSENT

Added in API level 1

This constant was deprecated in API level 4.
Use android.telephony.SmsManager.

Stored and unsent (TS 51.011 10.5.3).

Constant Value: 7 (0x00000007)

Public Methods

public final ArrayList < String > divideMessage ( String text)

Added in API level 1

This method was deprecated in API level 4.
Use android.telephony.SmsManager.

Divide a text message into several messages, none bigger than the maximum SMS message size.

Parameters
text the original message. Must not be null.
Returns
  • an ArrayList of strings that, in order, comprise the original message

public static final SmsManager getDefault ()

Added in API level 1

This method was deprecated in API level 4.
Use android.telephony.SmsManager.

Get the default instance of the SmsManager

Returns
  • the default instance of the SmsManager

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

Added in API level 1

This method was deprecated in API level 4.
Use android.telephony.SmsManager.

Send a data based SMS to a specific application port.

Parameters
destinationAddress the address to send the message to
scAddress is the service center address or null to use the current default SMSC
destinationPort the port to deliver the message to
data the body of the message to send
sentIntent if not NULL this PendingIntent is broadcast when the message is sucessfully sent, or failed. The result code will be Activity.RESULT_OK for success, or one of these errors: RESULT_ERROR_GENERIC_FAILURE RESULT_ERROR_RADIO_OFF RESULT_ERROR_NULL_PDU . The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applicaitons, which cause smaller number of SMS to be sent in checking period.
deliveryIntent if not NULL this PendingIntent is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").
Throws
IllegalArgumentException if destinationAddress or data are empty
, java.util.ArrayList , java.util.ArrayList )">

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

Added in API level 1

This method was deprecated in API level 4.
Use android.telephony.SmsManager.

Send a multi-part text based SMS. The callee should have already divided the message into correctly sized parts by calling divideMessage .

Parameters
destinationAddress the address to send the message to
scAddress is the service center address or null to use the current default SMSC
parts an ArrayList of strings that, in order, comprise the original message
sentIntents if not null, an ArrayList of PendingIntent s (one for each message part) that is broadcast when the corresponding message part has been sent. The result code will be Activity.RESULT_OK for success, or one of these errors: RESULT_ERROR_GENERIC_FAILURE RESULT_ERROR_RADIO_OFF RESULT_ERROR_NULL_PDU . The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applicaitons, which cause smaller number of SMS to be sent in checking period.
deliveryIntents if not null, an ArrayList of PendingIntent s (one for each message part) that is broadcast when the corresponding message part has been delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").
Throws
IllegalArgumentException if destinationAddress or data are empty

public final void sendTextMessage ( String destinationAddress, String scAddress, String text, PendingIntent sentIntent, PendingIntent deliveryIntent)

Added in API level 1

This method was deprecated in API level 4.
Use android.telephony.SmsManager.

Send a text based SMS.

Parameters
destinationAddress the address to send the message to
scAddress is the service center address or null to use the current default SMSC
text the body of the message to send
sentIntent if not NULL this PendingIntent is broadcast when the message is successfully sent, or failed. The result code will be Activity.RESULT_OK for success, or one of these errors: RESULT_ERROR_GENERIC_FAILURE RESULT_ERROR_RADIO_OFF RESULT_ERROR_NULL_PDU . The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applications, which cause smaller number of SMS to be sent in checking period.
deliveryIntent if not NULL this PendingIntent is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").
Throws
IllegalArgumentException if destinationAddress or text are empty