Added in API level 19

Sms

---

Kotlin |Java

class Sms : BaseColumns, Telephony.TextBasedSmsColumns

kotlin.Any
↳	android.provider.Telephony.Sms

Contains all text-based SMS messages.

Summary

Nested classes
	Conversations Contains a view of SMS conversations (also referred to as threads).
	Draft Contains all draft text-based SMS messages in the SMS app.
	Inbox Contains all text-based SMS messages in the SMS app inbox.
	Intents Contains constants for SMS related Intents that are broadcast.
	Outbox Contains all pending outgoing text-based SMS messages.
	Sent Contains all sent text-based SMS messages in the SMS app.

Constants
static String	DEFAULT_SORT_ORDER The default sort order for this table.

Inherited constants
From class TextBasedSmsColumns String ADDRESS The address of the other party. Type: TEXT String BODY The body of the message. Type: TEXT String CREATOR 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 String DATE The date the message was received. Type: INTEGER (long) String DATE_SENT The date the message was sent. Type: INTEGER (long) String ERROR_CODE Error code associated with sending or receiving this message Type: INTEGER String LOCKED Is the message locked? Type: INTEGER (boolean) Int MESSAGE_TYPE_ALL Message type: all messages. Int MESSAGE_TYPE_DRAFT Message type: drafts. Int MESSAGE_TYPE_FAILED Message type: failed outgoing message. Int MESSAGE_TYPE_INBOX Message type: inbox. Int MESSAGE_TYPE_OUTBOX Message type: outbox. Int MESSAGE_TYPE_QUEUED Message type: queued to send later. Int MESSAGE_TYPE_SENT Message type: sent messages. String PERSON The ID of the sender of the conversation, if present. Type: INTEGER (reference to item in content://contacts/people) String PROTOCOL The protocol identifier code. Type: INTEGER String READ Has the message been read? Type: INTEGER (boolean) String REPLY_PATH_PRESENT Is the TP-Reply-Path flag set? Type: BOOLEAN String SEEN Has the message been seen by the user? The "seen" flag determines whether we need to show a notification. Type: INTEGER (boolean) String SERVICE_CENTER The service center (SC) through which to send the message, if present. Type: TEXT String STATUS TP-Status value for the message, or -1 if no status has been received. Type: INTEGER Int STATUS_COMPLETE TP-Status: complete. Int STATUS_FAILED TP-Status: failed. Int STATUS_NONE TP-Status: no status received. Int STATUS_PENDING TP-Status: pending. String SUBJECT The subject of the message, if present. Type: TEXT String SUBSCRIPTION_ID The subscription to which the message belongs to. Its value will be < 0 if the sub id cannot be determined. Type: INTEGER (long) String THREAD_ID The thread ID of the message. Type: INTEGER String TYPE The type of message. Type: INTEGER
From class BaseColumns String _COUNT The count of rows in a directory. Type: INTEGER String _ID The unique ID for a row. Type: INTEGER (long)

Public methods
static String!	getDefaultSmsPackage(context: Context!) Used to determine the currently configured default SMS package.

Properties
static Uri!	CONTENT_URI The content:// style URL for this table.

Constants

DEFAULT_SORT_ORDER

Added in API level 19

static val DEFAULT_SORT_ORDER: String

The default sort order for this table.

Value: "date DESC"

Public methods

getDefaultSmsPackage

Added in API level 19

static fun getDefaultSmsPackage(context: Context!): String!

Used to determine the currently configured default SMS package.

As of Android 11 apps will need specific permission to query other packages. To use this method an app must include in their AndroidManifest:

<code>&lt;queries&gt;
    &lt;intent&gt;
      &lt;action android:name="android.provider.Telephony.SMS_DELIVER"/&gt;
    &lt;/intent&gt;
  &lt;/queries&gt;
  </code>

Which will allow them to query packages which declare intent filters that include the android.provider.Telephony.Sms.Intents#SMS_DELIVER_ACTION intent.

Parameters
context	Context!: context of the requesting application

Return
String!	package name for the default SMS package or null

Properties

CONTENT_URI

Added in API level 19

static val CONTENT_URI: Uri!

The content:// style URL for this table.