| java.lang.Object | |
| ↳ | android.provider.ContactsContract.StatusUpdates |
Known Direct Subclasses
|
A status update is linked to a ContactsContract.Data row and captures
the user's latest status update via the corresponding source, e.g.
"Having lunch" via "Google Talk".
There are two ways a status update can be inserted: by explicitly linking
it to a Data row using DATA_ID or indirectly linking it to a data row
using a combination of PROTOCOL (or CUSTOM_PROTOCOL) and
IM_HANDLE. There is no difference between insert and update, you can use
either.
You cannot use update(Uri, ContentValues, String, String[]) to change a status, but
insert(Uri, ContentValues) will replace the latests status if it already
exists.
Use bulkInsert(Uri, ContentValues[]) to insert/update statuses
for multiple contacts at once.
| StatusUpdates | |||
|---|---|---|---|
| long | DATA_ID | read/write | Reference to the _ID entry that owns this presence. If this
field is not specified, the provider will attempt to find a data row
that matches the PROTOCOL (or CUSTOM_PROTOCOL) and
IM_HANDLE columns.
|
| long | PROTOCOL | read/write | See ContactsContract.CommonDataKinds.Im for a list of defined protocol constants. |
| String | CUSTOM_PROTOCOL | read/write | Name of the custom protocol. Should be supplied along with the PROTOCOL value
PROTOCOL_CUSTOM. Should be null or
omitted if PROTOCOL value is not
PROTOCOL_CUSTOM. |
| String | IM_HANDLE | read/write | The IM handle the presence item is for. The handle is scoped to
PROTOCOL. |
| String | IM_ACCOUNT | read/write | The IM account for the local user that the presence data came from. |
| int | PRESENCE | read/write | Contact IM presence status. The allowed values are:
|
| String | STATUS | read/write | Contact's latest status update, e.g. "having toast for breakfast" |
| long | STATUS_TIMESTAMP | read/write | The absolute time in milliseconds when the status was entered by the user. If this value is not provided, the provider will follow this logic: if there was no prior status update, the value will be left as null. If there was a prior status update, the provider will default this field to the current time. |
| String | STATUS_RES_PACKAGE | read/write | The package containing resources for this status: label and icon. |
| long | STATUS_LABEL | read/write | The resource ID of the label describing the source of contact status,
e.g. "Google Talk". This resource is scoped by the
STATUS_RES_PACKAGE. |
| long | STATUS_ICON | read/write | The resource ID of the icon for the source of contact status. This
resource is scoped by the STATUS_RES_PACKAGE. |
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| String | CONTENT_ITEM_TYPE | The MIME type of a CONTENT_URI subdirectory of a single
status update detail. | |||||||||
| String | CONTENT_TYPE | The MIME type of CONTENT_URI providing a directory of
status update details. | |||||||||
| Uri | CONTENT_URI | The content:// style URI for this table | |||||||||
|
[Expand]
Inherited Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From interface
android.provider.ContactsContract.PresenceColumns
| |||||||||||
From interface
android.provider.ContactsContract.StatusColumns
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Gets the resource ID for the proper presence icon.
| |||||||||||
Returns the precedence of the status code the higher number being the higher precedence.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class java.lang.Object
| |||||||||||
The MIME type of a CONTENT_URI subdirectory of a single
status update detail.
The MIME type of CONTENT_URI providing a directory of
status update details.
Gets the resource ID for the proper presence icon.
| status | the status to get the icon for |
|---|
Returns the precedence of the status code the higher number being the higher precedence.
| status | The status code. |
|---|