/*
 * Copyright (C) 2006 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.provider;

import android.annotation.RequiresPermission;
import android.annotation.SdkConstant;
import android.annotation.SdkConstant.SdkConstantType;
import android.annotation.TestApi;
import android.app.job.JobService;
import android.content.ComponentName;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.database.ContentObserver;
import android.database.sqlite.SqliteWrapper;
import android.net.Uri;
import android.telephony.Rlog;
import android.telephony.ServiceState;
import android.telephony.SmsMessage;
import android.telephony.SubscriptionManager;
import android.telephony.TelephonyManager;
import android.text.TextUtils;
import android.util.Patterns;

import com.android.internal.telephony.PhoneConstants;
import com.android.internal.telephony.SmsApplication;


import java.util.HashSet;
import java.util.Set;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

The Telephony provider contains data related to phone operation, specifically SMS and MMS messages, access to the APN list, including the MMSC to use, and the service state.

Note: These APIs are not available on all Android-powered devices. If your app depends on telephony features such as for managing SMS messages, include a <uses-feature> element in your manifest that declares the "android.hardware.telephony" hardware feature. Alternatively, you can check for telephony availability at runtime using either hasSystemFeature(PackageManager.FEATURE_TELEPHONY) or TelephonyManager.getPhoneType.

Creating an SMS app

Only the default SMS app (selected by the user in system settings) is able to write to the SMS Provider (the tables defined within the Telephony class) and only the default SMS app receives the Intents.SMS_DELIVER_ACTION broadcast when the user receives an SMS or the Intents.WAP_PUSH_DELIVER_ACTION broadcast when the user receives an MMS.

Any app that wants to behave as the user's default SMS app must handle the following intents:

  • In a broadcast receiver, include an intent filter for Intents.SMS_DELIVER_ACTION ("android.provider.Telephony.SMS_DELIVER"). The broadcast receiver must also require the BROADCAST_SMS.BROADCAST_SMS permission.

    This allows your app to directly receive incoming SMS messages.

  • In a broadcast receiver, include an intent filter for Intents.WAP_PUSH_DELIVER_ACTION} ("android.provider.Telephony.WAP_PUSH_DELIVER") with the MIME type "application/vnd.wap.mms-message". The broadcast receiver must also require the BROADCAST_WAP_PUSH.BROADCAST_WAP_PUSH permission.

    This allows your app to directly receive incoming MMS messages.

  • In your activity that delivers new messages, include an intent filter for Intent.ACTION_SENDTO ("android.intent.action.SENDTO" ) with schemas, sms:, smsto:, mms:, and mmsto:.

    This allows your app to receive intents from other apps that want to deliver a message.

  • In a service, include an intent filter for TelephonyManager.ACTION_RESPOND_VIA_MESSAGE ("android.intent.action.RESPOND_VIA_MESSAGE") with schemas, sms:, smsto:, mms:, and mmsto:. This service must also require the SEND_RESPOND_VIA_MESSAGE.SEND_RESPOND_VIA_MESSAGE permission.

    This allows users to respond to incoming phone calls with an immediate text message using your app.

Other apps that are not selected as the default SMS app can only read the SMS Provider, but may also be notified when a new SMS arrives by listening for the Intents.SMS_RECEIVED_ACTION broadcast, which is a non-abortable broadcast that may be delivered to multiple apps. This broadcast is intended for apps that—while not selected as the default SMS app—need to read special incoming messages such as to perform phone number verification.

For more information about building SMS apps, read the blog post, Getting Your SMS Apps Ready for KitKat.

/** * The Telephony provider contains data related to phone operation, specifically SMS and MMS * messages, access to the APN list, including the MMSC to use, and the service state. * * <p class="note"><strong>Note:</strong> These APIs are not available on all Android-powered * devices. If your app depends on telephony features such as for managing SMS messages, include * a <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code <uses-feature>} * </a> element in your manifest that declares the {@code "android.hardware.telephony"} hardware * feature. Alternatively, you can check for telephony availability at runtime using either * {@link android.content.pm.PackageManager#hasSystemFeature * hasSystemFeature(PackageManager.FEATURE_TELEPHONY)} or {@link * android.telephony.TelephonyManager#getPhoneType}.</p> * * <h3>Creating an SMS app</h3> * * <p>Only the default SMS app (selected by the user in system settings) is able to write to the * SMS Provider (the tables defined within the {@code Telephony} class) and only the default SMS * app receives the {@link android.provider.Telephony.Sms.Intents#SMS_DELIVER_ACTION} broadcast * when the user receives an SMS or the {@link * android.provider.Telephony.Sms.Intents#WAP_PUSH_DELIVER_ACTION} broadcast when the user * receives an MMS.</p> * * <p>Any app that wants to behave as the user's default SMS app must handle the following intents: * <ul> * <li>In a broadcast receiver, include an intent filter for {@link Sms.Intents#SMS_DELIVER_ACTION} * (<code>"android.provider.Telephony.SMS_DELIVER"</code>). The broadcast receiver must also * require the {@link android.Manifest.permission#BROADCAST_SMS} permission. * <p>This allows your app to directly receive incoming SMS messages.</p></li> * <li>In a broadcast receiver, include an intent filter for {@link * Sms.Intents#WAP_PUSH_DELIVER_ACTION}} ({@code "android.provider.Telephony.WAP_PUSH_DELIVER"}) * with the MIME type <code>"application/vnd.wap.mms-message"</code>. * The broadcast receiver must also require the {@link * android.Manifest.permission#BROADCAST_WAP_PUSH} permission. * <p>This allows your app to directly receive incoming MMS messages.</p></li> * <li>In your activity that delivers new messages, include an intent filter for * {@link android.content.Intent#ACTION_SENDTO} (<code>"android.intent.action.SENDTO" * </code>) with schemas, <code>sms:</code>, <code>smsto:</code>, <code>mms:</code>, and * <code>mmsto:</code>. * <p>This allows your app to receive intents from other apps that want to deliver a * message.</p></li> * <li>In a service, include an intent filter for {@link * android.telephony.TelephonyManager#ACTION_RESPOND_VIA_MESSAGE} * (<code>"android.intent.action.RESPOND_VIA_MESSAGE"</code>) with schemas, * <code>sms:</code>, <code>smsto:</code>, <code>mms:</code>, and <code>mmsto:</code>. * This service must also require the {@link * android.Manifest.permission#SEND_RESPOND_VIA_MESSAGE} permission. * <p>This allows users to respond to incoming phone calls with an immediate text message * using your app.</p></li> * </ul> * * <p>Other apps that are not selected as the default SMS app can only <em>read</em> the SMS * Provider, but may also be notified when a new SMS arrives by listening for the {@link * Sms.Intents#SMS_RECEIVED_ACTION} * broadcast, which is a non-abortable broadcast that may be delivered to multiple apps. This * broadcast is intended for apps that&mdash;while not selected as the default SMS app&mdash;need to * read special incoming messages such as to perform phone number verification.</p> * * <p>For more information about building SMS apps, read the blog post, <a * href="http://android-developers.blogspot.com/2013/10/getting-your-sms-apps-ready-for-kitkat.html" * >Getting Your SMS Apps Ready for KitKat</a>.</p> * */
public final class Telephony { private static final String TAG = "Telephony";
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Telephony() { }
Base columns for tables that contain text-based SMSs.
/** * Base columns for tables that contain text-based SMSs. */
public interface TextBasedSmsColumns {
Message type: all messages.
/** Message type: all messages. */
public static final int MESSAGE_TYPE_ALL = 0;
Message type: inbox.
/** Message type: inbox. */
public static final int MESSAGE_TYPE_INBOX = 1;
Message type: sent messages.
/** Message type: sent messages. */
public static final int MESSAGE_TYPE_SENT = 2;
Message type: drafts.
/** Message type: drafts. */
public static final int MESSAGE_TYPE_DRAFT = 3;
Message type: outbox.
/** Message type: outbox. */
public static final int MESSAGE_TYPE_OUTBOX = 4;
Message type: failed outgoing message.
/** Message type: failed outgoing message. */
public static final int MESSAGE_TYPE_FAILED = 5;
Message type: queued to send later.
/** Message type: queued to send later. */
public static final int MESSAGE_TYPE_QUEUED = 6;
The type of message.

Type: INTEGER

/** * The type of message. * <P>Type: INTEGER</P> */
public static final String TYPE = "type";
The thread ID of the message.

Type: INTEGER

/** * The thread ID of the message. * <P>Type: INTEGER</P> */
public static final String THREAD_ID = "thread_id";
The address of the other party.

Type: TEXT

/** * The address of the other party. * <P>Type: TEXT</P> */
public static final String ADDRESS = "address";
The date the message was received.

Type: INTEGER (long)

/** * The date the message was received. * <P>Type: INTEGER (long)</P> */
public static final String DATE = "date";
The date the message was sent.

Type: INTEGER (long)

/** * The date the message was sent. * <P>Type: INTEGER (long)</P> */
public static final String DATE_SENT = "date_sent";
Has the message been read?

Type: INTEGER (boolean)

/** * Has the message been read? * <P>Type: INTEGER (boolean)</P> */
public static final String READ = "read";
Has the message been seen by the user? The "seen" flag determines whether we need to show a notification.

Type: INTEGER (boolean)

/** * Has the message been seen by the user? The "seen" flag determines * whether we need to show a notification. * <P>Type: INTEGER (boolean)</P> */
public static final String SEEN = "seen";
TP-Status value for the message, or -1 if no status has been received.

Type: INTEGER

/** * {@code TP-Status} value for the message, or -1 if no status has been received. * <P>Type: INTEGER</P> */
public static final String STATUS = "status";
TP-Status: no status received.
/** TP-Status: no status received. */
public static final int STATUS_NONE = -1;
TP-Status: complete.
/** TP-Status: complete. */
public static final int STATUS_COMPLETE = 0;
TP-Status: pending.
/** TP-Status: pending. */
public static final int STATUS_PENDING = 32;
TP-Status: failed.
/** TP-Status: failed. */
public static final int STATUS_FAILED = 64;
The subject of the message, if present.

Type: TEXT

/** * The subject of the message, if present. * <P>Type: TEXT</P> */
public static final String SUBJECT = "subject";
The body of the message.

Type: TEXT

/** * The body of the message. * <P>Type: TEXT</P> */
public static final String BODY = "body";
The ID of the sender of the conversation, if present.

Type: INTEGER (reference to item in content://contacts/people)

/** * The ID of the sender of the conversation, if present. * <P>Type: INTEGER (reference to item in {@code content://contacts/people})</P> */
public static final String PERSON = "person";
The protocol identifier code.

Type: INTEGER

/** * The protocol identifier code. * <P>Type: INTEGER</P> */
public static final String PROTOCOL = "protocol";
Is the TP-Reply-Path flag set?

Type: BOOLEAN

/** * Is the {@code TP-Reply-Path} flag set? * <P>Type: BOOLEAN</P> */
public static final String REPLY_PATH_PRESENT = "reply_path_present";
The service center (SC) through which to send the message, if present.

Type: TEXT

/** * The service center (SC) through which to send the message, if present. * <P>Type: TEXT</P> */
public static final String SERVICE_CENTER = "service_center";
Is the message locked?

Type: INTEGER (boolean)

/** * Is the message locked? * <P>Type: INTEGER (boolean)</P> */
public static final String LOCKED = "locked";
The subscription to which the message belongs to. Its value will be < 0 if the sub id cannot be determined.

Type: INTEGER (long)

/** * The subscription to which the message belongs to. Its value will be * < 0 if the sub id cannot be determined. * <p>Type: INTEGER (long) </p> */
public static final String SUBSCRIPTION_ID = "sub_id";
The MTU size of the mobile interface to which the APN connected
@hide
/** * The MTU size of the mobile interface to which the APN connected * @hide */
public static final String MTU = "mtu";
Error code associated with sending or receiving this message

Type: INTEGER

/** * Error code associated with sending or receiving this message * <P>Type: INTEGER</P> */
public static final String ERROR_CODE = "error_code";
The identity of the sender of a sent message. It is usually the package name of the app which sends the message.

Note: This column is read-only. It is set by the provider and can not be changed by apps.

Type: TEXT

/** * The identity of the sender of a sent message. It is * usually the package name of the app which sends the message. * <p class="note"><strong>Note:</strong> * This column is read-only. It is set by the provider and can not be changed by apps. * <p>Type: TEXT</p> */
public static final String CREATOR = "creator"; }
Contains all text-based SMS messages.
/** * Contains all text-based SMS messages. */
public static final class Sms implements BaseColumns, TextBasedSmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Sms() { }
Used to determine the currently configured default SMS package.
Params:
  • context – context of the requesting application
Returns:package name for the default SMS package or null
/** * Used to determine the currently configured default SMS package. * @param context context of the requesting application * @return package name for the default SMS package or null */
public static String getDefaultSmsPackage(Context context) { ComponentName component = SmsApplication.getDefaultSmsApplication(context, false); if (component != null) { return component.getPackageName(); } return null; }
Return cursor for table query.
@hide
/** * Return cursor for table query. * @hide */
public static Cursor query(ContentResolver cr, String[] projection) { return cr.query(CONTENT_URI, projection, null, null, DEFAULT_SORT_ORDER); }
Return cursor for table query.
@hide
/** * Return cursor for table query. * @hide */
public static Cursor query(ContentResolver cr, String[] projection, String where, String orderBy) { return cr.query(CONTENT_URI, projection, where, null, orderBy == null ? DEFAULT_SORT_ORDER : orderBy); }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://sms");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC";
Add an SMS to the given URI.
Params:
  • resolver – the content resolver to use
  • uri – the URI to add the message to
  • address – the address of the sender
  • body – the body of the message
  • subject – the pseudo-subject of the message
  • date – the timestamp for the message
  • read – true if the message has been read, false if not
  • deliveryReport – true if a delivery report was requested, false if not
Returns:the URI for the new message
@hide
/** * Add an SMS to the given URI. * * @param resolver the content resolver to use * @param uri the URI to add the message to * @param address the address of the sender * @param body the body of the message * @param subject the pseudo-subject of the message * @param date the timestamp for the message * @param read true if the message has been read, false if not * @param deliveryReport true if a delivery report was requested, false if not * @return the URI for the new message * @hide */
public static Uri addMessageToUri(ContentResolver resolver, Uri uri, String address, String body, String subject, Long date, boolean read, boolean deliveryReport) { return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), resolver, uri, address, body, subject, date, read, deliveryReport, -1L); }
Add an SMS to the given URI.
Params:
  • resolver – the content resolver to use
  • uri – the URI to add the message to
  • address – the address of the sender
  • body – the body of the message
  • subject – the psuedo-subject of the message
  • date – the timestamp for the message
  • read – true if the message has been read, false if not
  • deliveryReport – true if a delivery report was requested, false if not
  • subId – the subscription which the message belongs to
