MediaStore.Images.Media

public static final class MediaStore.Images.Media
extends Object implements MediaStore.Images.ImageColumns

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


Summary

Constants

String CONTENT_TYPE

The MIME type of this directory of images.

String DEFAULT_SORT_ORDER

The default sort order for this table

Inherited constants

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 Bitmap getBitmap(ContentResolver cr, Uri url)

This method was deprecated in API level 29. loading of images should be performed through ImageDecoder#createSource(ContentResolver, Uri), which offers modern features like PostProcessor.

static Uri getContentUri(String volumeName)

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

static Uri getContentUri(String volumeName, long id)

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

static String insertImage(ContentResolver cr, String imagePath, String name, String description)

This method was deprecated in API level 29. inserting of images should be performed using MediaColumns#IS_PENDING, which offers richer control over lifecycle.

static String insertImage(ContentResolver cr, Bitmap source, String title, String description)

This method was deprecated in API level 29. inserting of images should be performed using MediaColumns#IS_PENDING, which offers richer control over lifecycle.

static Cursor query(ContentResolver cr, Uri uri, String[] projection)

This method was deprecated in API level 29. all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

static Cursor query(ContentResolver cr, Uri uri, String[] projection, String where, String orderBy)

This method was deprecated in API level 29. all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

static Cursor query(ContentResolver cr, Uri uri, String[] projection, String selection, String[] selectionArgs, String orderBy)

This method was deprecated in API level 29. all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Inherited methods

Constants

CONTENT_TYPE

Added in API level 1
public static final String CONTENT_TYPE

The MIME type of this directory of images. Note that each entry in this directory will have a standard image MIME type as appropriate -- for example, image/jpeg.

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

DEFAULT_SORT_ORDER

Added in API level 1
public static final String DEFAULT_SORT_ORDER

The default sort order for this table

Constant Value: "bucket_display_name"

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

getBitmap

Added in API level 1
Deprecated in API level 29
public static Bitmap getBitmap (ContentResolver cr, 
                Uri url)

This method was deprecated in API level 29.
loading of images should be performed through ImageDecoder#createSource(ContentResolver, Uri), which offers modern features like PostProcessor.

Retrieves an image for the given url as a Bitmap.

Parameters
cr ContentResolver: The content resolver to use

url Uri: The url of the image

Returns
Bitmap

Throws
FileNotFoundException
IOException

getContentUri

Added in API level 1
public static Uri getContentUri (String volumeName)

Get the content:// style URI for the image 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 image 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 images 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 image to get the URI for

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

insertImage

Added in API level 1
Deprecated in API level 29
public static String insertImage (ContentResolver cr, 
                String imagePath, 
                String name, 
                String description)

This method was deprecated in API level 29.
inserting of images should be performed using MediaColumns#IS_PENDING, which offers richer control over lifecycle.

Insert an image and create a thumbnail for it.

Parameters
cr ContentResolver: The content resolver to use

imagePath String: The path to the image to insert

name String: The name of the image

description String: The description of the image

Returns
String The URL to the newly created image

Throws
FileNotFoundException

insertImage

Added in API level 1
Deprecated in API level 29
public static String insertImage (ContentResolver cr, 
                Bitmap source, 
                String title, 
                String description)

This method was deprecated in API level 29.
inserting of images should be performed using MediaColumns#IS_PENDING, which offers richer control over lifecycle.

Insert an image and create a thumbnail for it.

Parameters
cr ContentResolver: The content resolver to use

source Bitmap: The stream to use for the image

title String: The name of the image

description String: The description of the image

Returns
String The URL to the newly created image, or null if the image failed to be stored for any reason.

query

Added in API level 1
Deprecated in API level 29
public static Cursor query (ContentResolver cr, 
                Uri uri, 
                String[] projection)

This method was deprecated in API level 29.
all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Parameters
cr ContentResolver

uri Uri

projection String

Returns
Cursor

query

Added in API level 1
Deprecated in API level 29
public static Cursor query (ContentResolver cr, 
                Uri uri, 
                String[] projection, 
                String where, 
                String orderBy)

This method was deprecated in API level 29.
all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Parameters
cr ContentResolver

uri Uri

projection String

where String

orderBy String

Returns
Cursor

query

Added in API level 1
Deprecated in API level 29
public static Cursor query (ContentResolver cr, 
                Uri uri, 
                String[] projection, 
                String selection, 
                String[] selectionArgs, 
                String orderBy)

This method was deprecated in API level 29.
all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Parameters
cr ContentResolver

uri Uri

projection String

selection String

selectionArgs String

orderBy String

Returns
Cursor