javax.sound.sampled

Interface Mixer

All Superinterfaces:

AutoCloseable， Line

public interface Mixer
extends Line

混频器是一个具有一个或多个行的音频设备。它不需要被设计用于混合音频信号。实际混合音频的混合机有多个输入（源）线和至少一个输出（目标）线。前者往往是实现 SourceDataLine类的实例，而后者， TargetDataLine。 Port对象，也可以是线源或目标线。混频器可以接受loopable声音录制的，作为输入，通过它的一些源线是实现 Clip接口对象的实例。

通过对Line接口的方法，这Mixer延伸，混频器可能提供一套是全局的混音控制。例如，混频器可以有一个主增益控制。这些全局控制是不同的，属于每一个混频器的各个线的控制。

一些搅拌机，特别是那些与内部数字混音功能，可以通过实施DataLine接口提供额外的功能。

一个混频器可以支持其线的同步。当一个同步组中的一行启动或停止时，组中的其他行会自动启动或停止，同时显式地影响一个行。

从以下版本开始：

一点三

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Mixer.Info 的 Mixer.Info类代表关于音频混合器的信息，包括产品名称、版本和供应商，随着文字描述。

方法摘要

Modifier and Type	Method and Description
Line	getLine(Line.Info info) 得到一个线，可供使用和匹配的描述在指定的 Line.Info对象。
int	getMaxLines(Line.Info info) 获取可以在密炼机上同时打开的所请求类型的行的近似最大值数。
Mixer.Info	getMixerInfo() 获取有关此混频器的信息，包括产品的名称、版本、供应商等。
Line.Info[]	getSourceLineInfo() 获取由该混频器支持的源行集的信息。
Line.Info[]	getSourceLineInfo(Line.Info info) 获取由密炼机所支持的特定类型的源行的信息。
Line[]	getSourceLines() 获取当前对该混频器打开的所有源行集的集合。
Line.Info[]	getTargetLineInfo() 获取由该混频器支持的目标行集的信息。
Line.Info[]	getTargetLineInfo(Line.Info info) 获取由密炼机所支持的特定类型的目标行的信息。
Line[]	getTargetLines() 获取当前从该混频器打开的所有目标行集的集合。
boolean	isLineSupported(Line.Info info) 指示混频器支持线（或线），指定的 Line.Info对象匹配。
boolean	isSynchronizationSupported(Line[] lines, boolean maintainSync) 报告此密炼机是否支持指定的行集的同步。
void	synchronize(Line[] lines, boolean maintainSync) 将两个或两个以上的线。
void	unsynchronize(Line[] lines) 释放指定行的同步。

Methods inherited from interface javax.sound.sampled.Line

addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener

方法详细信息

getMixerInfo

Mixer.Info getMixerInfo()

获取有关此混频器的信息，包括产品的名称、版本、供应商等。

结果

描述此密炼机的密炼机信息对象

另请参见：

Mixer.Info

getSourceLineInfo

Line.Info[] getSourceLineInfo()

获取由该混频器支持的源行集的信息。一些源线可能只有当这个混频器是开放的。

结果

代表本机电源线 Line.Info对象数组。如果没有支持源行，则返回一个长度为0的数组。

getTargetLineInfo

Line.Info[] getTargetLineInfo()

获取由该混频器支持的目标行集的信息。一些目标线可能只有当这个混频器是开放的。

结果

表示此机目标线 Line.Info对象数组。如果没有支持目标线，则返回一个长度为0的数组。

getSourceLineInfo

Line.Info[] getSourceLineInfo(Line.Info info)

获取由密炼机所支持的特定类型的源行的信息。一些源线可能只有当这个混频器是开放的。

参数

info - Line.Info对象描述线路信息查询

结果

Line.Info对象的描述源线匹配的数组，要求。如果没有匹配的源代码行，则返回一个长度为0的数组。

getTargetLineInfo

Line.Info[] getTargetLineInfo(Line.Info info)

获取由密炼机所支持的特定类型的目标行的信息。一些目标线可能只有当这个混频器是开放的。

