Added in API level 1

MediaStore.Audio.Media

Kotlin |Java

public static final class MediaStore.Audio.Media
extends Object implements MediaStore.Audio.AudioColumns

java.lang.Object
↳	android.provider.MediaStore.Audio.Media

Summary

Constants
`String`	`CONTENT_TYPE` The MIME type for this table.
`String`	`DEFAULT_SORT_ORDER` The default sort order for this table
`String`	`ENTRY_CONTENT_TYPE` The MIME type for an audio track.
`String`	`EXTRA_MAX_BYTES` The name of the Intent-extra used to define a maximum file size for a recording made by the SoundRecorder application.
`String`	`RECORD_SOUND_ACTION` Activity Action: Start SoundRecorder application.

Inherited constants

From interface android.provider.MediaStore.Audio.AudioColumns

`String`	`ALBUM_ID` The id of the album the audio file is from, if any This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`ALBUM_KEY` This constant was deprecated in API level 30. These keys are generated using `Locale.ROOT`, which means they don't reflect locale-specific sorting preferences. To apply locale-specific sorting preferences, use `ContentResolver.QUERY_ARG_SQL_SORT_ORDER` with `COLLATE LOCALIZED`, or `ContentResolver.QUERY_ARG_SORT_LOCALE`.
`String`	`ARTIST_ID` The id of the artist who created the audio file, if any This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`ARTIST_KEY` This constant was deprecated in API level 30. These keys are generated using `Locale.ROOT`, which means they don't reflect locale-specific sorting preferences. To apply locale-specific sorting preferences, use `ContentResolver.QUERY_ARG_SQL_SORT_ORDER` with `COLLATE LOCALIZED`, or `ContentResolver.QUERY_ARG_SORT_LOCALE`.
`String`	`BITS_PER_SAMPLE` The number of bits used to represent each audio sample, if available.
`String`	`BOOKMARK` The position within the audio item at which playback should be resumed.
`String`	`GENRE` The genre of the audio file, if any.
`String`	`GENRE_ID` The id of the genre the audio file is from, if any This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`GENRE_KEY` This constant was deprecated in API level 30. These keys are generated using `Locale.ROOT`, which means they don't reflect locale-specific sorting preferences. To apply locale-specific sorting preferences, use `ContentResolver.QUERY_ARG_SQL_SORT_ORDER` with `COLLATE LOCALIZED`, or `ContentResolver.QUERY_ARG_SORT_LOCALE`.
`String`	`IS_ALARM` Non-zero if the audio file may be an alarm This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IS_AUDIOBOOK` Non-zero if the audio file is an audiobook This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IS_MUSIC` Non-zero if the audio file is music This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IS_NOTIFICATION` Non-zero if the audio file may be a notification sound This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IS_PODCAST` Non-zero if the audio file is a podcast This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IS_RECORDING` Non-zero if the audio file is a voice recording recorded by voice recorder apps This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IS_RINGTONE` Non-zero if the audio file may be a ringtone This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`SAMPLERATE` The sample rate in Hz, if available.
`String`	`TITLE_KEY` This constant was deprecated in API level 30. These keys are generated using `Locale.ROOT`, which means they don't reflect locale-specific sorting preferences. To apply locale-specific sorting preferences, use `ContentResolver.QUERY_ARG_SQL_SORT_ORDER` with `COLLATE LOCALIZED`, or `ContentResolver.QUERY_ARG_SORT_LOCALE`.
`String`	`TITLE_RESOURCE_URI` The resource URI of a localized title, if any.
`String`	`TRACK` The track number of this song on the album, if any.
`String`	`YEAR` The year the audio file was recorded, if any This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.

From interface android.provider.MediaStore.MediaColumns

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

From interface android.provider.BaseColumns

`String`	`_COUNT` The count of rows in a directory.
`String`	`_ID` The unique ID for a row.

Fields
`public static final Uri`	`EXTERNAL_CONTENT_URI` The content:// style URI for the "primary" external storage volume.
`public static final Uri`	`INTERNAL_CONTENT_URI` The content:// style URI for the internal storage.

Public constructors
`Media()`

Public methods
`static Uri`	`getContentUri(String volumeName)` Get the content:// style URI for the audio media table on the given volume.
`static Uri`	`getContentUri(String volumeName, long id)` Get the content:// style URI for a single row in the audio table on the given volume.
`static Uri`	`getContentUriForPath(String path)` This method was deprecated in API level 29. Apps may not have filesystem permissions to directly access this path.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

CONTENT_TYPE

Added in API level 1

public static final String CONTENT_TYPE

The MIME type for this table.

Constant Value: "vnd.android.cursor.dir/audio"

DEFAULT_SORT_ORDER

Added in API level 1

public static final String DEFAULT_SORT_ORDER

The default sort order for this table

Constant Value: "title_key"

ENTRY_CONTENT_TYPE

Added in API level 21

public static final String ENTRY_CONTENT_TYPE

The MIME type for an audio track.

Constant Value: "vnd.android.cursor.item/audio"

EXTRA_MAX_BYTES

Added in API level 3

public static final String EXTRA_MAX_BYTES

The name of the Intent-extra used to define a maximum file size for a recording made by the SoundRecorder application.

See also:

RECORD_SOUND_ACTION

Constant Value: "android.provider.MediaStore.extra.MAX_BYTES"

RECORD_SOUND_ACTION

Added in API level 1

public static final String RECORD_SOUND_ACTION

Activity Action: Start SoundRecorder application.

Input: nothing.

Output: An uri to the recorded sound stored in the Media Library if the recording was successful. May also contain the extra EXTRA_MAX_BYTES.

See also:

EXTRA_MAX_BYTES

Constant Value: "android.provider.MediaStore.RECORD_SOUND"

Fields

EXTERNAL_CONTENT_URI

Added in API level 1

public static final Uri EXTERNAL_CONTENT_URI

The content:// style URI for the "primary" external storage volume.

INTERNAL_CONTENT_URI

Added in API level 1

public static final Uri INTERNAL_CONTENT_URI

The content:// style URI for the internal storage.

Public constructors

Media

Added in API level 1

public Media ()

Public methods

getContentUri

Added in API level 1

public static Uri getContentUri (String volumeName)

Get the content:// style URI for the audio media table on the given volume.

Parameters
`volumeName`	`String`: the name of the volume to get the URI for

Returns
`Uri`	the URI to the audio media table on the given volume

getContentUri

Added in API level 30

public static Uri getContentUri (String volumeName, 
                long id)

Get the content:// style URI for a single row in the audio table on the given volume.

Parameters
`volumeName`	`String`: the name of the volume to get the URI for This value cannot be `null`.
`id`	`long`: the audio to get the URI for

Returns
`Uri`	the URI to the audio table on the given volume This value cannot be `null`.

getContentUriForPath

Added in API level 1
Deprecated in API level 29

public static Uri getContentUriForPath (String path)

This method was deprecated in API level 29.
Apps may not have filesystem permissions to directly access this path.

Get the content:// style URI for the given audio media file.

Parameters
`path`	`String`: This value cannot be `null`.

Returns
`Uri`	This value may be `null`.