MediaStore.Files.FileColumns


public static interface MediaStore.Files.FileColumns
implements MediaStore.MediaColumns

android.provider.MediaStore.Files.FileColumns


File metadata columns.

Summary

Constants

String MEDIA_TYPE

The media type (audio, video, image, document, playlist or subtitle) of the file, or 0 for not a media file
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object.

int MEDIA_TYPE_AUDIO

Constant for the MEDIA_TYPE column indicating that file is an audio file.

int MEDIA_TYPE_DOCUMENT

Constant for the MEDIA_TYPE column indicating that file is a document file.

int MEDIA_TYPE_IMAGE

Constant for the MEDIA_TYPE column indicating that file is an image file.

int MEDIA_TYPE_NONE

Constant for the MEDIA_TYPE column indicating that file is not an audio, image, video, document, playlist, or subtitles file.

int MEDIA_TYPE_PLAYLIST

This constant was deprecated in API level 31. Android playlists are now deprecated. We will keep the current functionality for compatibility reasons, but we will no longer take feature request. We do not advise adding new usages of Android Playlists. M3U files can be used as an alternative.

int MEDIA_TYPE_SUBTITLE

Constant for the MEDIA_TYPE column indicating that file is a subtitles or lyrics file.

int MEDIA_TYPE_VIDEO

Constant for the MEDIA_TYPE column indicating that file is a video file.

String MIME_TYPE

The MIME type of the media item.

String PARENT

The index of the parent directory of the file
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object.

Inherited constants

String ALBUM

Indexed value of MediaMetadataRetriever.METADATA_KEY_ALBUM extracted from this media item.

String ALBUM_ARTIST

Indexed value of MediaMetadataRetriever.METADATA_KEY_ALBUMARTIST extracted from this media item.

String ARTIST

Indexed value of MediaMetadataRetriever.METADATA_KEY_ARTIST or ExifInterface.TAG_ARTIST extracted from this media item.

String AUTHOR

Indexed value of MediaMetadataRetriever.METADATA_KEY_AUTHOR extracted from this media item.

String BITRATE

Indexed value of MediaMetadataRetriever.METADATA_KEY_BITRATE extracted from this media item.

String BUCKET_DISPLAY_NAME

The primary bucket display name of this media item.

String BUCKET_ID

The primary bucket ID of this media item.

String CAPTURE_FRAMERATE

Indexed value of MediaMetadataRetriever.METADATA_KEY_CAPTURE_FRAMERATE extracted from this media item.

String CD_TRACK_NUMBER

Indexed value of MediaMetadataRetriever.METADATA_KEY_CD_TRACK_NUMBER extracted from this media item.

String COMPILATION

Indexed value of MediaMetadataRetriever.METADATA_KEY_COMPILATION extracted from this media item.

String COMPOSER

Indexed value of MediaMetadataRetriever.METADATA_KEY_COMPOSER extracted from this media item.

String DATA

Absolute filesystem path to the media item on disk.

String DATE_ADDED

The time the media item was first added.

String DATE_EXPIRES

The time the media item should be considered expired.

String DATE_MODIFIED

Indexed value of File.lastModified() extracted from this media item.

String DATE_TAKEN

Indexed value of MediaMetadataRetriever.METADATA_KEY_DATE or ExifInterface.TAG_DATETIME_ORIGINAL extracted from this media item.

String DISC_NUMBER

Indexed value of MediaMetadataRetriever.METADATA_KEY_DISC_NUMBER extracted from this media item.

String DISPLAY_NAME

The display name of the media item.

String DOCUMENT_ID

The "document ID" GUID as defined by the XMP Media Management standard, extracted from any XMP metadata contained within this media item.

String DURATION

Indexed value of MediaMetadataRetriever.METADATA_KEY_DURATION extracted from this media item.

String GENERATION_ADDED

Generation number at which metadata for this media item was first inserted.

String GENERATION_MODIFIED

Generation number at which metadata for this media item was last changed.

String GENRE

Indexed value of MediaMetadataRetriever.METADATA_KEY_GENRE extracted from this media item.

String HEIGHT

Indexed value of MediaMetadataRetriever.METADATA_KEY_VIDEO_HEIGHT, MediaMetadataRetriever.METADATA_KEY_IMAGE_HEIGHT or ExifInterface.TAG_IMAGE_LENGTH extracted from this media item.

String INFERRED_DATE

File's approximate creation date.

String INSTANCE_ID

The "instance ID" GUID as defined by the XMP Media Management standard, extracted from any XMP metadata contained within this media item.

String IS_DOWNLOAD

Flag indicating if the media item has been marked as being part of the Downloads collection.

String IS_DRM

Flag indicating if a media item is DRM protected.

String IS_FAVORITE

Flag indicating if the media item has been marked as being a "favorite" by the user.

String IS_PENDING

Flag indicating if a media item is pending, and still being inserted by its owner.

