| java.lang.Object | |
| ↳ | android.telephony.SmsManager |
Manages SMS operations such as sending data, text, and pdu SMS messages. Get this object by calling the static method SmsManager.getDefault().
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| int | RESULT_ERROR_GENERIC_FAILURE | Generic failure cause | |||||||||
| int | RESULT_ERROR_NO_SERVICE | Failed because service is currently unavailable | |||||||||
| int | RESULT_ERROR_NULL_PDU | Failed because no pdu provided | |||||||||
| int | RESULT_ERROR_RADIO_OFF | Failed because radio was explicitly turned off | |||||||||
| int | STATUS_ON_ICC_FREE | Free space (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27). | |||||||||
| int | STATUS_ON_ICC_READ | Received and read (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27). | |||||||||
| int | STATUS_ON_ICC_SENT | Stored and sent (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27). | |||||||||
| int | STATUS_ON_ICC_UNREAD | Received and unread (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27). | |||||||||
| int | STATUS_ON_ICC_UNSENT | Stored and unsent (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27). | |||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Divide a message text into several fragments, none bigger than
the maximum SMS message size.
| |||||||||||
Get the default instance of the SmsManager
| |||||||||||
Send a data based SMS to a specific application port.
| |||||||||||
Send a multi-part text based SMS.
| |||||||||||
Send a text based SMS.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Generic failure cause
Failed because service is currently unavailable
Failed because no pdu provided
Failed because radio was explicitly turned off
Free space (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27).
Received and read (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27).
Stored and sent (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27).
Received and unread (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27).
Stored and unsent (TS 51.011 10.5.3 / 3GPP2 C.S0023 3.4.27).
Divide a message text into several fragments, none bigger than the maximum SMS message size.
| text | the original message. Must not be null. |
|---|
ArrayList of strings that, in order,
comprise the original message| IllegalArgumentException | if text is null |
|---|
Get the default instance of the SmsManager
Send a data based SMS to a specific application port.
| 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 successfully sent, or failed.
The result code will be Activity.RESULT_OK for success,
or one of these errors:RESULT_ERROR_GENERIC_FAILURERESULT_ERROR_RADIO_OFFRESULT_ERROR_NULL_PDUFor RESULT_ERROR_GENERIC_FAILURE the sentIntent may include
the extra "errorCode" containing a radio technology specific value,
generally only useful for troubleshooting.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"). |
| IllegalArgumentException | if destinationAddress or data are empty |
|---|
Send a multi-part text based SMS. The callee should have already
divided the message into correctly sized parts by calling
divideMessage.
| 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
PendingIntents (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_FAILURERESULT_ERROR_RADIO_OFFRESULT_ERROR_NULL_PDUFor RESULT_ERROR_GENERIC_FAILURE each sentIntent may include
the extra "errorCode" containing a radio technology specific value,
generally only useful for troubleshooting.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. |
| deliveryIntents | if not null, an ArrayList of
PendingIntents (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"). |
| IllegalArgumentException | if destinationAddress or data are empty |
|---|
Send a text based SMS.
| 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_FAILURERESULT_ERROR_RADIO_OFFRESULT_ERROR_NULL_PDUFor RESULT_ERROR_GENERIC_FAILURE the sentIntent may include
the extra "errorCode" containing a radio technology specific value,
generally only useful for troubleshooting.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"). |
| IllegalArgumentException | if destinationAddress or text are empty |
|---|