Skip to content

Most visited

Recently visited

navigation
Added in API level 1

android.media

Provides classes that manage various media interfaces in audio and video.

The Media APIs are used to play and, in some cases, record media files. This includes audio (e.g., play MP3s or other music files, ringtones, game sound effects, or DTMF tones) and video (e.g., play a video streamed over the web or from local storage).

Other special classes in the package offer the ability to detect the faces of people in Bitmaps (FaceDetector), control audio routing (to the device or a headset) and control alerts such as ringtones and phone vibrations (AudioManager).

Interfaces

AudioManager.OnAudioFocusChangeListener Interface definition for a callback to be invoked when the audio focus of the system is updated. 
AudioRecord.OnRecordPositionUpdateListener Interface definition for a callback to be invoked when an AudioRecord has reached a notification marker set by setNotificationMarkerPosition(int) or for periodic updates on the progress of the record head, as set by setPositionNotificationPeriod(int)
AudioRecord.OnRoutingChangedListener Defines the interface by which applications can receive notifications of routing changes for the associated AudioRecord
AudioTrack.OnPlaybackPositionUpdateListener Interface definition for a callback to be invoked when the playback head position of an AudioTrack has reached a notification marker or has increased by a certain period. 
AudioTrack.OnRoutingChangedListener Defines the interface by which applications can receive notifications of routing changes for the associated AudioTrack
ImageReader.OnImageAvailableListener Callback interface for being notified that a new image is available. 
ImageWriter.OnImageReleasedListener ImageWriter callback interface, used to to asynchronously notify the application of various ImageWriter events. 
JetPlayer.OnJetEventListener Handles the notification when the JET engine generates an event. 
MediaCodec.OnFrameRenderedListener Listener to be called when an output frame has rendered on the output surface 
MediaDrm.OnEventListener Interface definition for a callback to be invoked when a drm event occurs  
MediaDrm.OnExpirationUpdateListener Interface definition for a callback to be invoked when a drm session expiration update occurs  
MediaDrm.OnKeyStatusChangeListener Interface definition for a callback to be invoked when the keys in a drm session change states. 
MediaPlayer.OnBufferingUpdateListener Interface definition of a callback to be invoked indicating buffering status of a media resource being streamed over the network. 
MediaPlayer.OnCompletionListener Interface definition for a callback to be invoked when playback of a media source has completed. 
MediaPlayer.OnErrorListener Interface definition of a callback to be invoked when there has been an error during an asynchronous operation (other errors will throw exceptions at method call time). 
MediaPlayer.OnInfoListener Interface definition of a callback to be invoked to communicate some info and/or warning about the media or its playback. 
MediaPlayer.OnPreparedListener Interface definition for a callback to be invoked when the media source is ready for playback. 
MediaPlayer.OnSeekCompleteListener Interface definition of a callback to be invoked indicating the completion of a seek operation. 
MediaPlayer.OnTimedMetaDataAvailableListener Interface definition of a callback to be invoked when a track has timed metadata available. 
MediaPlayer.OnTimedTextListener Interface definition of a callback to be invoked when a timed text is available for display. 
MediaPlayer.OnVideoSizeChangedListener Interface definition of a callback to be invoked when the video size is first known or updated  
MediaRecorder.OnErrorListener Interface definition for a callback to be invoked when an error occurs while recording. 
MediaRecorder.OnInfoListener Interface definition for a callback to be invoked when an error occurs while recording. 
MediaScannerConnection.MediaScannerConnectionClient An interface for notifying clients of MediaScannerConnection when a connection to the MediaScanner service has been established and when the scanning of a file has completed. 
MediaScannerConnection.OnScanCompletedListener Interface for notifying clients of the result of scanning a requested media file. 
MediaSync.OnErrorListener Interface definition of a callback to be invoked when there has been an error during an asynchronous operation (other errors will throw exceptions at method call time). 
RemoteControlClient.OnGetPlaybackPositionListener Interface definition for a callback to be invoked when the media playback position is queried. 
RemoteControlClient.OnMetadataUpdateListener Interface definition for a callback to be invoked when one of the metadata values has been updated. 
RemoteControlClient.OnPlaybackPositionUpdateListener Interface definition for a callback to be invoked when the media playback position is requested to be updated. 
RemoteController.OnClientUpdateListener Interface definition for the callbacks to be invoked whenever media events, metadata and playback status are available. 
SoundPool.OnLoadCompleteListener  

Classes

