com.codename1.media

Class MediaRecorderBuilder

java.lang.Object

com.codename1.media.MediaRecorderBuilder

public class MediaRecorderBuilder
extends Object

A builder class to generate a Media recorder with specific settings.

Since:

7.0

Author:

shannah

Constructor Summary

Constructors

Constructor and Description
MediaRecorderBuilder()

Method Summary

Modifier and Type	Method and Description
MediaRecorderBuilder	audioChannels(int numChannels) Set the number of audio channels in the media recorder.
MediaRecorderBuilder	bitRate(int bitRate) Sets the bit rate for the recorder.
Media	build() Builds the MediaRecorder with the given settings.
int	getAudioChannels() Gets the current audio channels settings.
int	getBitRate() Gets the current bit rate.
String	getMimeType() Gets the current mimetype.
String	getPath() Gets the current output path.
int	getSamplingRate() Gets the current sampling rate.
boolean	isRedirectToAudioBuffer() True if the media recorder should redirect output to an audio buffer instead of a file.
MediaRecorderBuilder	mimeType(String mimeType) Sets the mimetype to use for encoding the audio file.
MediaRecorderBuilder	path(String path) Sets the output path where the audio recording should be saved.
MediaRecorderBuilder	redirectToAudioBuffer(boolean redirect) Set this flag to true to redirect the microphone input to an audio buffer.
MediaRecorderBuilder	samplingRate(int samplingRate) Sets the sampling rate for the recorder.

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaRecorderBuilder

public MediaRecorderBuilder()

Method Detail

audioChannels

public MediaRecorderBuilder audioChannels(int numChannels)

Set the number of audio channels in the media recorder. Default 1.

Parameters:

numChannels - The number of audio channels in the media recorder.

Returns:

Self for chaining

bitRate

public MediaRecorderBuilder bitRate(int bitRate)

Sets the bit rate for the recorder. Default 64000.

Parameters:

bitRate - The bit rate for the recorder.

Returns:

Self for chaining.

samplingRate

public MediaRecorderBuilder samplingRate(int samplingRate)

Sets the sampling rate for the recorder. Default 44100

Parameters:

samplingRate - The sample rate for the recorder.

Returns:

Self for chaining.

mimeType

public MediaRecorderBuilder mimeType(String mimeType)

Sets the mimetype to use for encoding the audio file.

Parameters:

mimeType - The mimetype to use for encoding the audio file.

Returns:

Self for chaining.

See Also:

MediaManager.getAvailableRecordingMimeTypes()

path

public MediaRecorderBuilder path(String path)

Sets the output path where the audio recording should be saved.

Parameters:

path - The output path where the recording should be saved as a FileSystemStorage path

Returns:

Self for chaining.

redirectToAudioBuffer

public MediaRecorderBuilder redirectToAudioBuffer(boolean redirect)

Set this flag to true to redirect the microphone input to an audio buffer. This is handy if you just want to capture the raw PCM data from the microphone.

Parameters:

redirect - True to redirect output to an audio buffer. The path(java.lang.String) parameter would then be used as the path to the audio buffer instead of the output file.

Returns:

Self for chaining.

build

public Media build()
            throws IOException

Builds the MediaRecorder with the given settings.

Returns:

Throws:

IOException

IllegalStateException - If path(java.lang.String) is not set.

getAudioChannels

public int getAudioChannels()

Gets the current audio channels settings.

Returns:

the audioChannels

getBitRate

public int getBitRate()

Gets the current bit rate.

Returns:

the bitRate

getSamplingRate

public int getSamplingRate()

Gets the current sampling rate.

Returns:

the samplingRate

getMimeType

public String getMimeType()

Gets the current mimetype.

Returns:

the mimeType

getPath

public String getPath()

Gets the current output path.

Returns:

the path

isRedirectToAudioBuffer

public boolean isRedirectToAudioBuffer()

True if the media recorder should redirect output to an audio buffer instead of a file.

Returns: