org.joshvm.media

Class AudioRecorder

java.lang.Object

org.joshvm.media.AudioRecorder

public class AudioRecorder
extends Object

AudioRecorder is used to record audio from the audio input hardware of the platform.

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
AudioRecorder() Creates an AudioRecorder. Call release() to release native resources after using the recorder.

Method Summary

Methods

Modifier and Type	Method and Description
int	getRecordingState() Returns the recording state.
int	read(byte[] audioData, int offset, int size) Reads up to size bytes of audio data from the audio hardware for recording into a buffer, blocks until at least one byte is read or no more data because recorder has been stopped.
void	release() Releases the native resources.
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	startRecording() Start recording
void	stop() Stop 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

AudioRecorder

public AudioRecorder()
              throws IOException

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

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

getRecordingState

public int getRecordingState()

Returns the recording state.

See Also:

RECORDSTATE_STOPPED, RECORDSTATE_RECORDING

read

public int read(byte[] audioData,
       int offset,
       int size)
         throws IOException

Reads up to size bytes of audio data from the audio hardware for recording into a buffer, blocks until at least one byte is read or no more data because recorder has been stopped.

Parameters:

audioData - the array to which the recorded audio data is written.

offset - the start offset in array audioData at which the data is written

size - the maximum number of bytes to read

Returns:

the total number of bytes read into the buffer, or -1 for end

Throws:

IOException - if an I/O error occurs

startRecording

public void startRecording()
                    throws IOException

Start recording

Throws:

IOException - if an I/O error occurs

stop

public void stop()
          throws IOException

Stop recording

Throws:

IOException - if an I/O error occurs

release

public void release()
             throws IOException

Releases the native resources. The object can no longer be used and the reference should be set to null after a call to release().

Throws:

IOException - if an I/O error occurs