ContactsContract.StreamItemPhotos

This class was deprecated in API level 21.
- Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty.

Class Overview

Constants for the stream_item_photos table, which contains photos associated with social stream updates.

Access to social stream photos requires additional permissions beyond the read/write contact permissions required by the provider. Querying for social stream photos requires android.permission.READ_SOCIAL_STREAM permission, and inserting or updating social stream photos requires android.permission.WRITE_SOCIAL_STREAM permission.

Account check

The content URIs to the insert, update and delete operations are required to have the account information matching that of the owning raw contact as query parameters, namely ACCOUNT_TYPE and ACCOUNT_NAME. DATA_SET isn't required.

Operations

Insert

Social stream photo entries are associated with a social stream item. Photos can be inserted into a social stream item in a couple of ways:

Via the CONTENT_DIRECTORY sub-path of a stream item:

 ContentValues values = new ContentValues();
 values.put(StreamItemPhotos.SORT_INDEX, 1);
 values.put(StreamItemPhotos.PHOTO, photoData);
 Uri.Builder builder = StreamItems.CONTENT_URI.buildUpon();
 ContentUris.appendId(builder, streamItemId);
 builder.appendEncodedPath(StreamItems.StreamItemPhotos.CONTENT_DIRECTORY);
 builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
 builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
 Uri photoUri = getContentResolver().insert(builder.build(), values);
 long photoId = ContentUris.parseId(photoUri);
 

Via the CONTENT_PHOTO_URI URI:

 ContentValues values = new ContentValues();
 values.put(StreamItemPhotos.STREAM_ITEM_ID, streamItemId);
 values.put(StreamItemPhotos.SORT_INDEX, 1);
 values.put(StreamItemPhotos.PHOTO, photoData);
 Uri.Builder builder = StreamItems.CONTENT_PHOTO_URI.buildUpon();
 builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
 builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
 Uri photoUri = getContentResolver().insert(builder.build(), values);
 long photoId = ContentUris.parseId(photoUri);
 

Update

Updates can only be made against a specific ContactsContract.StreamItems.StreamItemPhotos entry, identified by both the stream item ID it belongs to and the stream item photo ID. This can be specified in two ways.

Via the CONTENT_DIRECTORY sub-path of a stream item:

 ContentValues values = new ContentValues();
 values.put(StreamItemPhotos.PHOTO, newPhotoData);
 Uri.Builder builder = StreamItems.CONTENT_URI.buildUpon();
 ContentUris.appendId(builder, streamItemId);
 builder.appendEncodedPath(StreamItems.StreamItemPhotos.CONTENT_DIRECTORY);
 ContentUris.appendId(builder, streamItemPhotoId);
 builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
 builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
 getContentResolver().update(builder.build(), values, null, null);
 

Via the CONTENT_PHOTO_URI URI:

 ContentValues values = new ContentValues();
 values.put(StreamItemPhotos.STREAM_ITEM_ID, streamItemId);
 values.put(StreamItemPhotos.PHOTO, newPhotoData);
 Uri.Builder builder = StreamItems.CONTENT_PHOTO_URI.buildUpon();
 builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
 builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
 getContentResolver().update(builder.build(), values);
 

Delete

Deletes can be made against either a specific photo item in a stream item, or against all or a selected subset of photo items under a stream item. For example:

Deleting a single photo via the CONTENT_DIRECTORY sub-path of a stream item:

 Uri.Builder builder = StreamItems.CONTENT_URI.buildUpon();
 ContentUris.appendId(builder, streamItemId);
 builder.appendEncodedPath(StreamItems.StreamItemPhotos.CONTENT_DIRECTORY);
 ContentUris.appendId(builder, streamItemPhotoId);
 builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
 builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
 getContentResolver().delete(builder.build(), null, null);
 

Deleting all photos under a stream item

 Uri.Builder builder = StreamItems.CONTENT_URI.buildUpon();
 ContentUris.appendId(builder, streamItemId);
 builder.appendEncodedPath(StreamItems.StreamItemPhotos.CONTENT_DIRECTORY);
 builder.appendQueryParameter(RawContacts.ACCOUNT_NAME, accountName);
 builder.appendQueryParameter(RawContacts.ACCOUNT_TYPE, accountType);
 getContentResolver().delete(builder.build(), null, null);
 

Query

Querying for a specific photo in a stream item

 Cursor c = getContentResolver().query(
     ContentUris.withAppendedId(
         Uri.withAppendedPath(
             ContentUris.withAppendedId(StreamItems.CONTENT_URI, streamItemId)
             StreamItems.StreamItemPhotos#CONTENT_DIRECTORY),
         streamItemPhotoId), null, null, null, null);
 

Querying for all photos in a stream item

 Cursor c = getContentResolver().query(
     Uri.withAppendedPath(
         ContentUris.withAppendedId(StreamItems.CONTENT_URI, streamItemId)
         StreamItems.StreamItemPhotos#CONTENT_DIRECTORY),
     null, null, null, StreamItemPhotos.SORT_INDEX);
 

The record will contain both a PHOTO_FILE_ID and a PHOTO_URI. The PHOTO_FILE_ID can be used in conjunction with the ContactsContract.DisplayPhoto API to retrieve photo content, or you can open the PHOTO_URI as an asset file, as follows:

 public InputStream openDisplayPhoto(String photoUri) {
     try {
         AssetFileDescriptor fd = getContentResolver().openAssetFileDescriptor(photoUri, "r");
         return fd.createInputStream();
     } catch (IOException e) {
         return null;
     }
 }
 
 
 

Summary

[Expand] Inherited Constants
From interface android.provider.BaseColumns String _COUNT The count of rows in a directory. String _ID The unique ID for a row.
From interface android.provider.ContactsContract.StreamItemPhotosColumns String PHOTO_FILE_ID This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String PHOTO_URI This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String SORT_INDEX This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String STREAM_ITEM_ID This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String SYNC1 This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String SYNC2 This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String SYNC3 This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty. String SYNC4 This constant was deprecated in API level 21. - Do not use. This will not be supported in the future. In the future, cursors returned from related queries will be empty.

[Expand] Inherited Methods

From class java.lang.Object Object clone() Creates and returns a copy of this Object. boolean equals(Object o) Compares this instance with the specified object and indicates if they are equal. void finalize() Invoked when the garbage collector has detected that this instance is no longer reachable. final Class<?> getClass() Returns the unique instance of Class that represents this object's class. int hashCode() Returns an integer hash code for this object. final void notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up. final void notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up. String toString() Returns a string containing a concise, human-readable description of this object. final void wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object. final void wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires. final void wait(long millis) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.