AsyncPlayer Plays a series of audio URIs, but does all the hard work on another thread so that any slowness with preparing or loading doesn't block the calling thread. 
AudioAttributes A class to encapsulate a collection of attributes describing information about an audio stream. 
AudioAttributes.Builder Builder class for AudioAttributes objects. 
AudioDeviceCallback AudioDeviceCallback defines the mechanism by which applications can receive notifications of audio device connection and disconnection events. 
AudioDeviceInfo Class to provide information about the audio devices. 
AudioFormat The AudioFormat class is used to access a number of audio format and channel configuration constants. 
AudioFormat.Builder Builder class for AudioFormat objects. 
AudioManager AudioManager provides access to volume and ringer mode control. 
AudioRecord The AudioRecord class manages the audio resources for Java applications to record audio from the audio input hardware of the platform. 
AudioRecord.Builder Builder class for AudioRecord objects. 
AudioTimestamp Structure that groups a position in frame units relative to an assumed audio stream, together with the estimated time when that frame was presented or is committed to be presented. 
AudioTrack The AudioTrack class manages and plays a single audio resource for Java applications. 
AudioTrack.Builder Builder class for AudioTrack objects. 
CamcorderProfile Retrieves the predefined camcorder profile settings for camcorder applications. 
CameraProfile The CameraProfile class is used to retrieve the pre-defined still image capture (jpeg) quality levels (0-100) used for low, medium, and high quality settings in the Camera application. 
ExifInterface This is a class for reading and writing Exif tags in a JPEG file. 
FaceDetector Identifies the faces of people in a Bitmap graphic object. 
FaceDetector.Face A Face contains all the information identifying the location of a face in a bitmap. 
Image

A single complete image buffer to use with a media source such as a MediaCodec or a CameraDevice

Image.Plane

A single color plane of image data. 

ImageReader

The ImageReader class allows direct application access to image data rendered into a Surface

Several Android media API classes accept Surface objects as targets to render to, including MediaPlayer, MediaCodec, CameraDevice, ImageWriter and RenderScript Allocations

ImageWriter

The ImageWriter class allows an application to produce Image data into a Surface, and have it be consumed by another component like CameraDevice

JetPlayer JetPlayer provides access to JET content playback and control. 
MediaActionSound

A class for producing sounds that match those produced by various actions taken by the media and camera APIs. 

