org.zoolu.sound

Class SimpleAudioSystem

java.lang.Object

org.zoolu.sound.SimpleAudioSystem

Direct Known Subclasses:

ConverterAudioSystem

public class SimpleAudioSystem
extends java.lang.Object

SimpleAudioSystem is a static class that allows the access to system audio input and output in pure-java style using the javax.sound.sampled library (package).

SimpleAudioSystem has the following main methods:

• initAudioInputLine(float, int) - to initialize the audio input line
• startAudioInputLine() - to start capturing audio
• getInputStream(AudioFormat) - to get the audio input stream
• stopAudioInputLine() - to stop capturing audio
• initAudioOutputLine(float, int) - to initialize the audio output line
• startAudioOutputLine() - to start playing audio out
• getOutputStream(AudioFormat) - to get the audio output stream
• stopAudioOutputLine() - to stop playing audio out

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG Whether printing debugging information on standard error output.
static javax.sound.sampled.AudioFormat	DEFAULT_AUDIO_FORMAT Default audio format
static int	INTERNAL_BUFFER_SIZE Internal buffer size

Constructor Summary

Constructors

Constructor and Description
SimpleAudioSystem()

Method Summary

Modifier and Type	Method and Description
static void	closeAudioInputLine() Closes the static system audio input line
static void	closeAudioOutputLine() Closes the static system audio output line.
static javax.sound.sampled.AudioFormat	getAudioFormat(CodecType codec, float sample_rate) Gets the audio format corresponding to a given codec.
static javax.sound.sampled.AudioFormat	getBaseAudioFormat(float sample_rate, int channels) Gets the base audio format.
static javax.sound.sampled.AudioFormat	getBaseTranscodedAudioFormat(float sample_rate, int channels, javax.sound.sampled.AudioFormat.Encoding encoding) Gets the base transcoded audio format.
static javax.sound.sampled.AudioInputStream	getInputStream() Gets a new system audio input stream.
static javax.sound.sampled.AudioInputStream	getInputStream(javax.sound.sampled.AudioFormat format) Gets a new system audio input stream.
static javax.sound.sampled.AudioInputStream	getInputStream(float sample_rate, int channels, javax.sound.sampled.AudioFormat.Encoding encoding) Gets a new system audio input stream.
static AudioOutputStream	getOutputStream() Gets a new system audio output stream.
static AudioOutputStream	getOutputStream(javax.sound.sampled.AudioFormat format) Gets a new system audio output stream.
static AudioOutputStream	getOutputStream(float sample_rate, int channels, javax.sound.sampled.AudioFormat.Encoding encoding) Gets a new system audio output stream.
static void	initAudioInputLine(float sample_rate, int channels) Initializes the static system audio input line.
static void	initAudioOutputLine(float sample_rate, int channels) Initializes the static system audio output line.
static void	startAudioInputLine() Starts capturing system audio.
static void	startAudioOutputLine() Starts playing system audio.
static void	stopAudioInputLine() Stops capturing system audio.
static void	stopAudioOutputLine() Stops playing system audio.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static boolean DEBUG

Whether printing debugging information on standard error output.

INTERNAL_BUFFER_SIZE

public static final int INTERNAL_BUFFER_SIZE

Internal buffer size

See Also:

Constant Field Values

DEFAULT_AUDIO_FORMAT

public static final javax.sound.sampled.AudioFormat DEFAULT_AUDIO_FORMAT

Default audio format

Constructor Detail

SimpleAudioSystem

public SimpleAudioSystem()

Method Detail

initAudioInputLine

public static void initAudioInputLine(float sample_rate,
                                      int channels)

Initializes the static system audio input line. This method creates a the input line (TargetDataLine) with a base audio format.

Parameters:

sample_rate - sample rate

channels - number of audio channels (1 for mono, 2 for stereo)

closeAudioInputLine

public static void closeAudioInputLine()

Closes the static system audio input line

initAudioOutputLine

public static void initAudioOutputLine(float sample_rate,
                                       int channels)

Initializes the static system audio output line. This method creates a the output line (SourceDataLine) with a base audio format.

Parameters:

sample_rate - sample rate

channels - number of audio channels (1 for mono, 2 for stereo)

closeAudioOutputLine

public static void closeAudioOutputLine()

Closes the static system audio output line.

startAudioInputLine

public static void startAudioInputLine()

Starts capturing system audio.

stopAudioInputLine

public static void stopAudioInputLine()

Stops capturing system audio.

startAudioOutputLine

public static void startAudioOutputLine()

Starts playing system audio.

stopAudioOutputLine

public static void stopAudioOutputLine()

Stops playing system audio.

getBaseAudioFormat

public static javax.sound.sampled.AudioFormat getBaseAudioFormat(float sample_rate,
                                                                 int channels)

Gets the base audio format. This is the format used for opening the system input and output lines.

The format is PCM LINEAR SIGNED, 16-bit samples, 2-byte frames, mono, with the given sample rate.

Parameters:

sample_rate - sample rate

channels - number of audio channels (1 for mono, 2 for stereo)

getBaseTranscodedAudioFormat

public static javax.sound.sampled.AudioFormat getBaseTranscodedAudioFormat(float sample_rate,
                                                                           int channels,
                                                                           javax.sound.sampled.AudioFormat.Encoding encoding)

Gets the base transcoded audio format. It differs from the base audio format just over the encoding type.

Parameters:

sample_rate - sample rate

channels - number of audio channels (1 for mono, 2 for stereo)

encoding - the encoding type

getInputStream

public static javax.sound.sampled.AudioInputStream getInputStream()

Gets a new system audio input stream. The audio format is DEFAULT_AUDIO_FORMAT.

getInputStream

public static javax.sound.sampled.AudioInputStream getInputStream(float sample_rate,
                                                                  int channels,
                                                                  javax.sound.sampled.AudioFormat.Encoding encoding)

Gets a new system audio input stream.

Parameters:

sample_rate - audio sample rate

channels - number of audio channels (1 for mono, 2 for stereo)

encoding - audio encoding type

getInputStream

public static javax.sound.sampled.AudioInputStream getInputStream(javax.sound.sampled.AudioFormat format)

Gets a new system audio input stream.

Parameters:

format - audio format

getOutputStream

public static AudioOutputStream getOutputStream()

Gets a new system audio output stream. The audio format is DEFAULT_AUDIO_FORMAT.

getOutputStream

public static AudioOutputStream getOutputStream(float sample_rate,
                                                int channels,
                                                javax.sound.sampled.AudioFormat.Encoding encoding)

Gets a new system audio output stream.

Parameters:

sample_rate - audio sample rate

channels - number of audio channels (1 for mono, 2 for stereo)

encoding - audio encoding type

getOutputStream

public static AudioOutputStream getOutputStream(javax.sound.sampled.AudioFormat format)

Gets a new system audio output stream.

Parameters:

format - audio format

getAudioFormat

public static javax.sound.sampled.AudioFormat getAudioFormat(CodecType codec,
                                                             float sample_rate)

Gets the audio format corresponding to a given codec.

Parameters:

codec - the codec

sample_rate - sample rate