Returns:the URI for the new message
@hide
/** * Add an SMS to the given URI. * * @param resolver the content resolver to use * @param uri the URI to add the message to * @param address the address of the sender * @param body the body of the message * @param subject the psuedo-subject of the message * @param date the timestamp for the message * @param read true if the message has been read, false if not * @param deliveryReport true if a delivery report was requested, false if not * @param subId the subscription which the message belongs to * @return the URI for the new message * @hide */
public static Uri addMessageToUri(int subId, ContentResolver resolver, Uri uri, String address, String body, String subject, Long date, boolean read, boolean deliveryReport) { return addMessageToUri(subId, resolver, uri, address, body, subject, date, read, deliveryReport, -1L); }
Add an SMS to the given URI with the specified thread ID.
Params:
  • resolver – the content resolver to use
  • uri – the URI to add the message to
  • address – the address of the sender
  • body – the body of the message
  • subject – the pseudo-subject of the message
  • date – the timestamp for the message
  • read – true if the message has been read, false if not
  • deliveryReport – true if a delivery report was requested, false if not
  • threadId – the thread_id of the message
Returns:the URI for the new message
@hide
/** * Add an SMS to the given URI with the specified thread ID. * * @param resolver the content resolver to use * @param uri the URI to add the message to * @param address the address of the sender * @param body the body of the message * @param subject the pseudo-subject of the message * @param date the timestamp for the message * @param read true if the message has been read, false if not * @param deliveryReport true if a delivery report was requested, false if not * @param threadId the thread_id of the message * @return the URI for the new message * @hide */
public static Uri addMessageToUri(ContentResolver resolver, Uri uri, String address, String body, String subject, Long date, boolean read, boolean deliveryReport, long threadId) { return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), resolver, uri, address, body, subject, date, read, deliveryReport, threadId); }
Add an SMS to the given URI with thread_id specified.
Params:
  • resolver – the content resolver to use
  • uri – the URI to add the message to
  • address – the address of the sender
  • body – the body of the message
  • subject – the psuedo-subject of the message
  • date – the timestamp for the message
  • read – true if the message has been read, false if not
  • deliveryReport – true if a delivery report was requested, false if not
  • threadId – the thread_id of the message
  • subId – the subscription which the message belongs to
Returns:the URI for the new message
@hide
/** * Add an SMS to the given URI with thread_id specified. * * @param resolver the content resolver to use * @param uri the URI to add the message to * @param address the address of the sender * @param body the body of the message * @param subject the psuedo-subject of the message * @param date the timestamp for the message * @param read true if the message has been read, false if not * @param deliveryReport true if a delivery report was requested, false if not * @param threadId the thread_id of the message * @param subId the subscription which the message belongs to * @return the URI for the new message * @hide */
public static Uri addMessageToUri(int subId, ContentResolver resolver, Uri uri, String address, String body, String subject, Long date, boolean read, boolean deliveryReport, long threadId) { ContentValues values = new ContentValues(8); Rlog.v(TAG,"Telephony addMessageToUri sub id: " + subId); values.put(SUBSCRIPTION_ID, subId); values.put(ADDRESS, address); if (date != null) { values.put(DATE, date); } values.put(READ, read ? Integer.valueOf(1) : Integer.valueOf(0)); values.put(SUBJECT, subject); values.put(BODY, body); if (deliveryReport) { values.put(STATUS, STATUS_PENDING); } if (threadId != -1L) { values.put(THREAD_ID, threadId); } return resolver.insert(uri, values); }
Move a message to the given folder.
Params:
  • context – the context to use
  • uri – the message to move
  • folder – the folder to move to
Returns:true if the operation succeeded
@hide
/** * Move a message to the given folder. * * @param context the context to use * @param uri the message to move * @param folder the folder to move to * @return true if the operation succeeded * @hide */
public static boolean moveMessageToFolder(Context context, Uri uri, int folder, int error) { if (uri == null) { return false; } boolean markAsUnread = false; boolean markAsRead = false; switch(folder) { case MESSAGE_TYPE_INBOX: case MESSAGE_TYPE_DRAFT: break; case MESSAGE_TYPE_OUTBOX: case MESSAGE_TYPE_SENT: markAsRead = true; break; case MESSAGE_TYPE_FAILED: case MESSAGE_TYPE_QUEUED: markAsUnread = true; break; default: return false; } ContentValues values = new ContentValues(3); values.put(TYPE, folder); if (markAsUnread) { values.put(READ, 0); } else if (markAsRead) { values.put(READ, 1); } values.put(ERROR_CODE, error); return 1 == SqliteWrapper.update(context, context.getContentResolver(), uri, values, null, null); }
Returns true iff the folder (message type) identifies an outgoing message.
@hide
/** * Returns true iff the folder (message type) identifies an * outgoing message. * @hide */
public static boolean isOutgoingFolder(int messageType) { return (messageType == MESSAGE_TYPE_FAILED) || (messageType == MESSAGE_TYPE_OUTBOX) || (messageType == MESSAGE_TYPE_SENT) || (messageType == MESSAGE_TYPE_QUEUED); }
Contains all text-based SMS messages in the SMS app inbox.
/** * Contains all text-based SMS messages in the SMS app inbox. */
public static final class Inbox implements BaseColumns, TextBasedSmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Inbox() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://sms/inbox");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC";
Add an SMS to the Draft box.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the pseudo-subject of the message
  • date – the timestamp for the message
  • read – true if the message has been read, false if not
Returns:the URI for the new message
@hide
/** * Add an SMS to the Draft box. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the pseudo-subject of the message * @param date the timestamp for the message * @param read true if the message has been read, false if not * @return the URI for the new message * @hide */
public static Uri addMessage(ContentResolver resolver, String address, String body, String subject, Long date, boolean read) { return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), resolver, CONTENT_URI, address, body, subject, date, read, false); }
Add an SMS to the Draft box.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the psuedo-subject of the message
  • date – the timestamp for the message
  • read – true if the message has been read, false if not
  • subId – the subscription which the message belongs to
Returns:the URI for the new message
@hide
/** * Add an SMS to the Draft box. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the psuedo-subject of the message * @param date the timestamp for the message * @param read true if the message has been read, false if not * @param subId the subscription which the message belongs to * @return the URI for the new message * @hide */
public static Uri addMessage(int subId, ContentResolver resolver, String address, String body, String subject, Long date, boolean read) { return addMessageToUri(subId, resolver, CONTENT_URI, address, body, subject, date, read, false); } }
Contains all sent text-based SMS messages in the SMS app.
/** * Contains all sent text-based SMS messages in the SMS app. */
public static final class Sent implements BaseColumns, TextBasedSmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Sent() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://sms/sent");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC";
Add an SMS to the Draft box.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the pseudo-subject of the message
  • date – the timestamp for the message
Returns:the URI for the new message
@hide
/** * Add an SMS to the Draft box. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the pseudo-subject of the message * @param date the timestamp for the message * @return the URI for the new message * @hide */
public static Uri addMessage(ContentResolver resolver, String address, String body, String subject, Long date) { return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), resolver, CONTENT_URI, address, body, subject, date, true, false); }
Add an SMS to the Draft box.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the psuedo-subject of the message
  • date – the timestamp for the message
  • subId – the subscription which the message belongs to
Returns:the URI for the new message
@hide
/** * Add an SMS to the Draft box. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the psuedo-subject of the message * @param date the timestamp for the message * @param subId the subscription which the message belongs to * @return the URI for the new message * @hide */
public static Uri addMessage(int subId, ContentResolver resolver, String address, String body, String subject, Long date) { return addMessageToUri(subId, resolver, CONTENT_URI, address, body, subject, date, true, false); } }
Contains all sent text-based SMS messages in the SMS app.
/** * Contains all sent text-based SMS messages in the SMS app. */
public static final class Draft implements BaseColumns, TextBasedSmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Draft() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://sms/draft");
@hide
/** * @hide */
public static Uri addMessage(ContentResolver resolver, String address, String body, String subject, Long date) { return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), resolver, CONTENT_URI, address, body, subject, date, true, false); }
Add an SMS to the Draft box.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the psuedo-subject of the message
  • date – the timestamp for the message
  • subId – the subscription which the message belongs to
Returns:the URI for the new message
@hide
/** * Add an SMS to the Draft box. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the psuedo-subject of the message * @param date the timestamp for the message * @param subId the subscription which the message belongs to * @return the URI for the new message * @hide */
public static Uri addMessage(int subId, ContentResolver resolver, String address, String body, String subject, Long date) { return addMessageToUri(subId, resolver, CONTENT_URI, address, body, subject, date, true, false); }
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC"; }
Contains all pending outgoing text-based SMS messages.
/** * Contains all pending outgoing text-based SMS messages. */
public static final class Outbox implements BaseColumns, TextBasedSmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Outbox() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://sms/outbox");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC";
Add an SMS to the outbox.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the pseudo-subject of the message
  • date – the timestamp for the message
  • deliveryReport – whether a delivery report was requested for the message
Returns:the URI for the new message
@hide
/** * Add an SMS to the outbox. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the pseudo-subject of the message * @param date the timestamp for the message * @param deliveryReport whether a delivery report was requested for the message * @return the URI for the new message * @hide */
public static Uri addMessage(ContentResolver resolver, String address, String body, String subject, Long date, boolean deliveryReport, long threadId) { return addMessageToUri(SubscriptionManager.getDefaultSmsSubscriptionId(), resolver, CONTENT_URI, address, body, subject, date, true, deliveryReport, threadId); }
Add an SMS to the Out box.
Params:
  • resolver – the content resolver to use
  • address – the address of the sender
  • body – the body of the message
  • subject – the psuedo-subject of the message
  • date – the timestamp for the message
  • deliveryReport – whether a delivery report was requested for the message
  • subId – the subscription which the message belongs to
Returns:the URI for the new message
@hide
/** * Add an SMS to the Out box. * * @param resolver the content resolver to use * @param address the address of the sender * @param body the body of the message * @param subject the psuedo-subject of the message * @param date the timestamp for the message * @param deliveryReport whether a delivery report was requested for the message * @param subId the subscription which the message belongs to * @return the URI for the new message * @hide */
public static Uri addMessage(int subId, ContentResolver resolver, String address, String body, String subject, Long date, boolean deliveryReport, long threadId) { return addMessageToUri(subId, resolver, CONTENT_URI, address, body, subject, date, true, deliveryReport, threadId); } }
Contains all sent text-based SMS messages in the SMS app.
/** * Contains all sent text-based SMS messages in the SMS app. */
public static final class Conversations implements BaseColumns, TextBasedSmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Conversations() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://sms/conversations");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC";
The first 45 characters of the body of the message.

Type: TEXT

/** * The first 45 characters of the body of the message. * <P>Type: TEXT</P> */
public static final String SNIPPET = "snippet";
The number of messages in the conversation.

Type: INTEGER

/** * The number of messages in the conversation. * <P>Type: INTEGER</P> */
public static final String MESSAGE_COUNT = "msg_count"; }
Contains constants for SMS related Intents that are broadcast.
/** * Contains constants for SMS related Intents that are broadcast. */
public static final class Intents {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Intents() { }
Set by BroadcastReceiver to indicate that the message was handled successfully.
/** * Set by BroadcastReceiver to indicate that the message was handled * successfully. */
public static final int RESULT_SMS_HANDLED = 1;
Set by BroadcastReceiver to indicate a generic error while processing the message.
/** * Set by BroadcastReceiver to indicate a generic error while * processing the message. */
public static final int RESULT_SMS_GENERIC_ERROR = 2;
Set by BroadcastReceiver to indicate insufficient memory to store the message.
/** * Set by BroadcastReceiver to indicate insufficient memory to store * the message. */
public static final int RESULT_SMS_OUT_OF_MEMORY = 3;
Set by BroadcastReceiver to indicate that the message, while possibly valid, is of a format or encoding that is not supported.
/** * Set by BroadcastReceiver to indicate that the message, while * possibly valid, is of a format or encoding that is not * supported. */
public static final int RESULT_SMS_UNSUPPORTED = 4;
Set by BroadcastReceiver to indicate a duplicate incoming message.
/** * Set by BroadcastReceiver to indicate a duplicate incoming message. */
public static final int RESULT_SMS_DUPLICATED = 5;
Activity action: Ask the user to change the default SMS application. This will show a dialog that asks the user whether they want to replace the current default SMS application with the one specified in EXTRA_PACKAGE_NAME.
/** * Activity action: Ask the user to change the default * SMS application. This will show a dialog that asks the * user whether they want to replace the current default * SMS application with the one specified in * {@link #EXTRA_PACKAGE_NAME}. */
@SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) public static final String ACTION_CHANGE_DEFAULT = "android.provider.Telephony.ACTION_CHANGE_DEFAULT";
The PackageName string passed in as an extra for ACTION_CHANGE_DEFAULT
See Also:
/** * The PackageName string passed in as an * extra for {@link #ACTION_CHANGE_DEFAULT} * * @see #ACTION_CHANGE_DEFAULT */
public static final String EXTRA_PACKAGE_NAME = "package";
Broadcast Action: A new text-based SMS message has been received by the device. This intent will only be delivered to the default sms app. That app is responsible for writing the message and notifying the user. The intent will have the following extra values:

  • "pdus" - An Object[] of byte[]s containing the PDUs that make up the message.
  • "format" - A String describing the format of the PDUs. It can be either "3gpp" or "3gpp2".
  • "subscription" - An optional long value of the subscription id which received the message.
  • "slot" - An optional int value of the SIM slot containing the subscription.
  • "phone" - An optional int value of the phone id associated with the subscription.
  • "errorCode" - An optional int error code associated with receiving the message.

The extra values can be extracted using getMessagesFromIntent(Intent).

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