参数

info - Line.Info对象描述线路信息查询

结果

Line.Info对象描述的目标线匹配的数组，要求。如果没有匹配的目标线，则返回一个长度为0的数组。

isLineSupported

boolean isLineSupported(Line.Info info)

指示混频器支持线（或线），指定的 Line.Info对象匹配。当该混频器打开时，可能只支持某些行。

参数

info -介绍线支持的查询

结果

true如果至少有一个匹配的在线支持， false否则

getLine

Line getLine(Line.Info info)
      throws LineUnavailableException

得到一个线，可供使用和匹配的描述在指定的 Line.Info对象。

如果请求DataLine，和info是DataLine.Info指定至少一个完全合格的音频格式的一个实例，最后一个将被用来作为返回的DataLine默认格式。

参数

info -描述所需的行

结果

一条线是可用的，符合描述在指定的 Line.Info对象

异常

LineUnavailableException -如果一个匹配行不可因资源限制

IllegalArgumentException如果本机不支持任何线匹配的描述

SecurityException -如果一个匹配行不可由于安全限制

getMaxLines

int getMaxLines(Line.Info info)

获取可以在密炼机上同时打开的所请求类型的行的近似最大值数。某些类型的混频器没有一个硬约束，并可能允许开放更多的线。由于某些行是一个共享资源，如果另一个进程打开该混频器的行，则一个混频器可能无法打开最大行数。请求的类型相匹配的描述所提供的 Line.Info对象的任何线。例如，如果信息对象表示一个扬声器端口，而密炼机只支持一个扬声器端口，这种方法应该返回1。如果信息对象代表一个源数据线和混频器支持同时使用32个源数据线，返回值应该为32。如果没有限制，这个函数返回 AudioSystem.NOT_SPECIFIED。

参数

info - Line.Info描述线所支持的实例数量查询

结果

直线匹配支持的最大数目，或 AudioSystem.NOT_SPECIFIED

getSourceLines

Line[] getSourceLines()

获取当前对该混频器打开的所有源行集的集合。

结果

当前打开到混频器的源行。如果没有源行目前对这个密炼机打开，则返回一个长度为0的数组。

异常

SecurityException -如果匹配的线是不是由于安全限制

getTargetLines

Line[] getTargetLines()

获取当前从该混频器打开的所有目标行集的集合。

结果

从混频器当前打开的目标线。如果没有目标线是从这个调音台打开的，则返回一个长度为0的数组。

异常

SecurityException -如果匹配的线是不是由于安全限制

synchronize

void synchronize(Line[] lines,
                 boolean maintainSync)

将两个或两个以上的线。任何启动或停止音频播放或捕获的后续命令都会在组中的其他线路上产生相同的效果，以便他们开始或停止播放或同时捕获数据。

参数

lines，应同步线

maintainSync - true如果必须精确地保持同步（即同步要样品的精确）在任何时候的线路运行期间，或 false如果精确同步，只需要在启动和停止操作

异常

IllegalArgumentException -如果线路不能同步。这可能会发生，如果线是不同的类型或有不同的格式，这台混频器不支持同步，或如果指定的所有行不属于这个混频器。

unsynchronize

void unsynchronize(Line[] lines)

释放指定行的同步。该数组必须与已建立的同步的相同，否则可能会引发异常。然而， null可以指定，在这种情况下，所有目前同步，属于本机线是同步的。

参数

lines -同步线，同步应释放，或 null所有本机的同步线

异常

IllegalArgumentException -如果线路不能同步。如果指定的参数不完全匹配同步已建立的一组行，则可能会发生此问题。

isSynchronizationSupported

boolean isSynchronizationSupported(Line[] lines,
                                   boolean maintainSync)

报告此密炼机是否支持指定的行集的同步。

参数

lines -线，同步支持集合查询

maintainSync - true如果必须精确地保持同步（即同步要样品的精确）在任何时候的线路运行期间，或 false如果精确同步，只需要在启动和停止操作

结果

true如果线可以同步， false否则