Synthesizer (Java Platform SE 8 )

All Superinterfaces:

AutoCloseable ， MidiDevice
```
public interface Synthesizer
extends MidiDevice
```
A Synthesizer产生声音。当之一这通常发生Synthesizer的MidiChannel个对象接收noteOn消息，无论是直接或经由Synthesizer对象。许多Synthesizer支持Receivers ，通过它可以将MIDI事件传送到Synthesizer 。在这种情况下， Synthesizer典型地通过发送相应的消息到适当的响应MidiChannel ，或通过处理事件本身，如果事件不是MIDI信道消息中的一个。
Synthesizer界面包括从声音库装载和卸载乐器的方法。仪器是合成某种声音的规范，无论该声音是仿效传统乐器还是某种音效或其他虚构声音。声音库是由银行和节目编号（通过仪器的Patch对象）组织的Patch集合。不同的Synthesizer类可以实现不同的声音合成技术，这意味着一些乐器而不是其他乐器可能与给定的合成器兼容。此外，合成器可能对仪器具有有限的存储空间，这意味着即使合成技术是兼容的，并不是每个合成器都可以使用每个声音库和仪器。看是否从某个音库的仪器可以通过一个给定的合成器上播放，调用isSoundbankSupported的方法Synthesizer 。

“装载”仪器意味着该仪器可用于合成笔记。仪器被装载到由其Patch对象指定的存储区和程序位置。装载不一定意味着随后播放的音符将立即具有这个新装载的乐器的声音。要使乐器演奏音符，合成器的一个MidiChannel对象必须接收（或已收到）一个程序更改消息，导致该特定乐器的银行和节目号码被选中。

另请参见：

MidiSystem.getSynthesizer() ， Soundbank ， Instrument ， MidiChannel.programChange(int, int) ， Receiver ， Transmitter ， MidiDevice

Nested Class Summary
- Nested classes/interfaces inherited from interface javax.sound.midi.MidiDevice
  MidiDevice.Info

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`Instrument[]`	`getAvailableInstruments()` 获取合成器随附的仪器列表。
`MidiChannel[]`	`getChannels()` 获得由该合成器控制的一组MIDI通道。
`Soundbank`	`getDefaultSoundbank()` 获取合成器的默认声音库（如果存在）。
`long`	`getLatency()` 获得该合成器产生的处理延迟，以微秒表示。
`Instrument[]`	`getLoadedInstruments()` 获取当前加载到此 `Synthesizer` 。
`int`	`getMaxPolyphony()` 获取此合成器可以同时发声的最大音符数。
`VoiceStatus[]`	`getVoiceStatus()` 获取此合成器产生的声音的当前状态。
`boolean`	`isSoundbankSupported(Soundbank soundbank)` 通知呼叫者该合成器是否能够从指定的声音库加载仪器。
`boolean`	`loadAllInstruments(Soundbank soundbank)` 载入指定的 `Synthesizer`所有仪器 `Soundbank` 。
`boolean`	`loadInstrument(Instrument instrument)` 使特定的仪器可用于合成。
`boolean`	`loadInstruments(Soundbank soundbank, Patch[] patchList)` 从指定的Soundbank加载指定补丁引用的 `Soundbank` 。
`boolean`	`remapInstrument(Instrument from, Instrument to)` 重新配置仪器。
`void`	`unloadAllInstruments(Soundbank soundbank)` 卸载指定的Soundbank中包含的所有 `Soundbank` 。
`void`	`unloadInstrument(Instrument instrument)` 卸载特定的仪器。
`void`	`unloadInstruments(Soundbank soundbank, Patch[] patchList)` 从指定的MIDI声音库中卸载指定补丁引用的乐器。

Methods inherited from interface javax.sound.midi.MidiDevice
close, getDeviceInfo, getMaxReceivers, getMaxTransmitters, getMicrosecondPosition, getReceiver, getReceivers, getTransmitter, getTransmitters, isOpen, open

- 方法详细信息
  - getMaxPolyphony
```
int getMaxPolyphony()
```
    获取此合成器可以同时发声的最大音符数。
    
    结果
    
    同时记录的最大数量
    
    另请参见：
    
    getVoiceStatus()
  - getLatency
```
long getLatency()
```
    获得该合成器产生的处理延迟，以微秒表示。该延迟测量MIDI信号传送到合成器的时间与合成器实际产生相应结果的时间之间的最差时延。
    虽然延迟以微秒表示，但合成器的实际测量延迟可能会在该分辨率表示的范围内变化。例如，合成器可能具有几毫秒或更多的最坏情况延迟。
    
    结果
    
    最差的延迟，以微秒为单位
  - getChannels