Note: The broadcast receiver that filters for this intent must declare BROADCAST_SMS.BROADCAST_SMS as a required permission in the <receiver> tag.

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: A new text-based SMS message has been received * by the device. This intent will only be delivered to the default * sms app. That app is responsible for writing the message and notifying * the user. The intent will have the following extra values:</p> * * <ul> * <li><em>"pdus"</em> - An Object[] of byte[]s containing the PDUs * that make up the message.</li> * <li><em>"format"</em> - A String describing the format of the PDUs. It can * be either "3gpp" or "3gpp2".</li> * <li><em>"subscription"</em> - An optional long value of the subscription id which * received the message.</li> * <li><em>"slot"</em> - An optional int value of the SIM slot containing the * subscription.</li> * <li><em>"phone"</em> - An optional int value of the phone id associated with the * subscription.</li> * <li><em>"errorCode"</em> - An optional int error code associated with receiving * the message.</li> * </ul> * * <p>The extra values can be extracted using * {@link #getMessagesFromIntent(Intent)}.</p> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p class="note"><strong>Note:</strong> * The broadcast receiver that filters for this intent must declare * {@link android.Manifest.permission#BROADCAST_SMS} as a required permission in * the <a href="{@docRoot}guide/topics/manifest/receiver-element.html">{@code * <receiver>}</a> tag. * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SMS_DELIVER_ACTION = "android.provider.Telephony.SMS_DELIVER";
Broadcast Action: A new text-based SMS message has been received by the device. This intent will be delivered to all registered receivers as a notification. These apps are not expected to write the message or notify the user. The intent will have the following extra values:

  • "pdus" - An Object[] of byte[]s containing the PDUs that make up the message.

The extra values can be extracted using getMessagesFromIntent(Intent).

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: A new text-based SMS message has been received * by the device. This intent will be delivered to all registered * receivers as a notification. These apps are not expected to write the * message or notify the user. The intent will have the following extra * values:</p> * * <ul> * <li><em>"pdus"</em> - An Object[] of byte[]s containing the PDUs * that make up the message.</li> * </ul> * * <p>The extra values can be extracted using * {@link #getMessagesFromIntent(Intent)}.</p> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SMS_RECEIVED_ACTION = "android.provider.Telephony.SMS_RECEIVED";
Broadcast Action: A new data based SMS message has been received by the device. This intent will be delivered to all registered receivers as a notification. The intent will have the following extra values:

  • "pdus" - An Object[] of byte[]s containing the PDUs that make up the message.

The extra values can be extracted using getMessagesFromIntent(Intent).

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: A new data based SMS message has been received * by the device. This intent will be delivered to all registered * receivers as a notification. The intent will have the following extra * values:</p> * * <ul> * <li><em>"pdus"</em> - An Object[] of byte[]s containing the PDUs * that make up the message.</li> * </ul> * * <p>The extra values can be extracted using * {@link #getMessagesFromIntent(Intent)}.</p> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String DATA_SMS_RECEIVED_ACTION = "android.intent.action.DATA_SMS_RECEIVED";
Broadcast Action: A new WAP PUSH message has been received by the device. This intent will only be delivered to the default sms app. That app is responsible for writing the message and notifying the user. The intent will have the following extra values:

  • "transactionId" - (Integer) The WAP transaction ID
  • "pduType" - (Integer) The WAP PDU type
  • "header" - (byte[]) The header of the message
  • "data" - (byte[]) The data payload of the message
  • "contentTypeParameters" -(HashMap<String,String>) Any parameters associated with the content type (decoded from the WSP Content-Type header)
  • "subscription" - An optional long value of the subscription id which received the message.
  • "slot" - An optional int value of the SIM slot containing the subscription.
  • "phone" - An optional int value of the phone id associated with the subscription.

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

The contentTypeParameters extra value is map of content parameters keyed by their names.

If any unassigned well-known parameters are encountered, the key of the map will be 'unassigned/0x...', where '...' is the hex value of the unassigned parameter. If a parameter has No-Value the value in the map will be null.

Requires RECEIVE_MMS.RECEIVE_MMS or RECEIVE_WAP_PUSH.RECEIVE_WAP_PUSH (depending on WAP PUSH type) to receive.

Note: The broadcast receiver that filters for this intent must declare BROADCAST_WAP_PUSH.BROADCAST_WAP_PUSH as a required permission in the <receiver> tag.

/** * Broadcast Action: A new WAP PUSH message has been received by the * device. This intent will only be delivered to the default * sms app. That app is responsible for writing the message and notifying * the user. The intent will have the following extra values:</p> * * <ul> * <li><em>"transactionId"</em> - (Integer) The WAP transaction ID</li> * <li><em>"pduType"</em> - (Integer) The WAP PDU type</li> * <li><em>"header"</em> - (byte[]) The header of the message</li> * <li><em>"data"</em> - (byte[]) The data payload of the message</li> * <li><em>"contentTypeParameters" </em> * -(HashMap&lt;String,String&gt;) Any parameters associated with the content type * (decoded from the WSP Content-Type header)</li> * <li><em>"subscription"</em> - An optional long value of the subscription id which * received the message.</li> * <li><em>"slot"</em> - An optional int value of the SIM slot containing the * subscription.</li> * <li><em>"phone"</em> - An optional int value of the phone id associated with the * subscription.</li> * </ul> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>The contentTypeParameters extra value is map of content parameters keyed by * their names.</p> * * <p>If any unassigned well-known parameters are encountered, the key of the map will * be 'unassigned/0x...', where '...' is the hex value of the unassigned parameter. If * a parameter has No-Value the value in the map will be null.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_MMS} or * {@link android.Manifest.permission#RECEIVE_WAP_PUSH} (depending on WAP PUSH type) to * receive.</p> * * <p class="note"><strong>Note:</strong> * The broadcast receiver that filters for this intent must declare * {@link android.Manifest.permission#BROADCAST_WAP_PUSH} as a required permission in * the <a href="{@docRoot}guide/topics/manifest/receiver-element.html">{@code * <receiver>}</a> tag. */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String WAP_PUSH_DELIVER_ACTION = "android.provider.Telephony.WAP_PUSH_DELIVER";
Broadcast Action: A new WAP PUSH message has been received by the device. This intent will be delivered to all registered receivers as a notification. These apps are not expected to write the message or notify the user. The intent will have the following extra values:

  • "transactionId" - (Integer) The WAP transaction ID
  • "pduType" - (Integer) The WAP PDU type
  • "header" - (byte[]) The header of the message
  • "data" - (byte[]) The data payload of the message
  • "contentTypeParameters" - (HashMap<String,String>) Any parameters associated with the content type (decoded from the WSP Content-Type header)

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

The contentTypeParameters extra value is map of content parameters keyed by their names.

If any unassigned well-known parameters are encountered, the key of the map will be 'unassigned/0x...', where '...' is the hex value of the unassigned parameter. If a parameter has No-Value the value in the map will be null.

Requires RECEIVE_MMS.RECEIVE_MMS or RECEIVE_WAP_PUSH.RECEIVE_WAP_PUSH (depending on WAP PUSH type) to receive.

/** * Broadcast Action: A new WAP PUSH message has been received by the * device. This intent will be delivered to all registered * receivers as a notification. These apps are not expected to write the * message or notify the user. The intent will have the following extra * values:</p> * * <ul> * <li><em>"transactionId"</em> - (Integer) The WAP transaction ID</li> * <li><em>"pduType"</em> - (Integer) The WAP PDU type</li> * <li><em>"header"</em> - (byte[]) The header of the message</li> * <li><em>"data"</em> - (byte[]) The data payload of the message</li> * <li><em>"contentTypeParameters"</em> * - (HashMap&lt;String,String&gt;) Any parameters associated with the content type * (decoded from the WSP Content-Type header)</li> * </ul> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>The contentTypeParameters extra value is map of content parameters keyed by * their names.</p> * * <p>If any unassigned well-known parameters are encountered, the key of the map will * be 'unassigned/0x...', where '...' is the hex value of the unassigned parameter. If * a parameter has No-Value the value in the map will be null.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_MMS} or * {@link android.Manifest.permission#RECEIVE_WAP_PUSH} (depending on WAP PUSH type) to * receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String WAP_PUSH_RECEIVED_ACTION = "android.provider.Telephony.WAP_PUSH_RECEIVED";
Broadcast Action: A new Cell Broadcast message has been received by the device. The intent will have the following extra values:

  • "message" - An SmsCbMessage object containing the broadcast message data. This is not an emergency alert, so ETWS and CMAS data will be null.

The extra values can be extracted using getMessagesFromIntent(Intent).

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: A new Cell Broadcast message has been received * by the device. The intent will have the following extra * values:</p> * * <ul> * <li><em>"message"</em> - An SmsCbMessage object containing the broadcast message * data. This is not an emergency alert, so ETWS and CMAS data will be null.</li> * </ul> * * <p>The extra values can be extracted using * {@link #getMessagesFromIntent(Intent)}.</p> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SMS_CB_RECEIVED_ACTION = "android.provider.Telephony.SMS_CB_RECEIVED";
Action: A SMS based carrier provision intent. Used to identify default carrier provisioning app on the device.
@hide
/** * Action: A SMS based carrier provision intent. Used to identify default * carrier provisioning app on the device. * @hide */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) @TestApi public static final String SMS_CARRIER_PROVISION_ACTION = "android.provider.Telephony.SMS_CARRIER_PROVISION";
Broadcast Action: A new Emergency Broadcast message has been received by the device. The intent will have the following extra values:

  • "message" - An SmsCbMessage object containing the broadcast message data, including ETWS or CMAS warning notification info if present.

The extra values can be extracted using getMessagesFromIntent(Intent).

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

Requires RECEIVE_EMERGENCY_BROADCAST.RECEIVE_EMERGENCY_BROADCAST to receive.

@removed
/** * Broadcast Action: A new Emergency Broadcast message has been received * by the device. The intent will have the following extra * values:</p> * * <ul> * <li><em>"message"</em> - An SmsCbMessage object containing the broadcast message * data, including ETWS or CMAS warning notification info if present.</li> * </ul> * * <p>The extra values can be extracted using * {@link #getMessagesFromIntent(Intent)}.</p> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_EMERGENCY_BROADCAST} to * receive.</p> * @removed */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SMS_EMERGENCY_CB_RECEIVED_ACTION = "android.provider.Telephony.SMS_EMERGENCY_CB_RECEIVED";
Broadcast Action: A new CDMA SMS has been received containing Service Category Program Data (updates the list of enabled broadcast channels). The intent will have the following extra values:

  • "operations" - An array of CdmaSmsCbProgramData objects containing the service category operations (add/delete/clear) to perform.

The extra values can be extracted using getMessagesFromIntent(Intent).

If a BroadcastReceiver encounters an error while processing this intent it should set the result code appropriately.

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: A new CDMA SMS has been received containing Service Category * Program Data (updates the list of enabled broadcast channels). The intent will * have the following extra values:</p> * * <ul> * <li><em>"operations"</em> - An array of CdmaSmsCbProgramData objects containing * the service category operations (add/delete/clear) to perform.</li> * </ul> * * <p>The extra values can be extracted using * {@link #getMessagesFromIntent(Intent)}.</p> * * <p>If a BroadcastReceiver encounters an error while processing * this intent it should set the result code appropriately.</p> * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SMS_SERVICE_CATEGORY_PROGRAM_DATA_RECEIVED_ACTION = "android.provider.Telephony.SMS_SERVICE_CATEGORY_PROGRAM_DATA_RECEIVED";
Broadcast Action: The SIM storage for SMS messages is full. If space is not freed, messages targeted for the SIM (class 2) may not be saved.

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: The SIM storage for SMS messages is full. If * space is not freed, messages targeted for the SIM (class 2) may * not be saved. * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SIM_FULL_ACTION = "android.provider.Telephony.SIM_FULL";
Broadcast Action: An incoming SMS has been rejected by the telephony framework. This intent is sent in lieu of any of the RECEIVED_ACTION intents. The intent will have the following extra value:

Requires RECEIVE_SMS.RECEIVE_SMS to receive.

/** * Broadcast Action: An incoming SMS has been rejected by the * telephony framework. This intent is sent in lieu of any * of the RECEIVED_ACTION intents. The intent will have the * following extra value:</p> * * <ul> * <li><em>"result"</em> - An int result code, e.g. {@link #RESULT_SMS_OUT_OF_MEMORY} * indicating the error returned to the network.</li> * </ul> * * <p>Requires {@link android.Manifest.permission#RECEIVE_SMS} to receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SMS_REJECTED_ACTION = "android.provider.Telephony.SMS_REJECTED";
Broadcast Action: An incoming MMS has been downloaded. The intent is sent to all users, except for secondary users where SMS has been disabled and to managed profiles.
@hide
/** * Broadcast Action: An incoming MMS has been downloaded. The intent is sent to all * users, except for secondary users where SMS has been disabled and to managed * profiles. * @hide */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String MMS_DOWNLOADED_ACTION = "android.provider.Telephony.MMS_DOWNLOADED";
Broadcast Action: A debug code has been entered in the dialer. This intent is broadcast by the system and OEM telephony apps may need to receive these broadcasts. These "secret codes" are used to activate developer menus by dialing certain codes. And they are of the form *#*#&lt;code&gt;#*#*. The intent will have the data URI: android_secret_code://&lt;code&gt;. It is possible that a manifest receiver would be woken up even if it is not currently running.

Requires android.Manifest.permission#CONTROL_INCALL_EXPERIENCE to send and receive.

/** * Broadcast Action: A debug code has been entered in the dialer. This intent is * broadcast by the system and OEM telephony apps may need to receive these broadcasts. * These "secret codes" are used to activate developer menus by dialing certain codes. * And they are of the form {@code *#*#&lt;code&gt;#*#*}. The intent will have the data * URI: {@code android_secret_code://&lt;code&gt;}. It is possible that a manifest * receiver would be woken up even if it is not currently running. * * <p>Requires {@code android.Manifest.permission#CONTROL_INCALL_EXPERIENCE} to * send and receive.</p> */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String SECRET_CODE_ACTION = "android.provider.Telephony.SECRET_CODE";
Broadcast action: When the default SMS package changes, the previous default SMS package and the new default SMS package are sent this broadcast to notify them of the change. A boolean is specified in EXTRA_IS_DEFAULT_SMS_APP to indicate whether the package is the new default SMS package.
/** * Broadcast action: When the default SMS package changes, * the previous default SMS package and the new default SMS * package are sent this broadcast to notify them of the change. * A boolean is specified in {@link #EXTRA_IS_DEFAULT_SMS_APP} to * indicate whether the package is the new default SMS package. */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String ACTION_DEFAULT_SMS_PACKAGE_CHANGED = "android.provider.action.DEFAULT_SMS_PACKAGE_CHANGED";
The IsDefaultSmsApp boolean passed as an extra for ACTION_DEFAULT_SMS_PACKAGE_CHANGED to indicate whether the SMS app is becoming the default SMS app or is no longer the default.
See Also:
/** * The IsDefaultSmsApp boolean passed as an * extra for {@link #ACTION_DEFAULT_SMS_PACKAGE_CHANGED} to indicate whether the * SMS app is becoming the default SMS app or is no longer the default. * * @see #ACTION_DEFAULT_SMS_PACKAGE_CHANGED */
public static final String EXTRA_IS_DEFAULT_SMS_APP = "android.provider.extra.IS_DEFAULT_SMS_APP";
Broadcast action: When a change is made to the SmsProvider or MmsProvider by a process other than the default SMS application, this intent is broadcast to the default SMS application so it can re-sync or update the change. The uri that was used to call the provider can be retrieved from the intent with getData(). The actual affected uris (which would depend on the selection specified) are not included.
/** * Broadcast action: When a change is made to the SmsProvider or * MmsProvider by a process other than the default SMS application, * this intent is broadcast to the default SMS application so it can * re-sync or update the change. The uri that was used to call the provider * can be retrieved from the intent with getData(). The actual affected uris * (which would depend on the selection specified) are not included. */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String ACTION_EXTERNAL_PROVIDER_CHANGE = "android.provider.action.EXTERNAL_PROVIDER_CHANGE";
Broadcast action: When SMS-MMS db is being created. If file-based encryption is supported, this broadcast indicates creation of the db in credential-encrypted storage. A boolean is specified in EXTRA_IS_INITIAL_CREATE to indicate if this is the initial create of the db. Requires READ_SMS.READ_SMS to receive.
See Also:
@hide
/** * Broadcast action: When SMS-MMS db is being created. If file-based encryption is * supported, this broadcast indicates creation of the db in credential-encrypted * storage. A boolean is specified in {@link #EXTRA_IS_INITIAL_CREATE} to indicate if * this is the initial create of the db. Requires * {@link android.Manifest.permission#READ_SMS} to receive. * * @see #EXTRA_IS_INITIAL_CREATE * * @hide */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String ACTION_SMS_MMS_DB_CREATED = "android.provider.action.SMS_MMS_DB_CREATED";
Boolean flag passed as an extra with ACTION_SMS_MMS_DB_CREATED to indicate whether the DB creation is the initial creation on the device, that is it is after a factory-data reset or a new device. Any subsequent creations of the DB (which happens only in error scenarios) will have this flag set to false.
See Also:
@hide
/** * Boolean flag passed as an extra with {@link #ACTION_SMS_MMS_DB_CREATED} to indicate * whether the DB creation is the initial creation on the device, that is it is after a * factory-data reset or a new device. Any subsequent creations of the DB (which * happens only in error scenarios) will have this flag set to false. * * @see #ACTION_SMS_MMS_DB_CREATED * * @hide */
public static final String EXTRA_IS_INITIAL_CREATE = "android.provider.extra.IS_INITIAL_CREATE";
Broadcast intent action indicating that the telephony provider SMS MMS database is corrupted. A boolean is specified in EXTRA_IS_CORRUPTED to indicate if the database is corrupted. Requires the permission.
@hide
/** * Broadcast intent action indicating that the telephony provider SMS MMS database is * corrupted. A boolean is specified in {@link #EXTRA_IS_CORRUPTED} to indicate if the * database is corrupted. Requires the * {@link android.Manifest.permission#READ_PRIVILEGED_PHONE_STATE permission. * * @hide */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public static final String ACTION_SMS_MMS_DB_LOST = "android.provider.action.SMS_MMS_DB_LOST";
Boolean flag passed as an extra with ACTION_SMS_MMS_DB_LOST to indicate whether the DB got corrupted or not.
See Also:
@hide
/** * Boolean flag passed as an extra with {@link #ACTION_SMS_MMS_DB_LOST} to indicate * whether the DB got corrupted or not. * * @see #ACTION_SMS_MMS_DB_LOST * * @hide */
public static final String EXTRA_IS_CORRUPTED = "android.provider.extra.IS_CORRUPTED";
Read the PDUs out of an SMS_RECEIVED_ACTION or a DATA_SMS_RECEIVED_ACTION intent.
Params:
  • intent – the intent to read from
Returns:an array of SmsMessages for the PDUs
/** * Read the PDUs out of an {@link #SMS_RECEIVED_ACTION} or a * {@link #DATA_SMS_RECEIVED_ACTION} intent. * * @param intent the intent to read from * @return an array of SmsMessages for the PDUs */
public static SmsMessage[] getMessagesFromIntent(Intent intent) { Object[] messages; try { messages = (Object[]) intent.getSerializableExtra("pdus"); } catch (ClassCastException e) { Rlog.e(TAG, "getMessagesFromIntent: " + e); return null; } if (messages == null) { Rlog.e(TAG, "pdus does not exist in the intent"); return null; } String format = intent.getStringExtra("format"); int subId = intent.getIntExtra(PhoneConstants.SUBSCRIPTION_KEY, SubscriptionManager.getDefaultSmsSubscriptionId()); Rlog.v(TAG, " getMessagesFromIntent sub_id : " + subId); int pduCount = messages.length; SmsMessage[] msgs = new SmsMessage[pduCount]; for (int i = 0; i < pduCount; i++) { byte[] pdu = (byte[]) messages[i]; msgs[i] = SmsMessage.createFromPdu(pdu, format); if (msgs[i] != null) msgs[i].setSubId(subId); } return msgs; } } }
Base column for the table that contain Carrier Public key.
@hide
/** * Base column for the table that contain Carrier Public key. * @hide */
public interface CarrierColumns extends BaseColumns { public static final String MCC = "mcc"; public static final String MNC = "mnc"; public static final String KEY_TYPE = "key_type"; public static final String MVNO_TYPE = "mvno_type"; public static final String MVNO_MATCH_DATA = "mvno_match_data"; public static final String PUBLIC_KEY = "public_key"; public static final String KEY_IDENTIFIER = "key_identifier"; public static final String EXPIRATION_TIME = "expiration_time"; public static final String LAST_MODIFIED = "last_modified";
The content:// style URL for this table.
@hide
/** * The {@code content://} style URL for this table. * @hide */
public static final Uri CONTENT_URI = Uri.parse("content://carrier_information/carrier"); }
Base columns for tables that contain MMSs.
/** * Base columns for tables that contain MMSs. */
public interface BaseMmsColumns extends BaseColumns {
Message box: all messages.
/** Message box: all messages. */
public static final int MESSAGE_BOX_ALL = 0;
Message box: inbox.
/** Message box: inbox. */
public static final int MESSAGE_BOX_INBOX = 1;
Message box: sent messages.
/** Message box: sent messages. */
public static final int MESSAGE_BOX_SENT = 2;
Message box: drafts.
/** Message box: drafts. */
public static final int MESSAGE_BOX_DRAFTS = 3;
Message box: outbox.
/** Message box: outbox. */
public static final int MESSAGE_BOX_OUTBOX = 4;
Message box: failed.
/** Message box: failed. */
public static final int MESSAGE_BOX_FAILED = 5;
The thread ID of the message.

Type: INTEGER (long)

/** * The thread ID of the message. * <P>Type: INTEGER (long)</P> */
public static final String THREAD_ID = "thread_id";
The date the message was received.

Type: INTEGER (long)

/** * The date the message was received. * <P>Type: INTEGER (long)</P> */
public static final String DATE = "date";
The date the message was sent.

Type: INTEGER (long)

/** * The date the message was sent. * <P>Type: INTEGER (long)</P> */
public static final String DATE_SENT = "date_sent";
The box which the message belongs to, e.g. MESSAGE_BOX_INBOX.

Type: INTEGER

/** * The box which the message belongs to, e.g. {@link #MESSAGE_BOX_INBOX}. * <P>Type: INTEGER</P> */
public static final String MESSAGE_BOX = "msg_box";
Has the message been read?

Type: INTEGER (boolean)

/** * Has the message been read? * <P>Type: INTEGER (boolean)</P> */
public static final String READ = "read";
Has the message been seen by the user? The "seen" flag determines whether we need to show a new message notification.

Type: INTEGER (boolean)

/** * Has the message been seen by the user? The "seen" flag determines * whether we need to show a new message notification. * <P>Type: INTEGER (boolean)</P> */
public static final String SEEN = "seen";
Does the message have only a text part (can also have a subject) with no picture, slideshow, sound, etc. parts?

Type: INTEGER (boolean)

/** * Does the message have only a text part (can also have a subject) with * no picture, slideshow, sound, etc. parts? * <P>Type: INTEGER (boolean)</P> */
public static final String TEXT_ONLY = "text_only";
The Message-ID of the message.

Type: TEXT

/** * The {@code Message-ID} of the message. * <P>Type: TEXT</P> */
public static final String MESSAGE_ID = "m_id";
The subject of the message, if present.

Type: TEXT

/** * The subject of the message, if present. * <P>Type: TEXT</P> */
public static final String SUBJECT = "sub";
The character set of the subject, if present.

Type: INTEGER

/** * The character set of the subject, if present. * <P>Type: INTEGER</P> */
public static final String SUBJECT_CHARSET = "sub_cs";
The Content-Type of the message.

Type: TEXT

/** * The {@code Content-Type} of the message. * <P>Type: TEXT</P> */
public static final String CONTENT_TYPE = "ct_t";
The Content-Location of the message.

Type: TEXT

/** * The {@code Content-Location} of the message. * <P>Type: TEXT</P> */
public static final String CONTENT_LOCATION = "ct_l";
The expiry time of the message.

Type: INTEGER (long)

/** * The expiry time of the message. * <P>Type: INTEGER (long)</P> */
public static final String EXPIRY = "exp";
The class of the message.

Type: TEXT

/** * The class of the message. * <P>Type: TEXT</P> */
public static final String MESSAGE_CLASS = "m_cls";
The type of the message defined by MMS spec.

Type: INTEGER

/** * The type of the message defined by MMS spec. * <P>Type: INTEGER</P> */
public static final String MESSAGE_TYPE = "m_type";
The version of the specification that this message conforms to.

Type: INTEGER

/** * The version of the specification that this message conforms to. * <P>Type: INTEGER</P> */
public static final String MMS_VERSION = "v";
The size of the message.

Type: INTEGER

/** * The size of the message. * <P>Type: INTEGER</P> */
public static final String MESSAGE_SIZE = "m_size";
The priority of the message.

Type: INTEGER

/** * The priority of the message. * <P>Type: INTEGER</P> */
public static final String PRIORITY = "pri";
The read-report of the message.

Type: INTEGER (boolean)

/** * The {@code read-report} of the message. * <P>Type: INTEGER (boolean)</P> */
public static final String READ_REPORT = "rr";
Is read report allowed?

Type: INTEGER (boolean)

/** * Is read report allowed? * <P>Type: INTEGER (boolean)</P> */
public static final String REPORT_ALLOWED = "rpt_a";
The response-status of the message.

Type: INTEGER

/** * The {@code response-status} of the message. * <P>Type: INTEGER</P> */
public static final String RESPONSE_STATUS = "resp_st";
The status of the message.

Type: INTEGER

/** * The {@code status} of the message. * <P>Type: INTEGER</P> */
public static final String STATUS = "st";
The transaction-id of the message.

Type: TEXT

/** * The {@code transaction-id} of the message. * <P>Type: TEXT</P> */
public static final String TRANSACTION_ID = "tr_id";
The retrieve-status of the message.

Type: INTEGER

/** * The {@code retrieve-status} of the message. * <P>Type: INTEGER</P> */
public static final String RETRIEVE_STATUS = "retr_st";
The retrieve-text of the message.

Type: TEXT

/** * The {@code retrieve-text} of the message. * <P>Type: TEXT</P> */
public static final String RETRIEVE_TEXT = "retr_txt";
The character set of the retrieve-text.

Type: INTEGER

/** * The character set of the retrieve-text. * <P>Type: INTEGER</P> */
public static final String RETRIEVE_TEXT_CHARSET = "retr_txt_cs";
The read-status of the message.

Type: INTEGER

/** * The {@code read-status} of the message. * <P>Type: INTEGER</P> */
public static final String READ_STATUS = "read_status";
The content-class of the message.

Type: INTEGER

/** * The {@code content-class} of the message. * <P>Type: INTEGER</P> */
public static final String CONTENT_CLASS = "ct_cls";
The delivery-report of the message.

Type: INTEGER

/** * The {@code delivery-report} of the message. * <P>Type: INTEGER</P> */
public static final String DELIVERY_REPORT = "d_rpt";
The delivery-time-token of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code delivery-time-token} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String DELIVERY_TIME_TOKEN = "d_tm_tok";
The delivery-time of the message.

Type: INTEGER

/** * The {@code delivery-time} of the message. * <P>Type: INTEGER</P> */
public static final String DELIVERY_TIME = "d_tm";
The response-text of the message.

Type: TEXT

/** * The {@code response-text} of the message. * <P>Type: TEXT</P> */
public static final String RESPONSE_TEXT = "resp_txt";
The sender-visibility of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code sender-visibility} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String SENDER_VISIBILITY = "s_vis";
The reply-charging of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code reply-charging} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLY_CHARGING = "r_chg";
The reply-charging-deadline-token of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code reply-charging-deadline-token} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLY_CHARGING_DEADLINE_TOKEN = "r_chg_dl_tok";
The reply-charging-deadline of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code reply-charging-deadline} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLY_CHARGING_DEADLINE = "r_chg_dl";
The reply-charging-id of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code reply-charging-id} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLY_CHARGING_ID = "r_chg_id";
The reply-charging-size of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code reply-charging-size} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLY_CHARGING_SIZE = "r_chg_sz";
The previously-sent-by of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code previously-sent-by} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String PREVIOUSLY_SENT_BY = "p_s_by";
The previously-sent-date of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code previously-sent-date} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String PREVIOUSLY_SENT_DATE = "p_s_d";
The store of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code store} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String STORE = "store";
The mm-state of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code mm-state} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MM_STATE = "mm_st";
The mm-flags-token of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code mm-flags-token} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MM_FLAGS_TOKEN = "mm_flg_tok";
The mm-flags of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code mm-flags} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MM_FLAGS = "mm_flg";
The store-status of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code store-status} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String STORE_STATUS = "store_st";
The store-status-text of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code store-status-text} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String STORE_STATUS_TEXT = "store_st_txt";
The stored of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code stored} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String STORED = "stored";
The totals of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code totals} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String TOTALS = "totals";
The mbox-totals of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code mbox-totals} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MBOX_TOTALS = "mb_t";
The mbox-totals-token of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code mbox-totals-token} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MBOX_TOTALS_TOKEN = "mb_t_tok";
The quotas of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code quotas} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String QUOTAS = "qt";
The mbox-quotas of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code mbox-quotas} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MBOX_QUOTAS = "mb_qt";
The mbox-quotas-token of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code mbox-quotas-token} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MBOX_QUOTAS_TOKEN = "mb_qt_tok";
The message-count of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code message-count} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String MESSAGE_COUNT = "m_cnt";
The start of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code start} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String START = "start";
The distribution-indicator of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code distribution-indicator} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String DISTRIBUTION_INDICATOR = "d_ind";
The element-descriptor of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code element-descriptor} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String ELEMENT_DESCRIPTOR = "e_des";
The limit of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code limit} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String LIMIT = "limit";
The recommended-retrieval-mode of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code recommended-retrieval-mode} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String RECOMMENDED_RETRIEVAL_MODE = "r_r_mod";
The recommended-retrieval-mode-text of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code recommended-retrieval-mode-text} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String RECOMMENDED_RETRIEVAL_MODE_TEXT = "r_r_mod_txt";
The status-text of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code status-text} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String STATUS_TEXT = "st_txt";
The applic-id of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code applic-id} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String APPLIC_ID = "apl_id";
The reply-applic-id of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code reply-applic-id} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLY_APPLIC_ID = "r_apl_id";
The aux-applic-id of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code aux-applic-id} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String AUX_APPLIC_ID = "aux_apl_id";
The drm-content of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code drm-content} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String DRM_CONTENT = "drm_c";
The adaptation-allowed of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code adaptation-allowed} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String ADAPTATION_ALLOWED = "adp_a";
The replace-id of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code replace-id} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String REPLACE_ID = "repl_id";
The cancel-id of the message.

