一 MediaRecorder状态图
与MediaPlayer类非常相似MediaRecorder也有它自己的状态图。下面是关于MediaRecorder的各个状态的介绍:
Initial:初始状态,当使用new()方法创建一个MediaRecorder对象或者调用了reset()方法时,该MediaRecorder对象处于Initial状态。在设定视频源或者音频源之后将转换为Initialized状态。另外,在除Released状态外的其它状态通过调用reset()方法都可以使MediaRecorder进入该状态。
Initialized:已初始化状态,可以通过在Initial状态调用setAudioSource()或setVideoSource()方法进入该状态。在这个状态可以通过setOutputFormat()方法设置输出格式,此时MediaRecorder转换为DataSourceConfigured状态。另外,通过reset()方法进入Initial状态。
DataSourceConfigured:数据源配置状态,这期间可以设定编码方式、输出文件、屏幕旋转、预览显示等等。可以在Initialized状态通过setOutputFormat()方法进入该状态。另外,可以通过reset()方法回到Initial状态,或者通过prepare()方法到达Prepared状态。
Prepared:就绪状态,在DataSourceConfigured状态通过prepare()方法进入该状态。在这个状态可以通过start()进入录制状态。另外,可以通过reset()方法回到Initialized状态。
Recording:录制状态,可以在Prepared状态通过调用start()方法进入该状态。另外,它可以通过stop()方法或reset()方法回到Initial状态。
Released:释放状态(官方文档给出的词叫做Idle state 空闲状态),可以通过在Initial状态调用release()方法来进入这个状态,这时将会释放所有和MediaRecorder对象绑定的资源。
Error:错误状态,当错误发生的时候进入这个状态,它可以通过reset()方法进入Initial状态。
提示:与MediaPlayer相似使用MediaRecorder录音录像时需要严格遵守状态图说明中的函数调用先后顺序,在不同的状态调用不同的函数,否则会出现异常。
三 方法:
1 构造方法
public MediaRecorder MediaRecorder()
2 常用方法
public final static int getAudioSourceMax()
获取音频源的最大值。
public int getMaxAmplitude()获取在前一次调用此方法之后录音中出现的最大振幅。public void prepare()准备录制。public void release()释放资源。
public void reset()将MediaRecorder设为空闲状态,即Initial状态。
public void setAudioChannels(int numChannels)设置录制的音频通道数。
public void setAudioEncoder(int audio_encoder)设置所录制的声音的编码格式,一般为MediaRecorder.AudioEncoder.AMR_NB。
public void setAudioEncodingBitRate(int bitRate)设置所录制的声音的编码位率。
public void setAudioSamplingRate(int samplingRate)设置所录制的声音的采样率。
public void setAudioSource(int audio_source)设置声音来源,一般传入 MediaRecorder. AudioSource.MIC参数指定录制来自麦克风的声音。
public void setCamera(Camera c)设置一个摄像头用于录制。
public void setCaptureRate(double fps)设置视频帧捕获率。
public void setMaxDuration(int max_duration_ms)设置录制会话的最长持续时间(以ms为单位)。
public void setMaxFileSize(long max_filesize_bytes)设置录制文件的最大文件大小。
public void setOnErrorListener(MediaRecorder.OnErrorListener l)
注册一个用于记录录制时出现的错误的监听器。
public void setOnInfoListener(MediaRecorder.OnInfoListener listener)
注册一个用于记录录制时出现的信息事件。
public void setOrientationHint(int degrees)
设置输出的视频播放的方向提示。
public void setOutputFile(FileDescriptor fd)
设置录制的音频文件的保存位置。
public void setOutputFile(String path)
设置录制的音频文件的保存位置。
public void setOutputFormat(int output_format)
设置所录制的音视频文件的格式,一般为MediaRecorder.OutputFormat.AMR_NB。
public void setVideoEncoder(int video_encoder)
设置所录制视频的编码格式。
public void setVideoSource(int video_source)
设置用于录制的视频来源。
public void start()
开始录制。
public void stop()
停止录制。
public void setVideoSize(int width, int height)
设置要拍摄的宽度和视频的高度。
public void setPreviewDisplay(Surface sv)
设置使用哪个SurfaceView来显示视频预览。
public void setVideoEncodingBitRate(int bitRate)
设置所录制视频的编码位率。
public void setVideoFrameRate(int rate)
设置录制视频的捕获帧速率。
public void setLocation(float latitude, float longitude)
设置并存储在输出文件中的地理数据(经度和纬度)。
public void setProfile(CamcorderProfile profile)
指定CamcorderProfile对象。