262 lines
11 KiB
Java
262 lines
11 KiB
Java
|
/*
|
||
|
|
* Copyright (C) 2007 The Android Open Source Project
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
package android.telephony.gsm;
|
||
|
|
|
||
|
|
import android.app.PendingIntent;
|
||
|
|
|
||
|
|
import java.util.ArrayList;
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Manages SMS operations such as sending data, text, and pdu SMS messages.
|
||
|
|
* Get this object by calling the static method SmsManager.getDefault().
|
||
|
|
* @deprecated Replaced by android.telephony.SmsManager that supports both GSM and CDMA.
|
||
|
|
*/
|
||
|
|
@Deprecated public final class SmsManager {
|
||
|
|
private static SmsManager sInstance;
|
||
|
|
private android.telephony.SmsManager mSmsMgrProxy;
|
||
|
|
|
||
|
|
/** Get the default instance of the SmsManager
|
||
|
|
*
|
||
|
|
* @return the default instance of the SmsManager
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public static final SmsManager getDefault() {
|
||
|
|
if (sInstance == null) {
|
||
|
|
sInstance = new SmsManager();
|
||
|
|
}
|
||
|
|
return sInstance;
|
||
|
|
}
|
||
|
|
|
||
|
|
@Deprecated
|
||
|
|
private SmsManager() {
|
||
|
|
mSmsMgrProxy = android.telephony.SmsManager.getDefault();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Send a text based SMS.
|
||
|
|
*
|
||
|
|
* @param destinationAddress the address to send the message to
|
||
|
|
* @param scAddress is the service center address or null to use
|
||
|
|
* the current default SMSC
|
||
|
|
* @param text the body of the message to send
|
||
|
|
* @param sentIntent if not NULL this <code>PendingIntent</code> is
|
||
|
|
* broadcast when the message is successfully sent, or failed.
|
||
|
|
* The result code will be <code>Activity.RESULT_OK<code> for success,
|
||
|
|
* or one of these errors:
|
||
|
|
* <code>RESULT_ERROR_GENERIC_FAILURE</code>
|
||
|
|
* <code>RESULT_ERROR_RADIO_OFF</code>
|
||
|
|
* <code>RESULT_ERROR_NULL_PDU</code>.
|
||
|
|
* 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.
|
||
|
|
* @param deliveryIntent if not NULL this <code>PendingIntent</code> 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
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final void sendTextMessage(
|
||
|
|
String destinationAddress, String scAddress, String text,
|
||
|
|
PendingIntent sentIntent, PendingIntent deliveryIntent) {
|
||
|
|
mSmsMgrProxy.sendTextMessage(destinationAddress, scAddress, text,
|
||
|
|
sentIntent, deliveryIntent);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Divide a text message into several messages, none bigger than
|
||
|
|
* the maximum SMS message size.
|
||
|
|
*
|
||
|
|
* @param text the original message. Must not be null.
|
||
|
|
* @return an <code>ArrayList</code> of strings that, in order,
|
||
|
|
* comprise the original message
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final ArrayList<String> divideMessage(String text) {
|
||
|
|
return mSmsMgrProxy.divideMessage(text);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Send a multi-part text based SMS. The callee should have already
|
||
|
|
* divided the message into correctly sized parts by calling
|
||
|
|
* <code>divideMessage</code>.
|
||
|
|
*
|
||
|
|
* @param destinationAddress the address to send the message to
|
||
|
|
* @param scAddress is the service center address or null to use
|
||
|
|
* the current default SMSC
|
||
|
|
* @param parts an <code>ArrayList</code> of strings that, in order,
|
||
|
|
* comprise the original message
|
||
|
|
* @param sentIntents if not null, an <code>ArrayList</code> of
|
||
|
|
* <code>PendingIntent</code>s (one for each message part) that is
|
||
|
|
* broadcast when the corresponding message part has been sent.
|
||
|
|
* The result code will be <code>Activity.RESULT_OK<code> for success,
|
||
|
|
* or one of these errors:
|
||
|
|
* <code>RESULT_ERROR_GENERIC_FAILURE</code>
|
||
|
|
* <code>RESULT_ERROR_RADIO_OFF</code>
|
||
|
|
* <code>RESULT_ERROR_NULL_PDU</code>.
|
||
|
|
* 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.
|
||
|
|
* @param deliveryIntents if not null, an <code>ArrayList</code> of
|
||
|
|
* <code>PendingIntent</code>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
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final void sendMultipartTextMessage(
|
||
|
|
String destinationAddress, String scAddress, ArrayList<String> parts,
|
||
|
|
ArrayList<PendingIntent> sentIntents, ArrayList<PendingIntent> deliveryIntents) {
|
||
|
|
mSmsMgrProxy.sendMultipartTextMessage(destinationAddress, scAddress, parts,
|
||
|
|
sentIntents, deliveryIntents);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Send a data based SMS to a specific application port.
|
||
|
|
*
|
||
|
|
* @param destinationAddress the address to send the message to
|
||
|
|
* @param scAddress is the service center address or null to use
|
||
|
|
* the current default SMSC
|
||
|
|
* @param destinationPort the port to deliver the message to
|
||
|
|
* @param data the body of the message to send
|
||
|
|
* @param sentIntent if not NULL this <code>PendingIntent</code> is
|
||
|
|
* broadcast when the message is sucessfully sent, or failed.
|
||
|
|
* The result code will be <code>Activity.RESULT_OK<code> for success,
|
||
|
|
* or one of these errors:
|
||
|
|
* <code>RESULT_ERROR_GENERIC_FAILURE</code>
|
||
|
|
* <code>RESULT_ERROR_RADIO_OFF</code>
|
||
|
|
* <code>RESULT_ERROR_NULL_PDU</code>.
|
||
|
|
* 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.
|
||
|
|
* @param deliveryIntent if not NULL this <code>PendingIntent</code> 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
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final void sendDataMessage(
|
||
|
|
String destinationAddress, String scAddress, short destinationPort,
|
||
|
|
byte[] data, PendingIntent sentIntent, PendingIntent deliveryIntent) {
|
||
|
|
mSmsMgrProxy.sendDataMessage(destinationAddress, scAddress, destinationPort,
|
||
|
|
data, sentIntent, deliveryIntent);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Copy a raw SMS PDU to the SIM.
|
||
|
|
*
|
||
|
|
* @param smsc the SMSC for this message, or NULL for the default SMSC
|
||
|
|
* @param pdu the raw PDU to store
|
||
|
|
* @param status message status (STATUS_ON_SIM_READ, STATUS_ON_SIM_UNREAD,
|
||
|
|
* STATUS_ON_SIM_SENT, STATUS_ON_SIM_UNSENT)
|
||
|
|
* @return true for success
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
* {@hide}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final boolean copyMessageToSim(byte[] smsc, byte[] pdu, int status) {
|
||
|
|
return mSmsMgrProxy.copyMessageToIcc(smsc, pdu, status);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Delete the specified message from the SIM.
|
||
|
|
*
|
||
|
|
* @param messageIndex is the record index of the message on SIM
|
||
|
|
* @return true for success
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
* {@hide}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final boolean deleteMessageFromSim(int messageIndex) {
|
||
|
|
return mSmsMgrProxy.deleteMessageFromIcc(messageIndex);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Update the specified message on the SIM.
|
||
|
|
*
|
||
|
|
* @param messageIndex record index of message to update
|
||
|
|
* @param newStatus new message status (STATUS_ON_SIM_READ,
|
||
|
|
* STATUS_ON_SIM_UNREAD, STATUS_ON_SIM_SENT,
|
||
|
|
* STATUS_ON_SIM_UNSENT, STATUS_ON_SIM_FREE)
|
||
|
|
* @param pdu the raw PDU to store
|
||
|
|
* @return true for success
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
* {@hide}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final boolean updateMessageOnSim(int messageIndex, int newStatus, byte[] pdu) {
|
||
|
|
return mSmsMgrProxy.updateMessageOnIcc(messageIndex, newStatus, pdu);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Retrieves all messages currently stored on SIM.
|
||
|
|
* @return <code>ArrayList</code> of <code>SmsMessage</code> objects
|
||
|
|
* @deprecated Use android.telephony.SmsManager.
|
||
|
|
* {@hide}
|
||
|
|
*/
|
||
|
|
@Deprecated
|
||
|
|
public final ArrayList<android.telephony.SmsMessage> getAllMessagesFromSim() {
|
||
|
|
return android.telephony.SmsManager.getDefault().getAllMessagesFromIcc();
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Free space (TS 51.011 10.5.3).
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int STATUS_ON_SIM_FREE = 0;
|
||
|
|
|
||
|
|
/** Received and read (TS 51.011 10.5.3).
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int STATUS_ON_SIM_READ = 1;
|
||
|
|
|
||
|
|
/** Received and unread (TS 51.011 10.5.3).
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int STATUS_ON_SIM_UNREAD = 3;
|
||
|
|
|
||
|
|
/** Stored and sent (TS 51.011 10.5.3).
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int STATUS_ON_SIM_SENT = 5;
|
||
|
|
|
||
|
|
/** Stored and unsent (TS 51.011 10.5.3).
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int STATUS_ON_SIM_UNSENT = 7;
|
||
|
|
|
||
|
|
/** Generic failure cause
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int RESULT_ERROR_GENERIC_FAILURE = 1;
|
||
|
|
|
||
|
|
/** Failed because radio was explicitly turned off
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int RESULT_ERROR_RADIO_OFF = 2;
|
||
|
|
|
||
|
|
/** Failed because no pdu provided
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int RESULT_ERROR_NULL_PDU = 3;
|
||
|
|
|
||
|
|
/** Failed because service is currently unavailable
|
||
|
|
* @deprecated Use android.telephony.SmsManager. */
|
||
|
|
@Deprecated static public final int RESULT_ERROR_NO_SERVICE = 4;
|
||
|
|
|
||
|
|
}
|