Type: TEXT

Deprecated:this column is no longer supported.
@hide
/** * The {@code cancel-id} of the message. * <P>Type: TEXT</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String CANCEL_ID = "cl_id";
The cancel-status of the message.

Type: INTEGER

Deprecated:this column is no longer supported.
@hide
/** * The {@code cancel-status} of the message. * <P>Type: INTEGER</P> * @deprecated this column is no longer supported. * @hide */
@Deprecated public static final String CANCEL_STATUS = "cl_st";
Is the message locked?

Type: INTEGER (boolean)

/** * Is the message locked? * <P>Type: INTEGER (boolean)</P> */
public static final String LOCKED = "locked";
The subscription to which the message belongs to. Its value will be < 0 if the sub id cannot be determined.

Type: INTEGER (long)

/** * The subscription to which the message belongs to. Its value will be * < 0 if the sub id cannot be determined. * <p>Type: INTEGER (long)</p> */
public static final String SUBSCRIPTION_ID = "sub_id";
The identity of the sender of a sent message. It is usually the package name of the app which sends the message.

Note: This column is read-only. It is set by the provider and can not be changed by apps.

Type: TEXT

/** * The identity of the sender of a sent message. It is * usually the package name of the app which sends the message. * <p class="note"><strong>Note:</strong> * This column is read-only. It is set by the provider and can not be changed by apps. * <p>Type: TEXT</p> */
public static final String CREATOR = "creator"; }
Columns for the "canonical_addresses" table used by MMS and SMS.
/** * Columns for the "canonical_addresses" table used by MMS and SMS. */
public interface CanonicalAddressesColumns extends BaseColumns {
An address used in MMS or SMS. Email addresses are converted to lower case and are compared by string equality. Other addresses are compared using PHONE_NUMBERS_EQUAL.

Type: TEXT

/** * An address used in MMS or SMS. Email addresses are * converted to lower case and are compared by string * equality. Other addresses are compared using * PHONE_NUMBERS_EQUAL. * <P>Type: TEXT</P> */
public static final String ADDRESS = "address"; }
Columns for the "threads" table used by MMS and SMS.
/** * Columns for the "threads" table used by MMS and SMS. */
public interface ThreadsColumns extends BaseColumns {
The date at which the thread was created.

Type: INTEGER (long)

/** * The date at which the thread was created. * <P>Type: INTEGER (long)</P> */
public static final String DATE = "date";
A string encoding of the recipient IDs of the recipients of the message, in numerical order and separated by spaces.

Type: TEXT

/** * A string encoding of the recipient IDs of the recipients of * the message, in numerical order and separated by spaces. * <P>Type: TEXT</P> */
public static final String RECIPIENT_IDS = "recipient_ids";
The message count of the thread.

Type: INTEGER

/** * The message count of the thread. * <P>Type: INTEGER</P> */
public static final String MESSAGE_COUNT = "message_count";
Indicates whether all messages of the thread have been read.

Type: INTEGER

/** * Indicates whether all messages of the thread have been read. * <P>Type: INTEGER</P> */
public static final String READ = "read";
The snippet of the latest message in the thread.

Type: TEXT

/** * The snippet of the latest message in the thread. * <P>Type: TEXT</P> */
public static final String SNIPPET = "snippet";
The charset of the snippet.

Type: INTEGER

/** * The charset of the snippet. * <P>Type: INTEGER</P> */
public static final String SNIPPET_CHARSET = "snippet_cs";
Type of the thread, either Threads.COMMON_THREAD or Threads.BROADCAST_THREAD.

Type: INTEGER

/** * Type of the thread, either {@link Threads#COMMON_THREAD} or * {@link Threads#BROADCAST_THREAD}. * <P>Type: INTEGER</P> */
public static final String TYPE = "type";
Indicates whether there is a transmission error in the thread.

Type: INTEGER

/** * Indicates whether there is a transmission error in the thread. * <P>Type: INTEGER</P> */
public static final String ERROR = "error";
Indicates whether this thread contains any attachments.

Type: INTEGER

/** * Indicates whether this thread contains any attachments. * <P>Type: INTEGER</P> */
public static final String HAS_ATTACHMENT = "has_attachment";
If the thread is archived

Type: INTEGER (boolean)

/** * If the thread is archived * <P>Type: INTEGER (boolean)</P> */
public static final String ARCHIVED = "archived"; }
Helper functions for the "threads" table used by MMS and SMS.
/** * Helper functions for the "threads" table used by MMS and SMS. */
public static final class Threads implements ThreadsColumns { private static final String[] ID_PROJECTION = { BaseColumns._ID };
Private content:// style URL for this table. Used by getOrCreateThreadId(Context, Set<String>).
/** * Private {@code content://} style URL for this table. Used by * {@link #getOrCreateThreadId(android.content.Context, java.util.Set)}. */
private static final Uri THREAD_ID_CONTENT_URI = Uri.parse( "content://mms-sms/threadID");
The content:// style URL for this table, by conversation.
/** * The {@code content://} style URL for this table, by conversation. */
public static final Uri CONTENT_URI = Uri.withAppendedPath( MmsSms.CONTENT_URI, "conversations");
The content:// style URL for this table, for obsolete threads.
/** * The {@code content://} style URL for this table, for obsolete threads. */
public static final Uri OBSOLETE_THREADS_URI = Uri.withAppendedPath( CONTENT_URI, "obsolete");
Thread type: common thread.
/** Thread type: common thread. */
public static final int COMMON_THREAD = 0;
Thread type: broadcast thread.
/** Thread type: broadcast thread. */
public static final int BROADCAST_THREAD = 1;
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Threads() { }
This is a single-recipient version of getOrCreateThreadId. It's convenient for use with SMS messages.
Params:
  • context – the context object to use.
  • recipient – the recipient to send to.
/** * This is a single-recipient version of {@code getOrCreateThreadId}. * It's convenient for use with SMS messages. * @param context the context object to use. * @param recipient the recipient to send to. */
public static long getOrCreateThreadId(Context context, String recipient) { Set<String> recipients = new HashSet<String>(); recipients.add(recipient); return getOrCreateThreadId(context, recipients); }
Given the recipients list and subject of an unsaved message, return its thread ID. If the message starts a new thread, allocate a new thread ID. Otherwise, use the appropriate existing thread ID.

Find the thread ID of the same set of recipients (in any order, without any additions). If one is found, return it. Otherwise, return a unique thread ID.

/** * Given the recipients list and subject of an unsaved message, * return its thread ID. If the message starts a new thread, * allocate a new thread ID. Otherwise, use the appropriate * existing thread ID. * * <p>Find the thread ID of the same set of recipients (in any order, * without any additions). If one is found, return it. Otherwise, * return a unique thread ID.</p> */
public static long getOrCreateThreadId( Context context, Set<String> recipients) { Uri.Builder uriBuilder = THREAD_ID_CONTENT_URI.buildUpon(); for (String recipient : recipients) { if (Mms.isEmailAddress(recipient)) { recipient = Mms.extractAddrSpec(recipient); } uriBuilder.appendQueryParameter("recipient", recipient); } Uri uri = uriBuilder.build(); //if (DEBUG) Rlog.v(TAG, "getOrCreateThreadId uri: " + uri); Cursor cursor = SqliteWrapper.query(context, context.getContentResolver(), uri, ID_PROJECTION, null, null, null); if (cursor != null) { try { if (cursor.moveToFirst()) { return cursor.getLong(0); } else { Rlog.e(TAG, "getOrCreateThreadId returned no rows!"); } } finally { cursor.close(); } } Rlog.e(TAG, "getOrCreateThreadId failed with " + recipients.size() + " recipients"); throw new IllegalArgumentException("Unable to find or allocate a thread ID."); } }
Contains all MMS messages.
/** * Contains all MMS messages. */
public static final class Mms implements BaseMmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Mms() { }
The content:// URI for this table.
/** * The {@code content://} URI for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://mms");
Content URI for getting MMS report requests.
/** * Content URI for getting MMS report requests. */
public static final Uri REPORT_REQUEST_URI = Uri.withAppendedPath( CONTENT_URI, "report-request");
Content URI for getting MMS report status.
/** * Content URI for getting MMS report status. */
public static final Uri REPORT_STATUS_URI = Uri.withAppendedPath( CONTENT_URI, "report-status");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC";
Regex pattern for names and email addresses.
  • mailbox = name-addr
  • name-addr = [display-name] angle-addr
  • angle-addr = [CFWS] "<" addr-spec ">" [CFWS]
@hide
/** * Regex pattern for names and email addresses. * <ul> * <li><em>mailbox</em> = {@code name-addr}</li> * <li><em>name-addr</em> = {@code [display-name] angle-addr}</li> * <li><em>angle-addr</em> = {@code [CFWS] "<" addr-spec ">" [CFWS]}</li> * </ul> * @hide */
public static final Pattern NAME_ADDR_EMAIL_PATTERN = Pattern.compile("\\s*(\"[^\"]*\"|[^<>\"]+)\\s*<([^<>]+)>\\s*");
Helper method to query this table.
@hide
/** * Helper method to query this table. * @hide */
public static Cursor query( ContentResolver cr, String[] projection) { return cr.query(CONTENT_URI, projection, null, null, DEFAULT_SORT_ORDER); }
Helper method to query this table.
@hide
/** * Helper method to query this table. * @hide */
public static Cursor query( ContentResolver cr, String[] projection, String where, String orderBy) { return cr.query(CONTENT_URI, projection, where, null, orderBy == null ? DEFAULT_SORT_ORDER : orderBy); }
Helper method to extract email address from address string.
@hide
/** * Helper method to extract email address from address string. * @hide */
public static String extractAddrSpec(String address) { Matcher match = NAME_ADDR_EMAIL_PATTERN.matcher(address); if (match.matches()) { return match.group(2); } return address; }
Is the specified address an email address?
Params:
  • address – the input address to test
Returns:true if address is an email address; false otherwise.
@hide
/** * Is the specified address an email address? * * @param address the input address to test * @return true if address is an email address; false otherwise. * @hide */
public static boolean isEmailAddress(String address) { if (TextUtils.isEmpty(address)) { return false; } String s = extractAddrSpec(address); Matcher match = Patterns.EMAIL_ADDRESS.matcher(s); return match.matches(); }
Is the specified number a phone number?
Params:
  • number – the input number to test
Returns:true if number is a phone number; false otherwise.
@hide
/** * Is the specified number a phone number? * * @param number the input number to test * @return true if number is a phone number; false otherwise. * @hide */
public static boolean isPhoneNumber(String number) { if (TextUtils.isEmpty(number)) { return false; } Matcher match = Patterns.PHONE.matcher(number); return match.matches(); }
Contains all MMS messages in the MMS app inbox.
/** * Contains all MMS messages in the MMS app inbox. */
public static final class Inbox implements BaseMmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Inbox() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://mms/inbox");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC"; }
Contains all MMS messages in the MMS app sent folder.
/** * Contains all MMS messages in the MMS app sent folder. */
public static final class Sent implements BaseMmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Sent() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://mms/sent");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC"; }
Contains all MMS messages in the MMS app drafts folder.
/** * Contains all MMS messages in the MMS app drafts folder. */
public static final class Draft implements BaseMmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Draft() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://mms/drafts");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC"; }
Contains all MMS messages in the MMS app outbox.
/** * Contains all MMS messages in the MMS app outbox. */
public static final class Outbox implements BaseMmsColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Outbox() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://mms/outbox");
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "date DESC"; }
Contains address information for an MMS message.
/** * Contains address information for an MMS message. */
public static final class Addr implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Addr() { }
The ID of MM which this address entry belongs to.

Type: INTEGER (long)

/** * The ID of MM which this address entry belongs to. * <P>Type: INTEGER (long)</P> */
public static final String MSG_ID = "msg_id";
The ID of contact entry in Phone Book.

Type: INTEGER (long)

/** * The ID of contact entry in Phone Book. * <P>Type: INTEGER (long)</P> */
public static final String CONTACT_ID = "contact_id";
The address text.

Type: TEXT

/** * The address text. * <P>Type: TEXT</P> */
public static final String ADDRESS = "address";
Type of address: must be one of PduHeaders.BCC, PduHeaders.CC, PduHeaders.FROM, PduHeaders.TO.

Type: INTEGER

/** * Type of address: must be one of {@code PduHeaders.BCC}, * {@code PduHeaders.CC}, {@code PduHeaders.FROM}, {@code PduHeaders.TO}. * <P>Type: INTEGER</P> */
public static final String TYPE = "type";
Character set of this entry (MMS charset value).

Type: INTEGER

/** * Character set of this entry (MMS charset value). * <P>Type: INTEGER</P> */
public static final String CHARSET = "charset"; }
Contains message parts.
/** * Contains message parts. */
public static final class Part implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Part() { }
The identifier of the message which this part belongs to.

