CloudMediaProviderContract.MediaCollectionInfo
public
static
final
class
CloudMediaProviderContract.MediaCollectionInfo
extends Object
java.lang.Object | |
↳ | android.provider.CloudMediaProviderContract.MediaCollectionInfo |
Constants related to a media collection
Summary
Constants | |
---|---|
String |
ACCOUNT_CONFIGURATION_INTENT
|
String |
ACCOUNT_NAME
Name of the account that owns the media collection. |
String |
LAST_MEDIA_SYNC_GENERATION
Last |
String |
MEDIA_COLLECTION_ID
Media collection identifier The only requirement on the collection ID is uniqueness on a device. |
Inherited methods | |
---|---|
Constants
ACCOUNT_CONFIGURATION_INTENT
public static final String ACCOUNT_CONFIGURATION_INTENT
Intent
Intent to launch an Activity
to allow users configure their media
collection account information like the account name.
Type: PARCELABLE
Constant Value: "account_configuration_intent"
ACCOUNT_NAME
public static final String ACCOUNT_NAME
Name of the account that owns the media collection.
Type: STRING
Constant Value: "account_name"
LAST_MEDIA_SYNC_GENERATION
public static final String LAST_MEDIA_SYNC_GENERATION
Last CloudMediaProviderContract.MediaColumns#SYNC_GENERATION
in the media
collection including deleted media items.
Providers should associate a monotonically increasing sync generation to each media item change (insertion/deletion/update). This is useful for the OS to quickly identify exactly which media items have changed since a previous point in time.
Type: LONG
See also:
Constant Value: "last_media_sync_generation"
MEDIA_COLLECTION_ID
public static final String MEDIA_COLLECTION_ID
Media collection identifier
The only requirement on the collection ID is uniqueness on a device.
This value will not be interpreted by the OS, however it will be used to check the validity of cached data and URI grants to client apps. Anytime the media or album ids get re-indexed, a new collection with a new and unique id should be created so that the OS can clear its cache and more importantly, revoke any URI grants to apps.
Apps are recommended to generate unique collection ids with, UUID#randomUUID
.
This is preferred to using a simple monotonic sequence because the provider data could
get cleared and it might have to re-index media items on the device without any history
of its last ID. With random UUIDs, if data gets cleared, a new one can easily be
generated safely.
Type: STRING
Constant Value: "media_collection_id"