String IS_TRASHED

Flag indicating if a media item is trashed.

String MIME_TYPE

The MIME type of the media item.

String NUM_TRACKS

Indexed value of MediaMetadataRetriever.METADATA_KEY_NUM_TRACKS extracted from this media item.

String OEM_METADATA

Column which allows OEMs to store custom metadata for a media file.

String ORIENTATION

Indexed value of MediaMetadataRetriever.METADATA_KEY_VIDEO_ROTATION, MediaMetadataRetriever.METADATA_KEY_IMAGE_ROTATION, or ExifInterface.TAG_ORIENTATION extracted from this media item.

String ORIGINAL_DOCUMENT_ID

The "original document ID" GUID as defined by the XMP Media Management standard, extracted from any XMP metadata contained within this media item.

String OWNER_PACKAGE_NAME

Package name that contributed this media.

String RELATIVE_PATH

Relative path of this media item within the storage device where it is persisted.

String RESOLUTION

Calculated value that combines WIDTH and HEIGHT into a user-presentable string.

String SIZE

Indexed value of File.length() extracted from this media item.

String TITLE

Indexed value of MediaMetadataRetriever.METADATA_KEY_TITLE extracted from this media item.

String VOLUME_NAME

Volume name of the specific storage device where this media item is persisted.

String WIDTH

Indexed value of MediaMetadataRetriever.METADATA_KEY_VIDEO_WIDTH, MediaMetadataRetriever.METADATA_KEY_IMAGE_WIDTH or ExifInterface.TAG_IMAGE_WIDTH extracted from this media item.

String WRITER

Indexed value of MediaMetadataRetriever.METADATA_KEY_WRITER extracted from this media item.

String XMP

Indexed XMP metadata extracted from this media item.

String YEAR

Indexed value of MediaMetadataRetriever.METADATA_KEY_YEAR extracted from this media item.

String _COUNT

The count of rows in a directory.

String _ID

The unique ID for a row.

Constants

MEDIA_TYPE

Added in API level 11
public static final String MEDIA_TYPE

The media type (audio, video, image, document, playlist or subtitle) of the file, or 0 for not a media file
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_INTEGER .

Constant Value: "media_type"

MEDIA_TYPE_AUDIO

Added in API level 11
public static final int MEDIA_TYPE_AUDIO

Constant for the MEDIA_TYPE column indicating that file is an audio file.

Constant Value: 2 (0x00000002)

MEDIA_TYPE_DOCUMENT

Added in API level 30
public static final int MEDIA_TYPE_DOCUMENT

Constant for the MEDIA_TYPE column indicating that file is a document file.

Constant Value: 6 (0x00000006)

MEDIA_TYPE_IMAGE

Added in API level 11
public static final int MEDIA_TYPE_IMAGE

Constant for the MEDIA_TYPE column indicating that file is an image file.

Constant Value: 1 (0x00000001)

MEDIA_TYPE_NONE

Added in API level 11
public static final int MEDIA_TYPE_NONE

Constant for the MEDIA_TYPE column indicating that file is not an audio, image, video, document, playlist, or subtitles file.

Constant Value: 0 (0x00000000)

MEDIA_TYPE_PLAYLIST

Added in API level 11
Deprecated in API level 31
public static final int MEDIA_TYPE_PLAYLIST

This constant was deprecated in API level 31.
Android playlists are now deprecated. We will keep the current functionality for compatibility reasons, but we will no longer take feature request. We do not advise adding new usages of Android Playlists. M3U files can be used as an alternative.

Constant for the MEDIA_TYPE column indicating that file is a playlist file.

Constant Value: 4 (0x00000004)

MEDIA_TYPE_SUBTITLE

Added in API level 30
public static final int MEDIA_TYPE_SUBTITLE

Constant for the MEDIA_TYPE column indicating that file is a subtitles or lyrics file.

Constant Value: 5 (0x00000005)

MEDIA_TYPE_VIDEO

Added in API level 11
public static final int MEDIA_TYPE_VIDEO

Constant for the MEDIA_TYPE column indicating that file is a video file.

Constant Value: 3 (0x00000003)

MIME_TYPE

Added in API level 11
public static final String MIME_TYPE

The MIME type of the media item.

This is typically defined based on the file extension of the media item. However, it may be the value of the format attribute defined by the Dublin Core Media Initiative standard, extracted from any XMP metadata contained within this media item.

Note: the format attribute may be ignored if the top-level MIME type disagrees with the file extension. For example, it's reasonable for an image/jpeg file to declare a format of image/vnd.google.panorama360+jpg, but declaring a format of audio/ogg would be ignored.

This is a read-only column that is automatically computed.
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_STRING .

Constant Value: "mime_type"

PARENT

Added in API level 11
public static final String PARENT

The index of the parent directory of the file
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_INTEGER , and are read-only and cannot be mutated.

Constant Value: "parent"