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.

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 the recipients list and subject of an unsaved message, 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 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.

Parameters
context Context

recipients Set

Returns
long