Type: INTEGER

/** * The identifier of the message which this part belongs to. * <P>Type: INTEGER</P> */
public static final String MSG_ID = "mid";
The order of the part.

Type: INTEGER

/** * The order of the part. * <P>Type: INTEGER</P> */
public static final String SEQ = "seq";
The content type of the part.

Type: TEXT

/** * The content type of the part. * <P>Type: TEXT</P> */
public static final String CONTENT_TYPE = "ct";
The name of the part.

Type: TEXT

/** * The name of the part. * <P>Type: TEXT</P> */
public static final String NAME = "name";
The charset of the part.

Type: TEXT

/** * The charset of the part. * <P>Type: TEXT</P> */
public static final String CHARSET = "chset";
The file name of the part.

Type: TEXT

/** * The file name of the part. * <P>Type: TEXT</P> */
public static final String FILENAME = "fn";
The content disposition of the part.

Type: TEXT

/** * The content disposition of the part. * <P>Type: TEXT</P> */
public static final String CONTENT_DISPOSITION = "cd";
The content ID of the part.

Type: INTEGER

/** * The content ID of the part. * <P>Type: INTEGER</P> */
public static final String CONTENT_ID = "cid";
The content location of the part.

Type: INTEGER

/** * The content location of the part. * <P>Type: INTEGER</P> */
public static final String CONTENT_LOCATION = "cl";
The start of content-type of the message.

