Telephony.Threads

public static final class Telephony.Threads
extends Object implements Telephony.ThreadsColumns

java.lang.Object
   ↳ android.provider.Telephony.Threads


Helper functions for the "threads" table used by MMS and SMS. Thread IDs are determined by the participants in a conversation and can be used to match both SMS and MMS messages. To avoid issues where applications might cache a thread ID, the thread ID of a deleted thread must not be reused to point at a new thread.

Summary

Constants

int BROADCAST_THREAD

Thread type: broadcast thread.

int COMMON_THREAD

Thread type: common thread.

Inherited constants

Fields

public static final Uri CONTENT_URI

The content:// style URL for this table, by conversation.

public static final Uri OBSOLETE_THREADS_URI

The content:// style URL for this table, for obsolete threads.

Public methods

static long getOrCreateThreadId(Context context, String recipient)

This is a single-recipient version of getOrCreateThreadId.

static long getOrCreateThreadId(Context context, Set<String> recipients)

Given a set of recipients return its thread ID.

Inherited methods

Constants

BROADCAST_THREAD

Added in API level 19
public static final int BROADCAST_THREAD

Thread type: broadcast thread.

Constant Value: 1 (0x00000001)

COMMON_THREAD

Added in API level 19
public static final int COMMON_THREAD

Thread type: common thread.

Constant Value: 0 (0x00000000)

Fields

CONTENT_URI

Added in API level 19
public static final Uri CONTENT_URI

The content:// style URL for this table, by conversation.

OBSOLETE_THREADS_URI

Added in API level 19
public static final Uri OBSOLETE_THREADS_URI

The content:// style URL for this table, for obsolete threads.

Public methods

getOrCreateThreadId

Added in API level 23
public static long getOrCreateThreadId (Context context, 
                String recipient)

This is a single-recipient version of getOrCreateThreadId. It's convenient for use with SMS messages.

Parameters
context Context: the context object to use.

recipient String: the recipient to send to.

Returns
long

getOrCreateThreadId

Added in API level 23
public static long getOrCreateThreadId (Context context, 
                Set<String> recipients)

Given a set of recipients return its thread ID.

If a thread exists containing the provided participants, return its thread ID. Otherwise, this will create a new thread containing the provided participants and return its ID.

Parameters
context Context

recipients Set

Returns
long