AutoCloseable
, Line
public interface Mixer extends Line
SourceDataLine
, and the latter, TargetDataLine
. Port
objects, too, are either source lines or target lines. A mixer can accept prerecorded, loopable sound as input, by having some of its source lines be instances of objects that implement the Clip
interface. Through methods of the Line
interface, which Mixer
extends, a mixer might provide a set of controls that are global to the mixer. For example, the mixer can have a master gain control. These global controls are distinct from the controls belonging to each of the mixer's individual lines.
Some mixers, especially those with internal digital mixing capabilities, may provide additional capabilities by implementing the DataLine
interface.
A mixer can support synchronization of its lines. When one line in a synchronized group is started or stopped, the other lines in the group automatically start or stop simultaneously with the explicitly affected one.
Modifier and Type | Interface | Description |
---|---|---|
static class |
Mixer.Info |
The Mixer.Info class represents information about an audio mixer, including the product's name, version, and vendor, along with a textual description. |
Modifier and Type | Method | Description |
---|---|---|
Line |
getLine |
Obtains a line that is available for use and that matches the description in the specified Line.Info object. |
int |
getMaxLines |
Obtains the approximate maximum number of lines of the requested type that can be open simultaneously on the mixer. |
Mixer.Info |
getMixerInfo() |
Obtains information about this mixer, including the product's name, version, vendor, etc. |
Line.Info[] |
getSourceLineInfo() |
Obtains information about the set of source lines supported by this mixer. |
Line.Info[] |
getSourceLineInfo |
Obtains information about source lines of a particular type supported by the mixer. |
Line[] |
getSourceLines() |
Obtains the set of all source lines currently open to this mixer. |
Line.Info[] |
getTargetLineInfo() |
Obtains information about the set of target lines supported by this mixer. |
Line.Info[] |
getTargetLineInfo |
Obtains information about target lines of a particular type supported by the mixer. |
Line[] |
getTargetLines() |
Obtains the set of all target lines currently open from this mixer. |
boolean |
isLineSupported |
Indicates whether the mixer supports a line (or lines) that match the specified Line.Info object. |
boolean |
isSynchronizationSupported |
Reports whether this mixer supports synchronization of the specified set of lines. |
void |
synchronize |
Synchronizes two or more lines. |
void |
unsynchronize |
Releases synchronization for the specified lines. |
addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener
Mixer.Info getMixerInfo()
Line.Info[] getSourceLineInfo()
Line.Info
objects representing source lines for this mixer. If no source lines are supported, an array of length 0 is returned.Line.Info[] getTargetLineInfo()
Line.Info
objects representing target lines for this mixer. If no target lines are supported, an array of length 0 is returned.Line.Info[] getSourceLineInfo(Line.Info info)
info
- a Line.Info
object describing lines about which information is queriedLine.Info
objects describing source lines matching the type requested. If no matching source lines are supported, an array of length 0 is returned.Line.Info[] getTargetLineInfo(Line.Info info)
info
- a Line.Info
object describing lines about which information is queriedLine.Info
objects describing target lines matching the type requested. If no matching target lines are supported, an array of length 0 is returned.boolean isLineSupported(Line.Info info)
Line.Info
object. Some lines may only be supported when this mixer is open.info
- describes the line for which support is queriedtrue
if at least one matching line is supported, false
otherwiseLine getLine(Line.Info info) throws LineUnavailableException
Line.Info
object. If a DataLine
is requested, and info
is an instance of DataLine.Info
specifying at least one fully qualified audio format, the last one will be used as the default format of the returned DataLine
.
info
- describes the desired lineLine.Info
objectLineUnavailableException
- if a matching line is not available due to resource restrictionsIllegalArgumentException
- if this mixer does not support any lines matching the descriptionSecurityException
- if a matching line is not available due to security restrictionsint getMaxLines(Line.Info info)
Certain types of mixers do not have a hard bound and may allow opening more lines. Since certain lines are a shared resource, a mixer may not be able to open the maximum number of lines if another process has opened lines of this mixer.
The requested type is any line that matches the description in the provided Line.Info
object. For example, if the info object represents a speaker port, and the mixer supports exactly one speaker port, this method should return 1. If the info object represents a source data line and the mixer supports the use of 32 source data lines simultaneously, the return value should be 32. If there is no limit, this function returns AudioSystem.NOT_SPECIFIED
.
info
- a Line.Info
that describes the line for which the number of supported instances is queriedAudioSystem.NOT_SPECIFIED
Line[] getSourceLines()
SecurityException
- if the matching lines are not available due to security restrictionsLine[] getTargetLines()
SecurityException
- if the matching lines are not available due to security restrictionsvoid synchronize(Line[] lines, boolean maintainSync)
lines
- the lines that should be synchronizedmaintainSync
- true
if the synchronization must be precisely maintained (i.e., the synchronization must be sample-accurate) at all times during operation of the lines, or false
if precise synchronization is required only during start and stop operationsIllegalArgumentException
- if the lines cannot be synchronized. This may occur if the lines are of different types or have different formats for which this mixer does not support synchronization, or if all lines specified do not belong to this mixer.void unsynchronize(Line[] lines)
null
may be specified, in which case all currently synchronized lines that belong to this mixer are unsynchronized.lines
- the synchronized lines for which synchronization should be released, or null
for all this mixer's synchronized linesIllegalArgumentException
- if the lines cannot be unsynchronized. This may occur if the argument specified does not exactly match a set of lines for which synchronization has already been established.boolean isSynchronizationSupported(Line[] lines, boolean maintainSync)
lines
- the set of lines for which synchronization support is queriedmaintainSync
- true
if the synchronization must be precisely maintained (i.e., the synchronization must be sample-accurate) at all times during operation of the lines, or false
if precise synchronization is required only during start and stop operationstrue
if the lines can be synchronized, false
otherwise
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/sound/sampled/Mixer.html