Type: INTEGER

/** * The start of content-type of the message. * <P>Type: INTEGER</P> */
public static final String CT_START = "ctt_s";
The type of content-type of the message.

Type: TEXT

/** * The type of content-type of the message. * <P>Type: TEXT</P> */
public static final String CT_TYPE = "ctt_t";
The location (on filesystem) of the binary data of the part.

Type: INTEGER

/** * The location (on filesystem) of the binary data of the part. * <P>Type: INTEGER</P> */
public static final String _DATA = "_data";
The message text.

Type: TEXT

/** * The message text. * <P>Type: TEXT</P> */
public static final String TEXT = "text"; }
Message send rate table.
/** * Message send rate table. */
public static final class Rate {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Rate() { }
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.withAppendedPath( Mms.CONTENT_URI, "rate");
When a message was successfully sent.

Type: INTEGER (long)

/** * When a message was successfully sent. * <P>Type: INTEGER (long)</P> */
public static final String SENT_TIME = "sent_time"; }
Intents class.
/** * Intents class. */
public static final class Intents {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Intents() { }
Indicates that the contents of specified URIs were changed. The application which is showing or caching these contents should be updated.
/** * Indicates that the contents of specified URIs were changed. * The application which is showing or caching these contents * should be updated. */
@SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) public static final String CONTENT_CHANGED_ACTION = "android.intent.action.CONTENT_CHANGED";
An extra field which stores the URI of deleted contents.
/** * An extra field which stores the URI of deleted contents. */
public static final String DELETED_CONTENTS = "deleted_contents"; } }
Contains all MMS and SMS messages.
/** * Contains all MMS and SMS messages. */
public static final class MmsSms implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private MmsSms() { }
The column to distinguish SMS and MMS messages in query results.
/** * The column to distinguish SMS and MMS messages in query results. */
public static final String TYPE_DISCRIMINATOR_COLUMN = "transport_type";
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://mms-sms/");
The content:// style URL for this table, by conversation.
/** * The {@code content://} style URL for this table, by conversation. */
public static final Uri CONTENT_CONVERSATIONS_URI = Uri.parse( "content://mms-sms/conversations");
The content:// style URL for this table, by phone number.
/** * The {@code content://} style URL for this table, by phone number. */
public static final Uri CONTENT_FILTER_BYPHONE_URI = Uri.parse( "content://mms-sms/messages/byphone");
The content:// style URL for undelivered messages in this table.
/** * The {@code content://} style URL for undelivered messages in this table. */
public static final Uri CONTENT_UNDELIVERED_URI = Uri.parse( "content://mms-sms/undelivered");
The content:// style URL for draft messages in this table.
/** * The {@code content://} style URL for draft messages in this table. */
public static final Uri CONTENT_DRAFT_URI = Uri.parse( "content://mms-sms/draft");
The content:// style URL for locked messages in this table.
/** * The {@code content://} style URL for locked messages in this table. */
public static final Uri CONTENT_LOCKED_URI = Uri.parse( "content://mms-sms/locked");
Pass in a query parameter called "pattern" which is the text to search for. The sort order is fixed to be: thread_id ASC, date DESC.
/** * Pass in a query parameter called "pattern" which is the text to search for. * The sort order is fixed to be: {@code thread_id ASC, date DESC}. */
public static final Uri SEARCH_URI = Uri.parse( "content://mms-sms/search"); // Constants for message protocol types.
SMS protocol type.
/** SMS protocol type. */
public static final int SMS_PROTO = 0;
MMS protocol type.
/** MMS protocol type. */
public static final int MMS_PROTO = 1; // Constants for error types of pending messages.
Error type: no error.
/** Error type: no error. */
public static final int NO_ERROR = 0;
Error type: generic transient error.
/** Error type: generic transient error. */
public static final int ERR_TYPE_GENERIC = 1;
Error type: SMS protocol transient error.
/** Error type: SMS protocol transient error. */
public static final int ERR_TYPE_SMS_PROTO_TRANSIENT = 2;
Error type: MMS protocol transient error.
/** Error type: MMS protocol transient error. */
public static final int ERR_TYPE_MMS_PROTO_TRANSIENT = 3;
Error type: transport failure.
/** Error type: transport failure. */
public static final int ERR_TYPE_TRANSPORT_FAILURE = 4;
Error type: permanent error (along with all higher error values).
/** Error type: permanent error (along with all higher error values). */
public static final int ERR_TYPE_GENERIC_PERMANENT = 10;
Error type: SMS protocol permanent error.
/** Error type: SMS protocol permanent error. */
public static final int ERR_TYPE_SMS_PROTO_PERMANENT = 11;
Error type: MMS protocol permanent error.
/** Error type: MMS protocol permanent error. */
public static final int ERR_TYPE_MMS_PROTO_PERMANENT = 12;
Contains pending messages info.
/** * Contains pending messages info. */
public static final class PendingMessages implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private PendingMessages() { } public static final Uri CONTENT_URI = Uri.withAppendedPath( MmsSms.CONTENT_URI, "pending");
The type of transport protocol (MMS or SMS).

Type: INTEGER

/** * The type of transport protocol (MMS or SMS). * <P>Type: INTEGER</P> */
public static final String PROTO_TYPE = "proto_type";
The ID of the message to be sent or downloaded.

Type: INTEGER (long)

/** * The ID of the message to be sent or downloaded. * <P>Type: INTEGER (long)</P> */
public static final String MSG_ID = "msg_id";
The type of the message to be sent or downloaded. This field is only valid for MM. For SM, its value is always set to 0.

Type: INTEGER

/** * The type of the message to be sent or downloaded. * This field is only valid for MM. For SM, its value is always set to 0. * <P>Type: INTEGER</P> */
public static final String MSG_TYPE = "msg_type";
The type of the error code.

Type: INTEGER

/** * The type of the error code. * <P>Type: INTEGER</P> */
public static final String ERROR_TYPE = "err_type";
The error code of sending/retrieving process.

Type: INTEGER

/** * The error code of sending/retrieving process. * <P>Type: INTEGER</P> */
public static final String ERROR_CODE = "err_code";
How many times we tried to send or download the message.

Type: INTEGER

/** * How many times we tried to send or download the message. * <P>Type: INTEGER</P> */
public static final String RETRY_INDEX = "retry_index";
The time to do next retry.

Type: INTEGER (long)

/** * The time to do next retry. * <P>Type: INTEGER (long)</P> */
public static final String DUE_TIME = "due_time";
The time we last tried to send or download the message.

Type: INTEGER (long)

/** * The time we last tried to send or download the message. * <P>Type: INTEGER (long)</P> */
public static final String LAST_TRY = "last_try";
The subscription to which the message belongs to. Its value will be < 0 if the sub id cannot be determined.

Type: INTEGER (long)

/** * The subscription to which the message belongs to. Its value will be * < 0 if the sub id cannot be determined. * <p>Type: INTEGER (long) </p> */
public static final String SUBSCRIPTION_ID = "pending_sub_id"; }
Words table used by provider for full-text searches.
@hide
/** * Words table used by provider for full-text searches. * @hide */
public static final class WordsTable {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private WordsTable() {}
Primary key.

Type: INTEGER (long)

/** * Primary key. * <P>Type: INTEGER (long)</P> */
public static final String ID = "_id";
Source row ID.

Type: INTEGER (long)

/** * Source row ID. * <P>Type: INTEGER (long)</P> */
public static final String SOURCE_ROW_ID = "source_id";
Table ID (either 1 or 2).

Type: INTEGER

/** * Table ID (either 1 or 2). * <P>Type: INTEGER</P> */
public static final String TABLE_ID = "table_to_use";
The words to index.

Type: TEXT

/** * The words to index. * <P>Type: TEXT</P> */
public static final String INDEXED_TEXT = "index_text"; } }
Carriers class contains information about APNs, including MMSC information.
/** * Carriers class contains information about APNs, including MMSC information. */
public static final class Carriers implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private Carriers() {}
The content:// style URL for this table.
/** * The {@code content://} style URL for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://telephony/carriers");
The content:// style URL to be called from DevicePolicyManagerService, can manage DPC-owned APNs.
@hide
/** * The {@code content://} style URL to be called from DevicePolicyManagerService, * can manage DPC-owned APNs. * @hide */
public static final Uri DPC_URI = Uri.parse("content://telephony/carriers/dpc");
The content:// style URL to be called from Telephony to query APNs. When DPC-owned APNs are enforced, only DPC-owned APNs are returned, otherwise only non-DPC-owned APNs are returned.
@hide
/** * The {@code content://} style URL to be called from Telephony to query APNs. * When DPC-owned APNs are enforced, only DPC-owned APNs are returned, otherwise only * non-DPC-owned APNs are returned. * @hide */
public static final Uri FILTERED_URI = Uri.parse("content://telephony/carriers/filtered");
The content:// style URL to be called from DevicePolicyManagerService or Telephony to manage whether DPC-owned APNs are enforced.
@hide
/** * The {@code content://} style URL to be called from DevicePolicyManagerService * or Telephony to manage whether DPC-owned APNs are enforced. * @hide */
public static final Uri ENFORCE_MANAGED_URI = Uri.parse( "content://telephony/carriers/enforce_managed");
The column name for ENFORCE_MANAGED_URI, indicates whether DPC-owned APNs are enforced.
@hide
/** * The column name for ENFORCE_MANAGED_URI, indicates whether DPC-owned APNs are enforced. * @hide */
public static final String ENFORCE_KEY = "enforced";
The default sort order for this table.
/** * The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = "name ASC";
Entry name.

Type: TEXT

/** * Entry name. * <P>Type: TEXT</P> */
public static final String NAME = "name";
APN name.

Type: TEXT

/** * APN name. * <P>Type: TEXT</P> */
public static final String APN = "apn";
Proxy address.

Type: TEXT

/** * Proxy address. * <P>Type: TEXT</P> */
public static final String PROXY = "proxy";
Proxy port.

Type: TEXT

/** * Proxy port. * <P>Type: TEXT</P> */
public static final String PORT = "port";
MMS proxy address.

Type: TEXT

/** * MMS proxy address. * <P>Type: TEXT</P> */
public static final String MMSPROXY = "mmsproxy";
MMS proxy port.

Type: TEXT

/** * MMS proxy port. * <P>Type: TEXT</P> */
public static final String MMSPORT = "mmsport";
Server address.

Type: TEXT

/** * Server address. * <P>Type: TEXT</P> */
public static final String SERVER = "server";
APN username.

Type: TEXT

/** * APN username. * <P>Type: TEXT</P> */
public static final String USER = "user";
APN password.

Type: TEXT

/** * APN password. * <P>Type: TEXT</P> */
public static final String PASSWORD = "password";
MMSC URL.

Type: TEXT

/** * MMSC URL. * <P>Type: TEXT</P> */
public static final String MMSC = "mmsc";
Mobile Country Code (MCC).

Type: TEXT

/** * Mobile Country Code (MCC). * <P>Type: TEXT</P> */
public static final String MCC = "mcc";
Mobile Network Code (MNC).

Type: TEXT

/** * Mobile Network Code (MNC). * <P>Type: TEXT</P> */
public static final String MNC = "mnc";
Numeric operator ID (as String). Usually MCC + MNC.

Type: TEXT

/** * Numeric operator ID (as String). Usually {@code MCC + MNC}. * <P>Type: TEXT</P> */
public static final String NUMERIC = "numeric";
Authentication type.

Type: INTEGER

/** * Authentication type. * <P>Type: INTEGER</P> */
public static final String AUTH_TYPE = "authtype";
Comma-delimited list of APN types.

Type: TEXT

/** * Comma-delimited list of APN types. * <P>Type: TEXT</P> */
public static final String TYPE = "type";
The protocol to use to connect to this APN. One of the PDP_type values in TS 27.007 section 10.1.1. For example: IP, IPV6, IPV4V6, or PPP.

Type: TEXT

/** * The protocol to use to connect to this APN. * * One of the {@code PDP_type} values in TS 27.007 section 10.1.1. * For example: {@code IP}, {@code IPV6}, {@code IPV4V6}, or {@code PPP}. * <P>Type: TEXT</P> */
public static final String PROTOCOL = "protocol";
The protocol to use to connect to this APN when roaming. The syntax is the same as protocol.

Type: TEXT

/** * The protocol to use to connect to this APN when roaming. * The syntax is the same as protocol. * <P>Type: TEXT</P> */
public static final String ROAMING_PROTOCOL = "roaming_protocol";
Is this the current APN?

Type: INTEGER (boolean)

/** * Is this the current APN? * <P>Type: INTEGER (boolean)</P> */
public static final String CURRENT = "current";
Is this APN enabled?

Type: INTEGER (boolean)

/** * Is this APN enabled? * <P>Type: INTEGER (boolean)</P> */
public static final String CARRIER_ENABLED = "carrier_enabled";
Radio Access Technology info. To check what values are allowed, refer to ServiceState. This should be spread to other technologies, but is currently only used for LTE (14) and eHRPD (13).

Type: INTEGER

Deprecated:this column is no longer supported, use NETWORK_TYPE_BITMASK instead
/** * Radio Access Technology info. * To check what values are allowed, refer to {@link android.telephony.ServiceState}. * This should be spread to other technologies, * but is currently only used for LTE (14) and eHRPD (13). * <P>Type: INTEGER</P> * @deprecated this column is no longer supported, use {@link #NETWORK_TYPE_BITMASK} instead */
@Deprecated public static final String BEARER = "bearer";
Radio Access Technology bitmask. To check what values can be contained, refer to ServiceState. 0 indicates all techs otherwise first bit refers to RAT/bearer 1, second bit refers to RAT/bearer 2 and so on. Bitmask for a radio tech R is (1 << (R - 1))

Type: INTEGER

@hide
Deprecated:this column is no longer supported, use NETWORK_TYPE_BITMASK instead
/** * Radio Access Technology bitmask. * To check what values can be contained, refer to {@link android.telephony.ServiceState}. * 0 indicates all techs otherwise first bit refers to RAT/bearer 1, second bit refers to * RAT/bearer 2 and so on. * Bitmask for a radio tech R is (1 << (R - 1)) * <P>Type: INTEGER</P> * @hide * @deprecated this column is no longer supported, use {@link #NETWORK_TYPE_BITMASK} instead */
@Deprecated public static final String BEARER_BITMASK = "bearer_bitmask";
Radio technology (network type) bitmask. To check what values can be contained, refer to the NETWORK_TYPE_ constants in TelephonyManager. Bitmask for a radio tech R is (1 << (R - 1))

