ContactsContract.StreamItemPhotos

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 Photo file ID for the photo. String PHOTO_URI URI for retrieving the photo content, automatically populated. String SORT_INDEX An integer to use for sort order for photos in the stream item. String STREAM_ITEM_ID A reference to the _ID this photo is associated with. String SYNC1 Generic column for use by sync adapters. String SYNC2 Generic column for use by sync adapters. String SYNC3 Generic column for use by sync adapters. String SYNC4 Generic column for use by sync adapters.

[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.