public final class

MediaStore

extends Object
java.lang.Object
   ↳android.provider.MediaStore

Class Overview

The Media provider contains meta data for all available media on both internal and external storage devices.

Summary

Nested Classes
classMediaStore.AudioContainer for all audio content. 
classMediaStore.ImagesContains meta data for all available images. 
interfaceMediaStore.MediaColumnsCommon fields for most MediaProvider tables  
classMediaStore.Video 
Constants
StringACTION_IMAGE_CAPTUREStandard Intent action that can be sent to have the camera application capture an image and return it.
StringACTION_VIDEO_CAPTUREStandard Intent action that can be sent to have the camera application capture an video and return it.
StringAUTHORITY
StringEXTRA_DURATION_LIMITSpecify the maximum allowed recording duration in seconds.
StringEXTRA_FINISH_ON_COMPLETIONThe name of the Intent-extra used to control the onCompletion behavior of a MovieView.
StringEXTRA_FULL_SCREENThe name of an Intent-extra used to control the UI of a ViewImage.
StringEXTRA_MEDIA_ALBUMThe name of the Intent-extra used to define the album
StringEXTRA_MEDIA_ARTISTThe name of the Intent-extra used to define the artist
StringEXTRA_MEDIA_FOCUSThe name of the Intent-extra used to define the search focus.
StringEXTRA_MEDIA_TITLEThe name of the Intent-extra used to define the song title
StringEXTRA_OUTPUTThe name of the Intent-extra used to indicate a content resolver Uri to be used to store the requested image or video.
StringEXTRA_SCREEN_ORIENTATIONThe name of the Intent-extra used to control the orientation of a ViewImage or a MovieView.
StringEXTRA_SHOW_ACTION_ICONSThe name of an Intent-extra used to control the UI of a ViewImage.
StringEXTRA_SIZE_LIMITSpecify the maximum allowed size.
StringEXTRA_VIDEO_QUALITYThe name of the Intent-extra used to control the quality of a recorded video.
StringINTENT_ACTION_MEDIA_PLAY_FROM_SEARCHAn intent to perform a search for music media and automatically play content from the result when possible.
StringINTENT_ACTION_MEDIA_SEARCHActivity Action: Perform a search for media.
StringINTENT_ACTION_MUSIC_PLAYERActivity Action: Launch a music player.
StringINTENT_ACTION_STILL_IMAGE_CAMERAThe name of the Intent action used to launch a camera in still image mode.
StringINTENT_ACTION_VIDEO_CAMERAThe name of the Intent action used to launch a camera in video mode.
StringMEDIA_IGNORE_FILENAMEName of the file signaling the media scanner to ignore media in the containing directory and its subdirectories.
StringMEDIA_SCANNER_VOLUMEName of current volume being scanned by the media scanner.
StringUNKNOWN_STRINGThe string that is used when a media attribute is not known.
Public Constructors
MediaStore()
Public Methods
static Uri getMediaScannerUri()
Uri for querying the state of the media scanner.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String ACTION_IMAGE_CAPTURE

Since: API Level 3

Standard Intent action that can be sent to have the camera application capture an image and return it.

The caller may pass an extra EXTRA_OUTPUT to control where this image will be written. If the EXTRA_OUTPUT is not present, then a small sized image is returned as a Bitmap object in the extra field. This is useful for applications that only need a small image. If the EXTRA_OUTPUT is present, then the full-sized image will be written to the Uri value of EXTRA_OUTPUT.

Constant Value: "android.media.action.IMAGE_CAPTURE"

public static final String ACTION_VIDEO_CAPTURE

Since: API Level 3

Standard Intent action that can be sent to have the camera application capture an video and return it.

The caller may pass in an extra EXTRA_VIDEO_QUALITY to control the video quality.

The caller may pass in an extra EXTRA_OUTPUT to control where the video is written. If EXTRA_OUTPUT is not present the video will be written to the standard location for videos, and the Uri of that location will be returned in the data field of the Uri.

See Also
Constant Value: "android.media.action.VIDEO_CAPTURE"

public static final String AUTHORITY

Since: API Level 1

Constant Value: "media"

public static final String EXTRA_DURATION_LIMIT

Since: API Level 8

Specify the maximum allowed recording duration in seconds.

Constant Value: "android.intent.extra.durationLimit"

public static final String EXTRA_FINISH_ON_COMPLETION

Since: API Level 3

The name of the Intent-extra used to control the onCompletion behavior of a MovieView. This is a boolean property that specifies whether or not to finish the MovieView activity when the movie completes playing. The default value is true, which means to automatically exit the movie player activity when the movie completes playing.

Constant Value: "android.intent.extra.finishOnCompletion"

public static final String EXTRA_FULL_SCREEN

