org.joshvm.media

Class MediaRecorder

java.lang.Object

org.joshvm.media.MediaRecorder

public class MediaRecorder
extends Object

MediaRecorder is used to record audio.

Field Summary

Fields

Modifier and Type	Field and Description
static int	RECORDSTATE_RECORDING The state indicating that the recorder is recording
static int	RECORDSTATE_STOPPED The state indicating that the recorder is not recording

Constructor Summary

Constructors

Constructor and Description
MediaRecorder() Creates an MediaRecorder. Call release() to release native resources after using the MediaRecorder.

Method Summary

Methods

Modifier and Type	Method and Description
int	getRecordingState() Returns the recording state.
void	prepare() Prepares the recorder to begin capturing and encoding data, synchronously.
void	release() Releases the native MediaRecorder resources.
void	reset() Set the MediaRecorder to its idle state.
void	setAudioBitRate(int audioBitRate) Set bit rate.
void	setAudioSampleRate(int sampleRateInHz) Set audio sample rate in Hertz.
void	setChannelConfig(int channelConfig) Set the configuration of the audio channels.
void	setOutputFile(String outputFilePath) Sets the path of the output file to be produced.
void	setOutputFormat(int outFormat) Sets the format of the output file produced during recording.
void	start() Begins capturing and encoding data to the file specified with setOutputFile().
void	stop() Stops recording.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RECORDSTATE_STOPPED

public static final int RECORDSTATE_STOPPED

The state indicating that the recorder is not recording

See Also:

Constant Field Values

RECORDSTATE_RECORDING

public static final int RECORDSTATE_RECORDING

The state indicating that the recorder is recording

See Also:

Constant Field Values

Constructor Detail

MediaRecorder

public MediaRecorder()
              throws IOException

Creates an MediaRecorder.
Call release() to release native resources after using the MediaRecorder.

Throws:

IOException - if failed to create recorder

Method Detail

setAudioSampleRate

public void setAudioSampleRate(int sampleRateInHz)
                        throws IllegalArgumentException

Set audio sample rate in Hertz.

Parameters:

sampleRateInHz - sample rate. Normally use 8000, 16000, 22050, 44100, 48000. Default is 16000.

Throws:

IllegalArgumentException

setChannelConfig

public void setChannelConfig(int channelConfig)
                      throws IllegalArgumentException

Set the configuration of the audio channels.

Parameters:

channelConfig - audio channel configuration. See AudioFormat.CHANNEL_MONO and AudioFormat.CHANNEL_STEREO. Default is CHANNEL_MONO

Throws:

IllegalArgumentException

setAudioBitRate

public void setAudioBitRate(int audioBitRate)
                     throws IllegalArgumentException

Set bit rate.

Parameters:

audioBitRate - bit per sample. Normally use 8, 16. Default is 16

Throws:

IllegalArgumentException

setOutputFile

public void setOutputFile(String outputFilePath)
                   throws IOException

Sets the path of the output file to be produced. Call this after setOutputFormat() but before prepare().
Root path can be got from Environment.getRootDirectory() or Environment.getExternalStorageDirectory().
Output file can be accessed by FileConnection interface.

Parameters:

outputFilePath - the pathname to use.

Throws:

IOException

setOutputFormat

public void setOutputFormat(int outFormat)
                     throws IllegalArgumentException

Sets the format of the output file produced during recording.

Parameters:

outFormat - the output format to use. See MediaFormat.FORMAT_WAV, MediaFormat.FORMAT_AMR_NB and MediaFormat.FORMAT_AMR_WB

Throws:

IllegalArgumentException

getRecordingState

public int getRecordingState()

Returns the recording state.

See Also:

RECORDSTATE_STOPPED, RECORDSTATE_RECORDING

prepare

public void prepare()
             throws IOException

Prepares the recorder to begin capturing and encoding data, synchronously.

Throws:

IOException - if prepare fails

start

public void start()
           throws IOException

Begins capturing and encoding data to the file specified with setOutputFile().

Throws:

IOException - if start fails

stop

public void stop()
          throws IOException

Stops recording. Once recording is stopped, you will have to configure it again as if it has just been constructed.

Throws:

IOException

reset

public void reset()
           throws IOException

Set the MediaRecorder to its idle state. After calling this method, you will have to configure it again as if it had just been constructed.

Throws:

IOException

release

public void release()
             throws IOException

Releases the native MediaRecorder resources. The object can no longer be used.

Throws:

IOException