```
MidiChannel[] getChannels()
```
    获得由该合成器控制的一组MIDI通道。返回数组中的每个非空元素都是MidiChannel ，它接收该通道号发送的MIDI消息。
    MIDI 1.0规范提供16个通道，因此此方法返回至少16个元素的数组。但是，如果该合成器没有使用所有16个通道，则阵列的某些元素可能为null ，因此在使用之前应检查每个元素。
    
    结果
    
    所述的数组MidiChannel由该管理对象Synthesizer 。一些阵列元素可以是null 。
  - getVoiceStatus
```
VoiceStatus[] getVoiceStatus()
```
    获取此合成器产生的声音的当前状态。如果这个Synthesizer类不提供语音信息，则返回的数组将始终为长度0.否则，其长度总是等于getMaxPolyphony()返回的getMaxPolyphony() 。（有关合成器语音的说明，请参阅VoiceStatus类描述。）
    
    结果
    
    一组 VoiceStatus对象，提供有关相应合成器语音的信息
    
    另请参见：
    
    getMaxPolyphony() ， VoiceStatus
  - isSoundbankSupported
```
boolean isSoundbankSupported(Soundbank soundbank)
```
    通知呼叫者该合成器是否能够从指定的声音库加载仪器。如果声音库不受支持，任何从其加载乐器的尝试将导致IllegalArgumentException 。
    
    参数
    
    soundbank - 查询支持的soundbank
    
    结果
    
    true如果声音支持，否则 false
    
    另请参见：
    
    loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]) ， loadAllInstruments(javax.sound.midi.Soundbank) ， unloadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]) ， unloadAllInstruments(javax.sound.midi.Soundbank) ， getDefaultSoundbank()
  - loadInstrument
```
boolean loadInstrument(Instrument instrument)
```
    使特定的仪器可用于合成。该仪器被装载到由其Patch对象指定的补丁位置，以便如果接收到（或已经被接收到）导致该补丁被选择的程序改变消息，则将使用instrument的声音来播放随后的音符。如果指定的仪器已经加载，此方法不执行任何操作并返回true 。
    仪器必须是Synthesizer支持的声音库的一部分。（要确保，你可以使用getSoundbank的方法Instrument和isSoundbankSupported的方法Synthesizer ）。
    
    参数
    
    instrument - 仪器加载
    
    结果
    
    true如果仪器已成功加载（或已经）， false如果仪器无法加载（例如，如果合成器没有足够的存储器加载）
    
    异常
    
    IllegalArgumentException - 如果这个 Synthesizer不支持指定乐器的声音库
    
    另请参见：
    
    unloadInstrument(javax.sound.midi.Instrument) ， loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]) ， loadAllInstruments(javax.sound.midi.Soundbank) ， remapInstrument(javax.sound.midi.Instrument, javax.sound.midi.Instrument) ， SoundbankResource.getSoundbank() ， MidiChannel.programChange(int, int)
  - unloadInstrument
```
void unloadInstrument(Instrument instrument)
```
    卸载特定的仪器。
    
    参数
    
    instrument - 仪器卸载
    
    异常
    
    IllegalArgumentException - 如果这个 Synthesizer不支持指定乐器的声音库
    
    另请参见：
    
    loadInstrument(javax.sound.midi.Instrument) ， unloadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]) ， unloadAllInstruments(javax.sound.midi.Soundbank) ， getLoadedInstruments() ， remapInstrument(javax.sound.midi.Instrument, javax.sound.midi.Instrument)
  - remapInstrument
```
boolean remapInstrument(Instrument from,
                        Instrument to)
```
    重新配置仪器。仪器to取代仪器from 。
    例如，如果from位于银行编号2，程序编号11，重新映射会导致银行和程序位置占用代替to 。
    如果功能成功，仪器from将被卸载。
    要取消重新映射重载仪器from通过调用之一loadInstrument(javax.sound.midi.Instrument) ， loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])或loadAllInstruments(javax.sound.midi.Soundbank) 。
    
    参数
    
    from - 要替换的 Instrument对象
    
    to - Instrument对象要用于代替旧仪器，应该加载到合成器
    
    结果
    
    true如果仪器成功重新映射， false如果功能未由合成器实现
    
    异常
    
    IllegalArgumentException - 如果仪器 from或仪器 to不被合成器支持，或者仪器 to未加载
    
    NullPointerException - 如果 from或 to参数具有空值
    
    另请参见：
    
    loadInstrument(javax.sound.midi.Instrument) ， loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[]) ， loadAllInstruments(javax.sound.midi.Soundbank)
  - getDefaultSoundbank
```
Soundbank getDefaultSoundbank()
```
    获取合成器的默认声音库（如果存在）。（一些合成器提供默认或内置声音库。）如果合成器没有默认声音库，仪器必须明确地从外部声音库中加载。
    
    结果
    
    默认soundbank，或 null如果不存在。
    
    另请参见：
    
    isSoundbankSupported(javax.sound.midi.Soundbank)
  - getAvailableInstruments
```
Instrument[] getAvailableInstruments()
```
    获取合成器随附的仪器列表。这些乐器可能内置在合成器中，或者它们可能是合成器等提供的默认声音库的一部分。
    请注意，您不要使用此方法找出当前加载到合成器上的仪器; 为此，您使用getLoadedInstruments() 。该方法也不会指示可以加载到合成器上的所有仪器; 它只表示合成器附带的子集。要了解是否可以加载另一台仪器，您可以调用isSoundbankSupported() ，如果仪器的Soundbank支持，您可以尝试加载仪器。
    
    结果
    
    可用仪器清单。如果合成器没有仪器，则返回长度为0的数组。
    
    另请参见：
    
    getLoadedInstruments() ， isSoundbankSupported(Soundbank) ， loadInstrument(javax.sound.midi.Instrument)
  - getLoadedInstruments
```
Instrument[] getLoadedInstruments()
```
    获取当前加载到此 Synthesizer 。
    
    结果
    
    当前加载的乐器的列表
    
    另请参见：
    
    loadInstrument(javax.sound.midi.Instrument) ， getAvailableInstruments() ， Soundbank.getInstruments()
  - loadAllInstruments
```
boolean loadAllInstruments(Soundbank soundbank)
```
    载入到指定的 Synthesizer所有仪器 Soundbank 。
    
    参数
    
    soundbank -在 Soundbank是谁的仪器要装载
    
    结果
    
    true如果仪器都已成功加载（或已经过）， false如果任何乐器无法加载（例如，如果 Synthesizer了内存不足）
    
    异常
    
    IllegalArgumentException - 如果请求的声音库与此合成器不兼容。
    
    另请参见：
    
    isSoundbankSupported(javax.sound.midi.Soundbank) ， loadInstrument(javax.sound.midi.Instrument) ， loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])
  - unloadAllInstruments
```
void unloadAllInstruments(Soundbank soundbank)
```
    卸载指定的Soundbank中包含的所有 Soundbank 。
    
    参数
    
    soundbank - 声音包含仪器卸载
    
    异常
    
    IllegalArgumentException - 如果不支持 IllegalArgumentException ，则抛出。
    
    另请参见：
    
    isSoundbankSupported(javax.sound.midi.Soundbank) ， unloadInstrument(javax.sound.midi.Instrument) ， unloadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])
  - loadInstruments
```
boolean loadInstruments(Soundbank soundbank,
                        Patch[] patchList)
```
    从指定的Soundbank加载指定补丁引用的Soundbank 。 Patch对象中的每一个都表示银行和程序号码; 该Instrument具有匹配Patch被加载到库和程序位置。
    
    参数
    
    soundbank -所述 Soundbank含有文书加载
    
    patchList - 应装载仪器的补丁列表
    
    结果
    
    true如果仪器都已成功加载（或已经过）， false如果任何乐器无法加载（例如，如果 Synthesizer了内存不足）
    
    异常
    
    IllegalArgumentException - 如果不支持 IllegalArgumentException ，则抛出。
    
    另请参见：
    
    isSoundbankSupported(javax.sound.midi.Soundbank) ， Instrument.getPatch() ， loadAllInstruments(javax.sound.midi.Soundbank) ， loadInstrument(javax.sound.midi.Instrument) ， Soundbank.getInstrument(Patch) ， Sequence.getPatchList()
  - unloadInstruments
```
void unloadInstruments(Soundbank soundbank,
                       Patch[] patchList)
```
    从指定的MIDI声音库中卸载指定补丁引用的乐器。
    
    参数
    
    soundbank - 声音包含仪器卸载
    
    patchList - 应卸载仪器的补丁列表
    
    异常
    
    IllegalArgumentException - 如果不支持 IllegalArgumentException ，则抛出。
    
    另请参见：
    
    unloadInstrument(javax.sound.midi.Instrument) ， unloadAllInstruments(javax.sound.midi.Soundbank) ， isSoundbankSupported(javax.sound.midi.Soundbank) ， Instrument.getPatch() ， loadInstruments(javax.sound.midi.Soundbank, javax.sound.midi.Patch[])

Interface Synthesizer

Nested Class Summary

Nested classes/interfaces inherited from interface javax.sound.midi.MidiDevice

方法摘要

Methods inherited from interface javax.sound.midi.MidiDevice

方法详细信息

getMaxPolyphony

getLatency

getChannels

getVoiceStatus

isSoundbankSupported

loadInstrument

unloadInstrument

remapInstrument

getDefaultSoundbank

getAvailableInstruments

getLoadedInstruments

loadAllInstruments

unloadAllInstruments

loadInstruments

unloadInstruments