Since: API Level 8

The name of an Intent-extra used to control the UI of a ViewImage. This is a boolean property that overrides the activity's default fullscreen state.

Constant Value: "android.intent.extra.fullScreen"

public static final String EXTRA_MEDIA_ALBUM

Since: API Level 3

The name of the Intent-extra used to define the album

Constant Value: "android.intent.extra.album"

public static final String EXTRA_MEDIA_ARTIST

Since: API Level 3

The name of the Intent-extra used to define the artist

Constant Value: "android.intent.extra.artist"

public static final String EXTRA_MEDIA_FOCUS

Since: API Level 3

The name of the Intent-extra used to define the search focus. The search focus indicates whether the search should be for things related to the artist, album or song that is identified by the other extras.

Constant Value: "android.intent.extra.focus"

public static final String EXTRA_MEDIA_TITLE

Since: API Level 3

The name of the Intent-extra used to define the song title

Constant Value: "android.intent.extra.title"

public static final String EXTRA_OUTPUT

Since: API Level 3

The name of the Intent-extra used to indicate a content resolver Uri to be used to store the requested image or video.

Constant Value: "output"

public static final String EXTRA_SCREEN_ORIENTATION

Since: API Level 3

The name of the Intent-extra used to control the orientation of a ViewImage or a MovieView. This is an int property that overrides the activity's requestedOrientation.

Constant Value: "android.intent.extra.screenOrientation"

public static final String EXTRA_SHOW_ACTION_ICONS

Since: API Level 8

The name of an Intent-extra used to control the UI of a ViewImage. This is a boolean property that specifies whether or not to show action icons.

Constant Value: "android.intent.extra.showActionIcons"

public static final String EXTRA_SIZE_LIMIT

Since: API Level 8

Specify the maximum allowed size.

Constant Value: "android.intent.extra.sizeLimit"

public static final String EXTRA_VIDEO_QUALITY

Since: API Level 3

The name of the Intent-extra used to control the quality of a recorded video. This is an integer property. Currently value 0 means low quality, suitable for MMS messages, and value 1 means high quality. In the future other quality levels may be added.

Constant Value: "android.intent.extra.videoQuality"

public static final String INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH

Since: API Level 9

An intent to perform a search for music media and automatically play content from the result when possible. This can be fired, for example, by the result of a voice recognition command to listen to music.

Contains the QUERY extra, which is a string that can contain any type of unstructured music search, like the name of an artist, an album, a song, a genre, or any combination of these.

Because this intent includes an open-ended unstructured search string, it makes the most sense for apps that can support large-scale search of music, such as services connected to an online database of music which can be streamed and played on the device.

Constant Value: "android.media.action.MEDIA_PLAY_FROM_SEARCH"

public static final String INTENT_ACTION_MEDIA_SEARCH

Since: API Level 3

Activity Action: Perform a search for media. Contains at least the QUERY extra. May also contain any combination of the following extras: EXTRA_MEDIA_ARTIST, EXTRA_MEDIA_ALBUM, EXTRA_MEDIA_TITLE, EXTRA_MEDIA_FOCUS

Constant Value: "android.intent.action.MEDIA_SEARCH"

public static final String INTENT_ACTION_MUSIC_PLAYER

Since: API Level 8

Activity Action: Launch a music player. The activity should be able to play, browse, or manipulate music files stored on the device.

Constant Value: "android.intent.action.MUSIC_PLAYER"

public static final String INTENT_ACTION_STILL_IMAGE_CAMERA

Since: API Level 3

The name of the Intent action used to launch a camera in still image mode.

Constant Value: "android.media.action.STILL_IMAGE_CAMERA"

public static final String INTENT_ACTION_VIDEO_CAMERA

Since: API Level 3

The name of the Intent action used to launch a camera in video mode.

Constant Value: "android.media.action.VIDEO_CAMERA"

public static final String MEDIA_IGNORE_FILENAME

Since: API Level 9

Name of the file signaling the media scanner to ignore media in the containing directory and its subdirectories. Developers should use this to avoid application graphics showing up in the Gallery and likewise prevent application sounds and music from showing up in the Music app.

Constant Value: ".nomedia"

public static final String MEDIA_SCANNER_VOLUME

Since: API Level 1

Name of current volume being scanned by the media scanner.

Constant Value: "volume"

public static final String UNKNOWN_STRING

Since: API Level 8

The string that is used when a media attribute is not known. For example, if an audio file does not have any meta data, the artist and album columns will be set to this value.

Constant Value: ""

Public Constructors

public MediaStore ()

Since: API Level 1

Public Methods

public static Uri getMediaScannerUri ()

Since: API Level 1

Uri for querying the state of the media scanner.