MediaCodec MediaCodec class can be used to access low-level media codecs, i.e. 
MediaCodec.BufferInfo Per buffer metadata includes an offset and size specifying the range of valid data in the associated codec (output) buffer. 
MediaCodec.Callback MediaCodec callback interface. 
MediaCodec.CryptoInfo Metadata describing the structure of a (at least partially) encrypted input sample. 
MediaCodecInfo Provides information about a given media codec available on the device. 
MediaCodecInfo.AudioCapabilities A class that supports querying the audio capabilities of a codec. 
MediaCodecInfo.CodecCapabilities Encapsulates the capabilities of a given codec component. 
MediaCodecInfo.CodecProfileLevel Encapsulates the profiles available for a codec component. 
MediaCodecInfo.EncoderCapabilities A class that supports querying the encoding capabilities of a codec. 
MediaCodecInfo.VideoCapabilities A class that supports querying the video capabilities of a codec. 
MediaCodecList Allows you to enumerate available codecs, each specified as a MediaCodecInfo object, find a codec supporting a given format and query the capabilities of a given codec. 
MediaCrypto MediaCrypto class can be used in conjunction with MediaCodec to decode encrypted media data. 
MediaDataSource For supplying media data to the framework. 
MediaDescription A simple set of metadata for a media item suitable for display. 
MediaDescription.Builder Builder for MediaDescription objects. 
MediaDrm MediaDrm can be used to obtain keys for decrypting protected media streams, in conjunction with MediaCrypto
MediaDrm.CryptoSession In addition to supporting decryption of DASH Common Encrypted Media, the MediaDrm APIs provide the ability to securely deliver session keys from an operator's session key server to a client device, based on the factory-installed root of trust, and then perform encrypt, decrypt, sign and verify operations with the session key on arbitrary user data. 
MediaDrm.KeyRequest Contains the opaque data an app uses to request keys from a license server  
MediaDrm.KeyStatus Defines the status of a key. 
MediaDrm.ProvisionRequest Contains the opaque data an app uses to request a certificate from a provisioning server  
MediaExtractor MediaExtractor facilitates extraction of demuxed, typically encoded, media data from a data source. 
MediaFormat Encapsulates the information describing the format of media data, be it audio or video. 
MediaMetadata Contains metadata about an item, such as the title, artist, etc. 
MediaMetadata.Builder Use to build MediaMetadata objects. 
MediaMetadataEditor This class was deprecated in API level 21. Use MediaMetadata instead together with MediaSession.  
MediaMetadataRetriever MediaMetadataRetriever class provides a unified interface for retrieving frame and meta data from an input media file. 
MediaMuxer MediaMuxer facilitates muxing elementary streams. 
MediaMuxer.OutputFormat Defines the output format. 
MediaPlayer MediaPlayer class can be used to control playback of audio/video files and streams. 
MediaPlayer.TrackInfo Class for MediaPlayer to return each audio/video/subtitle track's metadata. 
MediaRecorder Used to record audio and video. 
MediaRecorder.AudioEncoder Defines the audio encoding. 
MediaRecorder.AudioSource Defines the audio source. 
MediaRecorder.OutputFormat Defines the output format. 
MediaRecorder.VideoEncoder Defines the video encoding. 
MediaRecorder.VideoSource Defines the video source. 
MediaRouter MediaRouter allows applications to control the routing of media channels and streams from the current device to external speakers and destination devices. 
MediaRouter.Callback Interface for receiving events about media routing changes. 
MediaRouter.RouteCategory Definition of a category of routes. 
MediaRouter.RouteGroup Information about a route that consists of multiple other routes in a group. 
MediaRouter.RouteInfo Information about a media route. 
MediaRouter.SimpleCallback Stub implementation of MediaRouter.Callback
MediaRouter.UserRouteInfo Information about a route that the application may define and modify. 
MediaRouter.VolumeCallback Interface for receiving events about volume changes. 
MediaScannerConnection MediaScannerConnection provides a way for applications to pass a newly created or downloaded media file to the media scanner service. 
MediaSync MediaSync class can be used to synchronously playback audio and video streams. 
MediaSync.Callback MediaSync callback interface. 
MediaSyncEvent The MediaSyncEvent class defines events that can be used to synchronize playback or capture actions between different players and recorders. 
MediaTimestamp An immutable object that represents the linear correlation between the media time and the system time. 
PlaybackParams Structure for common playback params. 
Rating A class to encapsulate rating information used as content metadata. 
RemoteControlClient This class was deprecated in API level 21. Use MediaSession instead.  
RemoteControlClient.MetadataEditor This class was deprecated in API level 21. Use MediaMetadata and MediaSession instead.  
RemoteController This class was deprecated in API level 21. Use MediaController instead.  
RemoteController.MetadataEditor A class to read the metadata published by a RemoteControlClient, or send a RemoteControlClient new values for keys that can be edited. 
Ringtone Ringtone provides a quick method for playing a ringtone, notification, or other similar types of sounds. 
RingtoneManager RingtoneManager provides access to ringtones, notification, and other types of sounds. 
SoundPool The SoundPool class manages and plays audio resources for applications. 
SoundPool.Builder Builder class for SoundPool objects. 
SyncParams Structure for common A/V sync params. 
ThumbnailUtils Thumbnail generation routines for media provider. 
TimedMetaData Class that embodies one timed metadata access unit, including
  • a time stamp, and
  • raw uninterpreted byte-array extracted directly from the container. 
TimedText Class to hold the timed text's metadata, including:
  • The characters for rendering
  • The rendering position for the timed text

To render the timed text, applications need to do the following:

 
ToneGenerator This class provides methods to play DTMF tones (ITU-T Recommendation Q.23), call supervisory tones (3GPP TS 22.001, CEPT) and proprietary tones (3GPP TS 31.111). 
VolumeProvider Handles requests to adjust or set the volume on a session. 

Exceptions

DeniedByServerException Exception thrown when the provisioning server or key server denies a certficate or license for a device. 
MediaCodec.CodecException Thrown when an internal codec error occurs. 
MediaCodec.CryptoException Thrown when a crypto error occurs while queueing a secure input buffer. 
MediaCryptoException Exception thrown if MediaCrypto object could not be instantiated or if unable to perform an operation on the MediaCrypto object. 
MediaDrm.MediaDrmStateException Thrown when an unrecoverable failure occurs during a MediaDrm operation. 
MediaDrmException Base class for MediaDrm exceptions  
MediaDrmResetException This exception is thrown when the MediaDrm instance has become unusable due to a restart of the mediaserver process. 
NotProvisionedException Exception thrown when an operation on a MediaDrm object is attempted and the device does not have a certificate. 
ResourceBusyException Exception thrown when an operation on a MediaDrm object is attempted and hardware resources are not available, due to being in use. 
UnsupportedSchemeException Exception thrown when an attempt is made to construct a MediaDrm object using a crypto scheme UUID that is not supported by the device  
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.