Android音视频API(android.media)：概览
提供管理音频和视频中各种媒体接口的类。
媒体API用于播放，在某些情况下，用于记录媒体文件。 这包括音频（例如，播放MP3或其他音乐文件，铃声，游戏声音效果或DTMF音调）和视频（例如，播放通过web或从本地存储器流式传输的视频）。
该包中的其他特殊类提供了检测位图（FaceDetector）中的人脸，控制音频路由（到设备或耳机）并控制诸如铃声和电话振动（AudioManager）之类的警报的能力。
一、接口
AudioManager.OnAudioFocusChangeListener
当更新系统的音频焦点时要调用的回调接口定义。
AudioRecord.OnRecordPositionUpdateListener
当AudioRecord达到setNotificationMarkerPosition（int）设置的通知标记或由setPositionNotificationPeriod（int）设置的记录头的进度定期更新时，将调用回调的接口定义。
AudioRecord.OnRoutingChangedListener
此接口在API级别24中已被弃用，用户应切换到通用AudioRouting.OnRoutingChangedListener类。
AudioRouting
AudioRouting定义了一个用于控制AudioTrack和AudioRecord对象中的路由和路由通知的接口。
AudioRouting.OnRoutingChangedListener
定义应用程序可以接收关联的AudioRouting的路由更改通知接口。
AudioTrack.OnPlaybackPositionUpdateListener
当AudioTrack的播放头位置到达通知标记或已经增加一定时间段时，要调用的回调的接口定义。
AudioTrack.OnRoutingChangedListener
此接口在API级别24中已被弃用，用户应切换到通用AudioRouting.OnRoutingChangedListener类。
ImageReader.OnImageAvailableListener
回调接口被通知新图像可用。
ImageWriter.OnImageReleasedListener
ImageWriter回调接口，用于异步通知各种ImageWriter事件的应用程序。
JetPlayer.OnJetEventListener
当JET引擎生成事件时处理通知。
MediaCas.EventListener
由调用者向setEventListener（MediCas.Event Listener，Handler）注册的接口，以从MediCas实例接收方案特定的通知。
MediaCodec.OnFrameRenderedListener
当输出框在输出表面上呈现时，将被调用的监听器
MediaDrm.OnEventListener
在发生drm事件时调用回调的接口定义
MediaDrm.OnExpirationUpdateListener
在发生drm会话到期更新时调用回调的接口定义
MediaDrm.OnKeyStatusChangeListener
当drm会话中的键更改状态时，将调用回调的接口定义。
MediaPlayer.OnBufferingUpdateListener
要调用的回调的接口定义，指示通过网络流式传输的媒体资源的缓冲状态。
MediaPlayer.OnCompletionListener
在播放媒体源时调用的回调的接口定义已完成。
MediaPlayer.OnDrmConfigHelper
应用程序可以在会话打开之前执行DRM配置（get / set属性）时调用的回调的接口定义。
MediaPlayer.OnDrmInfoListener
当DRM信息可用时要调用的回调的接口定义
MediaPlayer.OnDrmPreparedListener
接口定义回调以在DRM准备好进行密钥请求/响应时通知应用程序
MediaPlayer.OnErrorListener
在异步操作中发生错误时要调用的回调的接口定义（其他错误会在方法调用时抛出异常）。
MediaPlayer.OnInfoListener
要调用的回调的接口定义来传达关于媒体或其播放的一些信息和/或警告。
MediaPlayer.OnPreparedListener
媒体源准备好播放时要调用的回调的接口定义。
MediaPlayer.OnSeekCompleteListener
要调用的回调的接口定义，指示搜索操作的完成。
MediaPlayer.OnTimedMetaDataAvailableListener
当轨道定时元数据可用时，要调用的回调的接口定义。
MediaPlayer.OnTimedTextListener
当定时文本可用于显示时要调用的回调的接口定义。
MediaPlayer.OnVideoSizeChangedListener
在首次知道或更新视频大小时要调用的回调的接口定义
MediaRecorder.OnErrorListener
在录制时发生错误时调用回调的接口定义。
MediaRecorder.OnInfoListener
要调用的回调的接口定义来传达一些信息和/或关于录音的警告。
MediaScannerConnection.MediaScannerConnectionClient
当建立与MediaScanner服务的连接以及文件的扫描完成时，用于通知MediaScannerConnection的客户端的界面。
MediaScannerConnection.OnScanCompletedListener
用于通知客户扫描所请求的媒体文件的结果的接口。
MediaSync.OnErrorListener
在异步操作中发生错误时要调用的回调的接口定义（其他错误会在方法调用时抛出异常）。
RemoteControlClient.OnGetPlaybackPositionListener
查询媒体播放位置时要调用的回调的接口定义。
RemoteControlClient.OnMetadataUpdateListener
当一个元数据值被更新时要调用的回调的接口定义。
RemoteControlClient.OnPlaybackPositionUpdateListener
要求更新媒体播放位置时要调用的回调的接口定义。
RemoteController.OnClientUpdateListener
每当媒体事件，元数据和播放状态可用时，回调的接口定义被调用。
SoundPool.OnLoadCompleteListener
VolumeAutomation
VolumeAutomation定义了一个用于AudioTrack和MediaPlayer对象的自动音量控制的界面。
二、类
AsyncPlayer
播放一系列音频URI，但是在另一个线程上做所有的繁重的工作，所以准备或加载的任何缓慢都不会阻塞调用线程。
AudioAttributes
封装描述有关音频流的信息的属性集合的类。
AudioAttributes.Builder
AudioAttributes对象的Builder类。
AudioDeviceCallback
音频设备回拨定义了应用程序可以接收音频设备连接和断开事件通知的机制。
AudioDeviceInfo
类提供有关音频设备的信息。
AudioFocusRequest
封装有关音频焦点请求的信息的类。
AudioFocusRequest.Builder
AudioFocusRequest对象的Builder类。
AudioFormat
AudioFormat类用于访问多个音频格式和通道配置常量。
AudioFormat.Builder
AudioFormat对象的Builder类。
AudioManager
AudioManager提供对音量和振铃模式控制的访问。
AudioManager.AudioPlaybackCallback
用于接收有关系统上播放活动的更新通知的界面。
AudioManager.AudioRecordingCallback
用于接收关于记录配置的更新通知的界面。
AudioPlaybackConfiguration
AudioPlaybackConfiguration类收集描述音频回放会话的信息。
AudioRecord
AudioRecord类管理用于Java应用程序的音频资源，以从平台的音频输入硬件记录音频。
AudioRecord.Builder
AudioRecord对象的Builder类。
AudioRecordingConfiguration
AudioRecordingConfiguration类收集描述录音会话的信息。
AudioTimestamp
相对于假定的音频流以帧为单位分组位置的结构，以及该帧进入或离开该设备上的音频处理流水线的估计时间。
AudioTrack
AudioTrack类为Java应用程序管理和播放单个音频资源。
AudioTrack.Builder
AudioTrack对象的Builder类。
CamcorderProfile
检索摄像机应用程序的预定摄像机配置文件设置。
CameraProfile
CameraProfile类用于检索在相机应用程序中用于低，中和高质量设置的预定义静止图像捕获（jpeg）质量等级（0-100）。
DrmInitData
封装MediaDrm实例所需的初始化数据。
DrmInitData.SchemeInitData
方案初始化数据。
ExifInterface
这是用于在JPEG文件或RAW图像文件中读写Exif标签的类。
FaceDetector
识别位图图形对象中人物的脸部。
FaceDetector.Face
脸部包含标识位图中脸部位置的所有信息。
Image
与媒体源（如MediaCodec或CameraDevice）一起使用的单个完整映像缓冲区。
Image.Plane
图像数据的单色平面。
ImageReader
ImageReader类允许直接应用程序访问渲染到Surface中的图像数据
几个Android媒体API类接受Surface对象作为渲染目标，包括MediaPlayer，MediaCodec，CameraDevice，ImageWriter和RenderScript分配。
ImageWriter
ImageWriter类允许应用程序将图像数据生成到Surface中，并由CameraDevice等其他组件使用。
JetPlayer
JetPlayer提供对JET内容播放和控制的访问。
MediaActionSound
用于产生与媒体和相机API采取的各种动作产生的声音相匹配的音乐类。
MediaCas
MediaCas可用于与MediaDescrambler一起获取用于解扰受保护媒体流的密钥。
MediaCas.PluginDescriptor
用其CA_system_ID和字符串名称描述CAS插件。
MediaCas.Session
与CA系统打开会话的类。
MediaCodec
MediaCodec类可用于访问低级媒体编解码器，即
MediaCodec.BufferInfo
每个缓冲器元数据包括指定相关联的编解码器（输出）缓冲器中的有效数据的范围的偏移量和大小。
MediaCodec.Callback
MediaCodec回调接口。
MediaCodec.CryptoInfo
描述（至少部分）加密输入样本的结构的元数据。
MediaCodec.CryptoInfo.Pattern
描述子样本中受保护字节的加密模式的元数据。
MediaCodec.MetricsConstants
MediaCodecInfo
提供有关设备上可用的给定媒体编解码器的信息。
MediaCodecInfo.AudioCapabilities
支持查询编解码器音频功能的类。
MediaCodecInfo.CodecCapabilities
封装给定编解码器组件的功能。
MediaCodecInfo.CodecProfileLevel
封装可用于编解码器组件的配置文件。
MediaCodecInfo.EncoderCapabilities
支持查询编解码器的编码功能的类。
MediaCodecInfo.VideoCapabilities
支持查询编解码器的视频功能的类。
MediaCodecList
允许您枚举可用的编解码器，每个指定为MediaCodecInfo对象，找到支持给定格式的编解码器，并查询给定编解码器的功能。
MediaCrypto
MediaCrypto类可以与MediaCodec一起使用，以解码加密的媒体数据。
MediaDataSource
将媒体数据提供给框架。
MediaDescrambler
MediaDescrambler类可以与MediaCodec和MediaExtractor结合使用，以对通过ISO / IEC13818-1中的条件访问（CA）系统加扰的媒体数据进行解码。
MediaDescription
用于适合显示的媒体项目的简单的元数据集。
MediaDescription.Builder
MediaDescription对象的构建器。
MediaDrm
MediaDrm可以与MediaCrypto结合使用来获取解密受保护媒体流的密钥。
MediaDrm.CryptoSession
除了支持DASH通用加密介质的解密外，MediaDrm API提供了根据工厂安装的信任根安全地将会话密钥从运营商的会话密钥服务器传递到客户端设备的能力，然后执行加密，解密， 使用会话密钥对任意用户数据进行签名和验证操作。
MediaDrm.KeyRequest
包含应用程序用于从许可证服务器请求密钥的不透明数据
MediaDrm.KeyStatus
定义键的状态。
MediaDrm.ProvisionRequest
包含应用程序从配置服务器请求证书的不透明数据
MediaExtractor
MediaExtractor有助于从数据源中提取解复用的，通常编码的媒体数据。
MediaExtractor.CasInfo
描述用于争夺轨道的条件访问系统。
MediaExtractor.MetricsConstants
MediaFormat
封装描述媒体数据格式的信息，无论是音频还是视频。
MediaMetadata
包含有关项目的元数据，如标题，艺术家等。
MediaMetadata.Builder
用于构建MediaMetadata对象。
MediaMetadataEditor
该类在API级别21中已被弃用。请使用MediaMetadata与MediaSession一起使用。
MediaMetadataRetriever
MediaMetadataRetriever类提供了一个统一的接口，用于从输入媒体文件中检索帧和元数据。
MediaMuxer
MediaMuxer便于多路复用基本流。
MediaMuxer.OutputFormat
定义输出格式。
MediaPlayer
MediaPlayer类可用于控制音频/视频文件和流的播放。
MediaPlayer.DrmInfo
封装源的DRM属性。
MediaPlayer.MetricsConstants
MediaPlayer.TrackInfo
媒体播放器的类返回每个音频/视频/字幕轨道元数据。
MediaRecorder
用于录制音频和视频。
MediaRecorder.AudioEncoder
定义音频编码。
MediaRecorder.AudioSource
定义音频源。
MediaRecorder.MetricsConstants
MediaRecorder.OutputFormat
定义输出格式。
MediaRecorder.VideoEncoder
定义视频编码。
MediaRecorder.VideoSource
定义视频源。
MediaRouter
MediaRouter允许应用程序控制从当前设备到外部扬声器和目标设备的媒体通道和流的路由。
MediaRouter.Callback
用于接收关于媒体路由更改的事件的接口。
MediaRouter.RouteCategory
定义一类路由。
MediaRouter.RouteGroup
关于由组中的多个其他路由组成的路由的信息。
MediaRouter.RouteInfo
有关媒体路由的信息。
MediaRouter.SimpleCallback
Stub实现MediaRouter.Callback。
MediaRouter.UserRouteInfo
有关应用程序可能定义和修改的路由的信息。
MediaRouter.VolumeCallback
用于接收有关卷更改的事件的界面。
MediaScannerConnection
MediaScannerConnection提供了一种应用程序将新创建或下载的媒体文件传递到媒体扫描器服务的方法。
MediaSync
MediaSync类可用于同步播放音频和视频流。
MediaSync.Callback
MediaSync回调接口。
MediaSyncEvent
MediaSyncEvent类定义可用于同步播放或捕获不同播放器和录像机之间的动作的事件。
MediaTimestamp
表示媒体时间与系统时间之间的线性相关性的不可变对象。
PlaybackParams
普通播放参数的结构。
Rating
封装用作内容元数据的评分信息的类。
RemoteControlClient
该类在API级别21中已被弃用。请改用MediaSession。
RemoteControlClient.MetadataEditor
此类已在API级别21中弃用。请改用MediaMetadata和MediaSession。
RemoteController
此类在API级别21中已被弃用。请改用MediaController。
RemoteController.MetadataEditor
用于读取RemoteControlClient发布的元数据的类，或者为可编辑的密钥发送一个RemoteControlClient新值。
Ringtone
Ringtone提供了一种播放铃声，通知或其他类似类型声音的快速方法。
RingtoneManager
RingtoneManager提供对铃声，通知和其他类型声音的访问。
SoundPool
SoundPool类管理和播放应用程序的音频资源。
SoundPool.Builder
SoundPool对象的Builder类。
SyncParams
公共A / V同步参数的结构。
ThumbnailUtils
媒体提供商的缩略图生成例程。
TimedMetaData
包含一个定时元数据访问单元的类
1、时间戳，和
2、从容器直接提取原始的未解释的字节数组。
TimedText
持有时间文本元数据的类，包括：
1、渲染的角色
2、定时文本的渲染位置
为了呈现定时文本，应用程序需要执行以下操作：
1、实现MediaPlayer.OnTimedTextListener接口
2、在用于播放的MediaPlayer对象上注册MediaPlayer.OnTimedTextListener回调
3、收到onTimedText回调时，请执行以下操作：
1）、调用getText（）获取渲染的字符
2）、调用getBounds（）来获取文本渲染区域/区域
ToneGenerator
该类提供播放DTMF音调（ITU-T建议Q.23），呼叫监督音调（3GPP TS 22.001，CEPT）和专有音调（3GPP TS 31.111）的方法。
VolumeProvider
处理请求以调整或设置会话上的卷。
VolumeShaper
VolumeShaper类用于在媒体播放期间自动控制音频音量，允许简单实现过渡效果和躲避。
VolumeShaper.Configuration
VolumeShaper.Configuration类包含曲线和持续时间信息。
VolumeShaper.Configuration.Builder
一个VolumeShaper.Configuration对象的Builder类。
VolumeShaper.Operation
VolumeShaper.Operation类用于指定影响卷更改的VolumeShaper的操作。
三、Exceptions
DeniedByServerException
配置服务器或密钥服务器拒绝设备的证书或许可证时抛出异常。
MediaCasException
MediaCas异常的基类
MediaCasException.DeniedByServerException
配置服务器或密钥服务器拒绝设备的许可证时抛出异常。
MediaCasException.NotProvisionedException
在成功配置MediaCas对象之前尝试进行操作时抛出异常。
MediaCasException.ResourceBusyException
尝试对MediaCas对象进行操作并且由于使用硬件资源不可用而抛出异常。
MediaCasException.UnsupportedCasException
尝试使用设备不支持的CA_system_id构建MediaCas对象时抛出异常
MediaCasStateException
MediaCas运行时异常的基类
MediaCodec.CodecException
内部编解码器错误发生时抛出。
MediaCodec.CryptoException
在排队安全输入缓冲区时发生加密错误时抛出。
MediaCryptoException
如果MediaCrypto对象无法实例化，或者无法对MediaCrypto对象执行操作，则抛出异常。
MediaDrm.MediaDrmStateException
在MediaDrm操作期间发生不可恢复的故障时抛出
MediaDrmException
MediaDrm异常的基类
MediaDrmResetException
当MediaDrm实例由于重新启动mediaserver进程而变得不可用时，抛出此异常。
MediaPlayer.NoDrmSchemeException
在通过prepareDrm（）准备DRM方案之前调用DRM方法时抛出。
MediaPlayer.ProvisioningNetworkErrorException
当设备需要DRM配置时，由于网络错误（Internet可达性，超时等）而导致配置尝试失败）时抛出。
MediaPlayer.ProvisioningServerErrorException
当设备需要DRM配置时引发，但由于配置服务器拒绝该请求，配置尝试失败。
NotProvisionedException
尝试在MediaDrm对象上进行操作并且设备没有证书时抛出异常。
ResourceBusyException
尝试使用MediaDrm对象的操作并且由于使用硬件资源不可用时抛出异常。
UnsupportedSchemeException
使用设备不支持的加密方案UUID尝试构建MediaDrm对象时抛出的异常