Type: INTEGER

/** * Radio technology (network type) bitmask. * To check what values can be contained, refer to the NETWORK_TYPE_ constants in * {@link android.telephony.TelephonyManager}. * Bitmask for a radio tech R is (1 << (R - 1)) * <P>Type: INTEGER</P> */
public static final String NETWORK_TYPE_BITMASK = "network_type_bitmask";
MVNO type: SPN (Service Provider Name), IMSI, GID (Group Identifier Level 1).

Type: TEXT

/** * MVNO type: * {@code SPN (Service Provider Name), IMSI, GID (Group Identifier Level 1)}. * <P>Type: TEXT</P> */
public static final String MVNO_TYPE = "mvno_type";
MVNO data. Use the following examples.
  • SPN: A MOBILE, BEN NL, ...
  • IMSI: 302720x94, 2060188, ...
  • GID: 4E, 33, ...

Type: TEXT

/** * MVNO data. * Use the following examples. * <ul> * <li>SPN: A MOBILE, BEN NL, ...</li> * <li>IMSI: 302720x94, 2060188, ...</li> * <li>GID: 4E, 33, ...</li> * </ul> * <P>Type: TEXT</P> */
public static final String MVNO_MATCH_DATA = "mvno_match_data";
The subscription to which the APN belongs to

Type: INTEGER (long)

/** * The subscription to which the APN belongs to * <p>Type: INTEGER (long) </p> */
public static final String SUBSCRIPTION_ID = "sub_id";
The profile_id to which the APN saved in modem

Type: INTEGER

@hide
/** * The profile_id to which the APN saved in modem * <p>Type: INTEGER</p> *@hide */
public static final String PROFILE_ID = "profile_id";
Is the apn setting to be set in modem

Type: INTEGER (boolean)

@hide
/** * Is the apn setting to be set in modem * <P>Type: INTEGER (boolean)</P> *@hide */
public static final String MODEM_COGNITIVE = "modem_cognitive";
The max connections of this apn

Type: INTEGER

@hide
/** * The max connections of this apn * <p>Type: INTEGER</p> *@hide */
public static final String MAX_CONNS = "max_conns";
The wait time for retry of the apn

Type: INTEGER

@hide
/** * The wait time for retry of the apn * <p>Type: INTEGER</p> *@hide */
public static final String WAIT_TIME = "wait_time";
The time to limit max connection for the apn

Type: INTEGER

@hide
/** * The time to limit max connection for the apn * <p>Type: INTEGER</p> *@hide */
public static final String MAX_CONNS_TIME = "max_conns_time";
The MTU size of the mobile interface to which the APN connected

Type: INTEGER

@hide
/** * The MTU size of the mobile interface to which the APN connected * <p>Type: INTEGER </p> * @hide */
public static final String MTU = "mtu";
Is this APN added/edited/deleted by a user or carrier?

Type: INTEGER

@hide
/** * Is this APN added/edited/deleted by a user or carrier? * <p>Type: INTEGER </p> * @hide */
public static final String EDITED = "edited";
Is this APN visible to the user?

Type: INTEGER (boolean)

@hide
/** * Is this APN visible to the user? * <p>Type: INTEGER (boolean) </p> * @hide */
public static final String USER_VISIBLE = "user_visible";
Is the user allowed to edit this APN?

Type: INTEGER (boolean)

@hide
/** * Is the user allowed to edit this APN? * <p>Type: INTEGER (boolean) </p> * @hide */
public static final String USER_EDITABLE = "user_editable";
Following are possible values for the EDITED field
@hide
/** * Following are possible values for the EDITED field * @hide */
public static final int UNEDITED = 0;
@hide
/** * @hide */
public static final int USER_EDITED = 1;
@hide
/** * @hide */
public static final int USER_DELETED = 2;
DELETED_BUT_PRESENT is an intermediate value used to indicate that an entry deleted by the user is still present in the new APN database and therefore must remain tagged as user deleted rather than completely removed from the database
@hide
/** * DELETED_BUT_PRESENT is an intermediate value used to indicate that an entry deleted * by the user is still present in the new APN database and therefore must remain tagged * as user deleted rather than completely removed from the database * @hide */
public static final int USER_DELETED_BUT_PRESENT_IN_XML = 3;
@hide
/** * @hide */
public static final int CARRIER_EDITED = 4;
CARRIER_DELETED values are currently not used as there is no usecase. If they are used, delete() will have to change accordingly. Currently it is hardcoded to USER_DELETED.
@hide
/** * CARRIER_DELETED values are currently not used as there is no usecase. If they are used, * delete() will have to change accordingly. Currently it is hardcoded to USER_DELETED. * @hide */
public static final int CARRIER_DELETED = 5;
@hide
/** * @hide */
public static final int CARRIER_DELETED_BUT_PRESENT_IN_XML = 6;
The owner of the APN.

Type: INTEGER

@hide
/** * The owner of the APN. * <p>Type: INTEGER</p> * @hide */
public static final String OWNED_BY = "owned_by";
Possible value for the OWNED_BY field. APN is owned by DPC.
@hide
/** * Possible value for the OWNED_BY field. * APN is owned by DPC. * @hide */
public static final int OWNED_BY_DPC = 0;
Possible value for the OWNED_BY field. APN is owned by other sources.
@hide
/** * Possible value for the OWNED_BY field. * APN is owned by other sources. * @hide */
public static final int OWNED_BY_OTHERS = 1;
The APN set id. When the user manually selects an APN or the framework sets an APN as preferred, all APNs with the same set id as the selected APN should be prioritized over APNs in other sets.
@hide
/** * The APN set id. When the user manually selects an APN or the framework sets an APN as * preferred, all APNs with the same set id as the selected APN should be prioritized over * APNs in other sets. * @hide */
public static final String APN_SET_ID = "apn_set_id";
Possible value for the APN_SET_ID field. By default APNs will not belong to a set. If the user manually selects an APN with no set set, there is no need to prioritize any specific APN set ids.
@hide
/** * Possible value for the APN_SET_ID field. By default APNs will not belong to a set. If the * user manually selects an APN with no set set, there is no need to prioritize any specific * APN set ids. * @hide */
public static final int NO_SET_SET = 0; }
Contains received SMS cell broadcast messages.
@hide
/** * Contains received SMS cell broadcast messages. * @hide */
public static final class CellBroadcasts implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private CellBroadcasts() {}
The content:// URI for this table.
/** * The {@code content://} URI for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://cellbroadcasts");
Message geographical scope.

Type: INTEGER

/** * Message geographical scope. * <P>Type: INTEGER</P> */
public static final String GEOGRAPHICAL_SCOPE = "geo_scope";
Message serial number.

Type: INTEGER

/** * Message serial number. * <P>Type: INTEGER</P> */
public static final String SERIAL_NUMBER = "serial_number";
PLMN of broadcast sender. SERIAL_NUMBER + PLMN + LAC + CID uniquely identifies a broadcast for duplicate detection purposes.

Type: TEXT

/** * PLMN of broadcast sender. {@code SERIAL_NUMBER + PLMN + LAC + CID} uniquely identifies * a broadcast for duplicate detection purposes. * <P>Type: TEXT</P> */
public static final String PLMN = "plmn";
Location Area (GSM) or Service Area (UMTS) of broadcast sender. Unused for CDMA. Only included if Geographical Scope of message is not PLMN wide (01).

Type: INTEGER

/** * Location Area (GSM) or Service Area (UMTS) of broadcast sender. Unused for CDMA. * Only included if Geographical Scope of message is not PLMN wide (01). * <P>Type: INTEGER</P> */
public static final String LAC = "lac";
Cell ID of message sender (GSM/UMTS). Unused for CDMA. Only included when the Geographical Scope of message is cell wide (00 or 11).

Type: INTEGER

/** * Cell ID of message sender (GSM/UMTS). Unused for CDMA. Only included when the * Geographical Scope of message is cell wide (00 or 11). * <P>Type: INTEGER</P> */
public static final String CID = "cid";
Message code. OBSOLETE: merged into SERIAL_NUMBER.

Type: INTEGER

/** * Message code. <em>OBSOLETE: merged into SERIAL_NUMBER.</em> * <P>Type: INTEGER</P> */
public static final String V1_MESSAGE_CODE = "message_code";
Message identifier. OBSOLETE: renamed to SERVICE_CATEGORY.

Type: INTEGER

/** * Message identifier. <em>OBSOLETE: renamed to SERVICE_CATEGORY.</em> * <P>Type: INTEGER</P> */
public static final String V1_MESSAGE_IDENTIFIER = "message_id";
Service category (GSM/UMTS: message identifier; CDMA: service category).

Type: INTEGER

/** * Service category (GSM/UMTS: message identifier; CDMA: service category). * <P>Type: INTEGER</P> */
public static final String SERVICE_CATEGORY = "service_category";
Message language code.

Type: TEXT

/** * Message language code. * <P>Type: TEXT</P> */
public static final String LANGUAGE_CODE = "language";
Message body.

Type: TEXT

/** * Message body. * <P>Type: TEXT</P> */
public static final String MESSAGE_BODY = "body";
Message delivery time.

Type: INTEGER (long)

/** * Message delivery time. * <P>Type: INTEGER (long)</P> */
public static final String DELIVERY_TIME = "date";
Has the message been viewed?

Type: INTEGER (boolean)

/** * Has the message been viewed? * <P>Type: INTEGER (boolean)</P> */
public static final String MESSAGE_READ = "read";
Message format (3GPP or 3GPP2).

Type: INTEGER

/** * Message format (3GPP or 3GPP2). * <P>Type: INTEGER</P> */
public static final String MESSAGE_FORMAT = "format";
Message priority (including emergency).

Type: INTEGER

/** * Message priority (including emergency). * <P>Type: INTEGER</P> */
public static final String MESSAGE_PRIORITY = "priority";
ETWS warning type (ETWS alerts only).

Type: INTEGER

/** * ETWS warning type (ETWS alerts only). * <P>Type: INTEGER</P> */
public static final String ETWS_WARNING_TYPE = "etws_warning_type";
CMAS message class (CMAS alerts only).

Type: INTEGER

/** * CMAS message class (CMAS alerts only). * <P>Type: INTEGER</P> */
public static final String CMAS_MESSAGE_CLASS = "cmas_message_class";
CMAS category (CMAS alerts only).

Type: INTEGER

/** * CMAS category (CMAS alerts only). * <P>Type: INTEGER</P> */
public static final String CMAS_CATEGORY = "cmas_category";
CMAS response type (CMAS alerts only).

Type: INTEGER

/** * CMAS response type (CMAS alerts only). * <P>Type: INTEGER</P> */
public static final String CMAS_RESPONSE_TYPE = "cmas_response_type";
CMAS severity (CMAS alerts only).

Type: INTEGER

/** * CMAS severity (CMAS alerts only). * <P>Type: INTEGER</P> */
public static final String CMAS_SEVERITY = "cmas_severity";
CMAS urgency (CMAS alerts only).

Type: INTEGER

/** * CMAS urgency (CMAS alerts only). * <P>Type: INTEGER</P> */
public static final String CMAS_URGENCY = "cmas_urgency";
CMAS certainty (CMAS alerts only).

Type: INTEGER

