MediaColumns
class MediaColumns
kotlin.Any | |
↳ | android.provider.CloudMediaProviderContract.MediaColumns |
Constants related to a media item, including Cursor
column names
Summary
Constants | |
---|---|
static String |
Timestamp when a media item was capture, in milliseconds since January 1, 1970 00:00:00. |
static String |
Duration of a video file in ms. |
static String |
This column contains the height of the image or video. |
static String |
Unique ID of a media item. |
static String |
Whether the item has been favourited in the media collection. |
static String |
|
static String |
Concrete MIME type of a media file. |
static String |
This column contains the orientation, if available. |
static String |
Size of a media file, in bytes. |
static String |
Mime-type extension representing special format for a media item. |
static Int |
Constant for the |
static Int |
Constant for the |
static Int |
Constant for the |
static Int |
Constant for the |
static String |
Non-negative number associated with a media item indicating what generation or batch the media item was synced into the media collection. |
static String |
This column contains the width of the image or video. |
Constants
DATE_TAKEN_MILLIS
static val DATE_TAKEN_MILLIS: String
Timestamp when a media item was capture, in milliseconds since January 1, 1970 00:00:00.0 UTC.
Implementations should extract this data from the metadata embedded in the media file. If this information is not available, a reasonable heuristic can be used, e.g. the time the media file was added to the media collection.
Type: LONG
Value: "date_taken_millis"
DURATION_MILLIS
static val DURATION_MILLIS: String
Duration of a video file in ms. If the file is an image for which duration is not applicable, this field can be left empty or set to zero
.
Type: LONG
Value: "duration_millis"
HEIGHT
static val HEIGHT: String
This column contains the height of the image or video.
Value: "height"
ID
static val ID: String
Unique ID of a media item. This ID is both provided by and interpreted by a CloudMediaProvider
, and should be treated as an opaque value by client applications.
Each media item must have a unique ID within a provider.
A provider must always return stable IDs, since they will be used to issue long-term URI permission grants when an application interacts with MediaStore#ACTION_PICK_IMAGES
.
Type: STRING
Value: "id"
IS_FAVORITE
static val IS_FAVORITE: String
Whether the item has been favourited in the media collection. If non-zero
, this media item will appear in the favourites category in the Photo Picker.
Type: INTEGER
Value: "is_favorite"
MEDIA_STORE_URI
static val MEDIA_STORE_URI: String
MediaStore
URI of a media file if the file is available locally on the device.
If it's a cloud-only media file, this field should not be set. Any of the following URIs can be used: MediaStore.Files
, MediaStore.Images
or MediaStore.Video
e.g. content://media/file/45
.
Implementations don't need to handle the MediaStore
URI becoming invalid after the local item has been deleted or modified. If the URI becomes invalid or the local and cloud file content diverges, the OS will treat the cloud media item as a cloud-only item.
Type: STRING
Value: "media_store_uri"
MIME_TYPE
static val MIME_TYPE: String
Concrete MIME type of a media file. For example, "image/png" or "video/mp4".
Type: STRING
Value: "mime_type"
ORIENTATION
static val ORIENTATION: String
This column contains the orientation, if available.
For consistency the indexed value is expressed in degrees, such as 0, 90, 180, or 270.
Value: "orientation"
SIZE_BYTES
static val SIZE_BYTES: String
Size of a media file, in bytes.
Type: LONG
Value: "size_bytes"
STANDARD_MIME_TYPE_EXTENSION
static val STANDARD_MIME_TYPE_EXTENSION: String
Mime-type extension representing special format for a media item. Photo Picker requires special format tagging for media items. This is essential as media items can have various formats like Motion Photos, GIFs etc, which are not identifiable by MIME_TYPE
.
Type: INTEGER
Value: "standard_mime_type_extension"
STANDARD_MIME_TYPE_EXTENSION_ANIMATED_WEBP
static val STANDARD_MIME_TYPE_EXTENSION_ANIMATED_WEBP: Int
Constant for the STANDARD_MIME_TYPE_EXTENSION
column indicating that the media item is an Animated Webp.
Value: 3
STANDARD_MIME_TYPE_EXTENSION_GIF
static val STANDARD_MIME_TYPE_EXTENSION_GIF: Int
Constant for the STANDARD_MIME_TYPE_EXTENSION
column indicating that the media item is a GIF.
Value: 1
STANDARD_MIME_TYPE_EXTENSION_MOTION_PHOTO
static val STANDARD_MIME_TYPE_EXTENSION_MOTION_PHOTO: Int
Constant for the STANDARD_MIME_TYPE_EXTENSION
column indicating that the media item is a Motion Photo.
Value: 2
STANDARD_MIME_TYPE_EXTENSION_NONE
static val STANDARD_MIME_TYPE_EXTENSION_NONE: Int
Constant for the STANDARD_MIME_TYPE_EXTENSION
column indicating that the media item doesn't have any special format associated with it.
Value: 0
SYNC_GENERATION
static val SYNC_GENERATION: String
Non-negative number associated with a media item indicating what generation or batch the media item was synced into the media collection.
Providers should associate a monotonically increasing sync generation number to each media item which is expected to increase for each atomic modification on the media item. This is useful for the OS to quickly identify that a media item has changed since a previous point in time. Note that this does not need to be unique across all media items, i.e. multiple media items can have the same SYNC_GENERATION value. However, the modification of a media item should increase the MediaCollectionInfo#LAST_MEDIA_SYNC_GENERATION
.
Type: LONG
Value: "sync_generation"