/** * CMAS certainty (CMAS alerts only). * <P>Type: INTEGER</P> */
public static final String CMAS_CERTAINTY = "cmas_certainty";
The default sort order for this table.
/** The default sort order for this table. */
public static final String DEFAULT_SORT_ORDER = DELIVERY_TIME + " DESC";
Query columns for instantiating CellBroadcastMessage objects.
/** * Query columns for instantiating {@link android.telephony.CellBroadcastMessage} objects. */
public static final String[] QUERY_COLUMNS = { _ID, GEOGRAPHICAL_SCOPE, PLMN, LAC, CID, SERIAL_NUMBER, SERVICE_CATEGORY, LANGUAGE_CODE, MESSAGE_BODY, DELIVERY_TIME, MESSAGE_READ, MESSAGE_FORMAT, MESSAGE_PRIORITY, ETWS_WARNING_TYPE, CMAS_MESSAGE_CLASS, CMAS_CATEGORY, CMAS_RESPONSE_TYPE, CMAS_SEVERITY, CMAS_URGENCY, CMAS_CERTAINTY }; }
Constants for interfacing with the ServiceStateProvider and the different fields of the ServiceState class accessible through the provider.
/** * Constants for interfacing with the ServiceStateProvider and the different fields of the * {@link ServiceState} class accessible through the provider. */
public static final class ServiceStateTable {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private ServiceStateTable() {}
The authority string for the ServiceStateProvider
/** * The authority string for the ServiceStateProvider */
public static final String AUTHORITY = "service-state";
The content:// style URL for the ServiceStateProvider
/** * The {@code content://} style URL for the ServiceStateProvider */
public static final Uri CONTENT_URI = Uri.parse("content://service-state/");
Generates a content Uri used to receive updates on a specific field in the ServiceState provider.

Use this Uri with a ContentObserver to be notified of changes to the ServiceState while your app is running. You can also use a JobService to ensure your app is notified of changes to the Uri even when it is not running. Note, however, that using a JobService does not guarantee timely delivery of updates to the Uri.

Params:
  • subscriptionId – the subscriptionId to receive updates on
  • field – the ServiceState field to receive updates on
Returns:the Uri used to observe ServiceState changes
/** * Generates a content {@link Uri} used to receive updates on a specific field in the * ServiceState provider. * <p> * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the * {@link ServiceState} while your app is running. You can also use a {@link JobService} to * ensure your app is notified of changes to the {@link Uri} even when it is not running. * Note, however, that using a {@link JobService} does not guarantee timely delivery of * updates to the {@link Uri}. * * @param subscriptionId the subscriptionId to receive updates on * @param field the ServiceState field to receive updates on * @return the Uri used to observe {@link ServiceState} changes */
public static Uri getUriForSubscriptionIdAndField(int subscriptionId, String field) { return CONTENT_URI.buildUpon().appendEncodedPath(String.valueOf(subscriptionId)) .appendEncodedPath(field).build(); }
Generates a content Uri used to receive updates on every field in the ServiceState provider.

Use this Uri with a ContentObserver to be notified of changes to the ServiceState while your app is running. You can also use a JobService to ensure your app is notified of changes to the Uri even when it is not running. Note, however, that using a JobService does not guarantee timely delivery of updates to the Uri.

Params:
  • subscriptionId – the subscriptionId to receive updates on
Returns:the Uri used to observe ServiceState changes
/** * Generates a content {@link Uri} used to receive updates on every field in the * ServiceState provider. * <p> * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the * {@link ServiceState} while your app is running. You can also use a {@link JobService} to * ensure your app is notified of changes to the {@link Uri} even when it is not running. * Note, however, that using a {@link JobService} does not guarantee timely delivery of * updates to the {@link Uri}. * * @param subscriptionId the subscriptionId to receive updates on * @return the Uri used to observe {@link ServiceState} changes */
public static Uri getUriForSubscriptionId(int subscriptionId) { return CONTENT_URI.buildUpon().appendEncodedPath(String.valueOf(subscriptionId)).build(); }
Used to insert a ServiceState into the ServiceStateProvider as a ContentValues instance.
Params:
  • state – the ServiceState to convert into ContentValues
Returns:the convertedContentValues instance
@hide
/** * Used to insert a ServiceState into the ServiceStateProvider as a ContentValues instance. * * @param state the ServiceState to convert into ContentValues * @return the convertedContentValues instance * @hide */
public static ContentValues getContentValuesForServiceState(ServiceState state) { ContentValues values = new ContentValues(); values.put(VOICE_REG_STATE, state.getVoiceRegState()); values.put(DATA_REG_STATE, state.getDataRegState()); values.put(VOICE_ROAMING_TYPE, state.getVoiceRoamingType()); values.put(DATA_ROAMING_TYPE, state.getDataRoamingType()); values.put(VOICE_OPERATOR_ALPHA_LONG, state.getVoiceOperatorAlphaLong()); values.put(VOICE_OPERATOR_ALPHA_SHORT, state.getVoiceOperatorAlphaShort()); values.put(VOICE_OPERATOR_NUMERIC, state.getVoiceOperatorNumeric()); values.put(DATA_OPERATOR_ALPHA_LONG, state.getDataOperatorAlphaLong()); values.put(DATA_OPERATOR_ALPHA_SHORT, state.getDataOperatorAlphaShort()); values.put(DATA_OPERATOR_NUMERIC, state.getDataOperatorNumeric()); values.put(IS_MANUAL_NETWORK_SELECTION, state.getIsManualSelection()); values.put(RIL_VOICE_RADIO_TECHNOLOGY, state.getRilVoiceRadioTechnology()); values.put(RIL_DATA_RADIO_TECHNOLOGY, state.getRilDataRadioTechnology()); values.put(CSS_INDICATOR, state.getCssIndicator()); values.put(NETWORK_ID, state.getCdmaNetworkId()); values.put(SYSTEM_ID, state.getCdmaSystemId()); values.put(CDMA_ROAMING_INDICATOR, state.getCdmaRoamingIndicator()); values.put(CDMA_DEFAULT_ROAMING_INDICATOR, state.getCdmaDefaultRoamingIndicator()); values.put(CDMA_ERI_ICON_INDEX, state.getCdmaEriIconIndex()); values.put(CDMA_ERI_ICON_MODE, state.getCdmaEriIconMode()); values.put(IS_EMERGENCY_ONLY, state.isEmergencyOnly()); values.put(IS_DATA_ROAMING_FROM_REGISTRATION, state.getDataRoamingFromRegistration()); values.put(IS_USING_CARRIER_AGGREGATION, state.isUsingCarrierAggregation()); return values; }
An integer value indicating the current voice service state.

Valid values: ServiceState.STATE_IN_SERVICE, ServiceState.STATE_OUT_OF_SERVICE, ServiceState.STATE_EMERGENCY_ONLY, ServiceState.STATE_POWER_OFF.

This is the same as ServiceState.getState().

/** * An integer value indicating the current voice service state. * <p> * Valid values: {@link ServiceState#STATE_IN_SERVICE}, * {@link ServiceState#STATE_OUT_OF_SERVICE}, {@link ServiceState#STATE_EMERGENCY_ONLY}, * {@link ServiceState#STATE_POWER_OFF}. * <p> * This is the same as {@link ServiceState#getState()}. */
public static final String VOICE_REG_STATE = "voice_reg_state";
An integer value indicating the current data service state.

Valid values: ServiceState.STATE_IN_SERVICE, ServiceState.STATE_OUT_OF_SERVICE, ServiceState.STATE_EMERGENCY_ONLY, ServiceState.STATE_POWER_OFF.

This is the same as ServiceState.getDataRegState().

@hide
/** * An integer value indicating the current data service state. * <p> * Valid values: {@link ServiceState#STATE_IN_SERVICE}, * {@link ServiceState#STATE_OUT_OF_SERVICE}, {@link ServiceState#STATE_EMERGENCY_ONLY}, * {@link ServiceState#STATE_POWER_OFF}. * <p> * This is the same as {@link ServiceState#getDataRegState()}. * @hide */
public static final String DATA_REG_STATE = "data_reg_state";
An integer value indicating the current voice roaming type.

This is the same as ServiceState.getVoiceRoamingType().

@hide
/** * An integer value indicating the current voice roaming type. * <p> * This is the same as {@link ServiceState#getVoiceRoamingType()}. * @hide */
public static final String VOICE_ROAMING_TYPE = "voice_roaming_type";
An integer value indicating the current data roaming type.

This is the same as ServiceState.getDataRoamingType().

@hide
/** * An integer value indicating the current data roaming type. * <p> * This is the same as {@link ServiceState#getDataRoamingType()}. * @hide */
public static final String DATA_ROAMING_TYPE = "data_roaming_type";
The current registered voice network operator name in long alphanumeric format.

This is the same as ServiceState.getVoiceOperatorAlphaLong().

@hide
/** * The current registered voice network operator name in long alphanumeric format. * <p> * This is the same as {@link ServiceState#getVoiceOperatorAlphaLong()}. * @hide */
public static final String VOICE_OPERATOR_ALPHA_LONG = "voice_operator_alpha_long";
The current registered operator name in short alphanumeric format.

In GSM/UMTS, short format can be up to 8 characters long. The current registered voice network operator name in long alphanumeric format.

This is the same as ServiceState.getVoiceOperatorAlphaShort().

@hide
/** * The current registered operator name in short alphanumeric format. * <p> * In GSM/UMTS, short format can be up to 8 characters long. The current registered voice * network operator name in long alphanumeric format. * <p> * This is the same as {@link ServiceState#getVoiceOperatorAlphaShort()}. * @hide */
public static final String VOICE_OPERATOR_ALPHA_SHORT = "voice_operator_alpha_short";
The current registered operator numeric id.

In GSM/UMTS, numeric format is 3 digit country code plus 2 or 3 digit network code.

This is the same as ServiceState.getOperatorNumeric().

/** * The current registered operator numeric id. * <p> * In GSM/UMTS, numeric format is 3 digit country code plus 2 or 3 digit * network code. * <p> * This is the same as {@link ServiceState#getOperatorNumeric()}. */
public static final String VOICE_OPERATOR_NUMERIC = "voice_operator_numeric";
The current registered data network operator name in long alphanumeric format.

This is the same as ServiceState.getDataOperatorAlphaLong().

@hide
/** * The current registered data network operator name in long alphanumeric format. * <p> * This is the same as {@link ServiceState#getDataOperatorAlphaLong()}. * @hide */
public static final String DATA_OPERATOR_ALPHA_LONG = "data_operator_alpha_long";
The current registered data network operator name in short alphanumeric format.

This is the same as ServiceState.getDataOperatorAlphaShort().

@hide
/** * The current registered data network operator name in short alphanumeric format. * <p> * This is the same as {@link ServiceState#getDataOperatorAlphaShort()}. * @hide */
public static final String DATA_OPERATOR_ALPHA_SHORT = "data_operator_alpha_short";
The current registered data network operator numeric id.

This is the same as ServiceState.getDataOperatorNumeric().

@hide
/** * The current registered data network operator numeric id. * <p> * This is the same as {@link ServiceState#getDataOperatorNumeric()}. * @hide */
public static final String DATA_OPERATOR_NUMERIC = "data_operator_numeric";
The current network selection mode.

This is the same as ServiceState.getIsManualSelection().

/** * The current network selection mode. * <p> * This is the same as {@link ServiceState#getIsManualSelection()}. */
public static final String IS_MANUAL_NETWORK_SELECTION = "is_manual_network_selection";
@hide
/** * This is the same as {@link ServiceState#getRilVoiceRadioTechnology()}. * @hide */
public static final String RIL_VOICE_RADIO_TECHNOLOGY = "ril_voice_radio_technology";
@hide
/** * This is the same as {@link ServiceState#getRilDataRadioTechnology()}. * @hide */
public static final String RIL_DATA_RADIO_TECHNOLOGY = "ril_data_radio_technology";
This is the same as ServiceState.getCssIndicator().
@hide
/** * This is the same as {@link ServiceState#getCssIndicator()}. * @hide */
public static final String CSS_INDICATOR = "css_indicator";
This is the same as ServiceState.getCdmaNetworkId().
@hide
/** * This is the same as {@link ServiceState#getCdmaNetworkId()}. * @hide */
public static final String NETWORK_ID = "network_id";
This is the same as ServiceState.getCdmaSystemId().
@hide
/** * This is the same as {@link ServiceState#getCdmaSystemId()}. * @hide */
public static final String SYSTEM_ID = "system_id";
@hide
/** * This is the same as {@link ServiceState#getCdmaRoamingIndicator()}. * @hide */
public static final String CDMA_ROAMING_INDICATOR = "cdma_roaming_indicator";
@hide
/** * This is the same as {@link ServiceState#getCdmaDefaultRoamingIndicator()}. * @hide */
public static final String CDMA_DEFAULT_ROAMING_INDICATOR = "cdma_default_roaming_indicator";
@hide
/** * This is the same as {@link ServiceState#getCdmaEriIconIndex()}. * @hide */
public static final String CDMA_ERI_ICON_INDEX = "cdma_eri_icon_index";
This is the same as ServiceState.getCdmaEriIconMode().
@hide
/** * This is the same as {@link ServiceState#getCdmaEriIconMode()}. * @hide */
public static final String CDMA_ERI_ICON_MODE = "cdma_eri_icon_mode";
This is the same as ServiceState.isEmergencyOnly().
@hide
/** * This is the same as {@link ServiceState#isEmergencyOnly()}. * @hide */
public static final String IS_EMERGENCY_ONLY = "is_emergency_only";
@hide
/** * This is the same as {@link ServiceState#getDataRoamingFromRegistration()}. * @hide */
public static final String IS_DATA_ROAMING_FROM_REGISTRATION = "is_data_roaming_from_registration";
@hide
/** * This is the same as {@link ServiceState#isUsingCarrierAggregation()}. * @hide */
public static final String IS_USING_CARRIER_AGGREGATION = "is_using_carrier_aggregation"; }
Contains carrier identification information for the current subscriptions.
See Also:
  • getActiveSubscriptionIdList.getActiveSubscriptionIdList()
/** * Contains carrier identification information for the current subscriptions. * @see SubscriptionManager#getActiveSubscriptionIdList() */
public static final class CarrierId implements BaseColumns {
Not instantiable.
@hide
/** * Not instantiable. * @hide */
private CarrierId() {}
The content:// style URI for this provider.
/** * The {@code content://} style URI for this provider. */
public static final Uri CONTENT_URI = Uri.parse("content://carrier_id");
The authority string for the CarrierId Provider
@hide
/** * The authority string for the CarrierId Provider * @hide */
public static final String AUTHORITY = "carrier_id";
Generates a content Uri used to receive updates on carrier identity change on the given subscriptionId

Use this Uri with a ContentObserver to be notified of changes to the carrier identity TelephonyManager.getSimCarrierId() while your app is running. You can also use a JobService to ensure your app is notified of changes to the Uri even when it is not running. Note, however, that using a JobService does not guarantee timely delivery of updates to the Uri.

Params:
  • subscriptionId – the subscriptionId to receive updates on
Returns:the Uri used to observe carrier identity changes
/** * Generates a content {@link Uri} used to receive updates on carrier identity change * on the given subscriptionId * <p> * Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the * carrier identity {@link TelephonyManager#getSimCarrierId()} * while your app is running. You can also use a {@link JobService} to ensure your app * is notified of changes to the {@link Uri} even when it is not running. * Note, however, that using a {@link JobService} does not guarantee timely delivery of * updates to the {@link Uri}. * * @param subscriptionId the subscriptionId to receive updates on * @return the Uri used to observe carrier identity changes */
public static Uri getUriForSubscriptionId(int subscriptionId) { return CONTENT_URI.buildUpon().appendEncodedPath( String.valueOf(subscriptionId)).build(); }
A user facing carrier name.
See Also:
  • Type: TEXT

/** * A user facing carrier name. * @see TelephonyManager#getSimCarrierIdName() * <P>Type: TEXT </P> */
public static final String CARRIER_NAME = "carrier_name";
A unique carrier id
See Also:
  • Type: INTEGER

/** * A unique carrier id * @see TelephonyManager#getSimCarrierId() * <P>Type: INTEGER </P> */
public static final String CARRIER_ID = "carrier_id";
Contains mappings between matching rules with carrier id for all carriers.
@hide
/** * Contains mappings between matching rules with carrier id for all carriers. * @hide */
public static final class All implements BaseColumns {
Numeric operator ID (as String). MCC + MNC

Type: TEXT

/** * Numeric operator ID (as String). {@code MCC + MNC} * <P>Type: TEXT </P> */
public static final String MCCMNC = "mccmnc";
Group id level 1 (as String).

Type: TEXT

/** * Group id level 1 (as String). * <P>Type: TEXT </P> */
public static final String GID1 = "gid1";
Group id level 2 (as String).

Type: TEXT

/** * Group id level 2 (as String). * <P>Type: TEXT </P> */
public static final String GID2 = "gid2";
Public Land Mobile Network name.

Type: TEXT

/** * Public Land Mobile Network name. * <P>Type: TEXT </P> */
public static final String PLMN = "plmn";
Prefix xpattern of IMSI (International Mobile Subscriber Identity).

Type: TEXT

/** * Prefix xpattern of IMSI (International Mobile Subscriber Identity). * <P>Type: TEXT </P> */
public static final String IMSI_PREFIX_XPATTERN = "imsi_prefix_xpattern";
Service Provider Name.

Type: TEXT

/** * Service Provider Name. * <P>Type: TEXT </P> */
public static final String SPN = "spn";
Prefer APN name.

Type: TEXT

/** * Prefer APN name. * <P>Type: TEXT </P> */
public static final String APN = "apn";
Prefix of Integrated Circuit Card Identifier.

Type: TEXT

/** * Prefix of Integrated Circuit Card Identifier. * <P>Type: TEXT </P> */
public static final String ICCID_PREFIX = "iccid_prefix";
The content:// URI for this table.
/** * The {@code content://} URI for this table. */
public static final Uri CONTENT_URI = Uri.parse("content://carrier_id/all"); } } }