javax.sound.midi

Interface Soundbank

public interface Soundbank

一个 Soundbank包含一组 Instruments可加载到 Synthesizer。注意一个java的声音 Soundbank不同于MIDI银行。MIDI允许多达16383个银行，每个包含128个工具（有时也被称为程序，补丁，或音色）。然而，一个 Soundbank可以包含16383次128的仪器，因为在 Soundbank仪器是由一个MIDI程序号和MIDI银行号码索引（通过 Patch对象）。因此，一个 Soundbank可以被认为是一个集MIDI银行。

Soundbank包括方法返回String对象包含了健全的银行的名称、生产厂家、版本号和描述。这些字符串的确切内容和格式是留给实施者。

不同的合成使用各种合成技术。一个常见的是波表合成，其中一段录音回放，经常循环和音高的变化。可下载的声音（DLS）格式使用录音片段，如顶空引擎。Soundbanks和Instruments是基于波表合成（或存储的录音的其他用途）通常应实施提供访问这些记录的片段getResources()方法。这是可选的，但是；方法可返回如果合成技术不使用采样声音的长度为零的数组（FM合成和物理建模是这样的技术），或如果它不但是实现者选择不使样品可。

另请参见：

Synthesizer.getDefaultSoundbank()， Synthesizer.isSoundbankSupported(javax.sound.midi.Soundbank)， Synthesizer.loadInstruments(Soundbank, Patch[])， Patch， Instrument， SoundbankResource

方法摘要

Modifier and Type	Method and Description
String	getDescription() 获得声音库的文本描述，适合于显示。
Instrument	getInstrument(Patch patch) 从一个给定的 Patch Instrument。
Instrument[]	getInstruments() 获取包含在这个声音库中的仪器的列表。
String	getName() 获取声音库的名称。
SoundbankResource[]	getResources() 提取声音库中包含的非工具资源列表。
String	getVendor() 获得 string命名的公司，提供良好的银行
String	getVersion() 获取声音库的版本字符串。

方法详细信息

getName

String getName()

获取声音库的名称。

结果

一个健全的银行 String命名

getVersion

String getVersion()

获取声音库的版本字符串。

结果

一个 String表明声音银行版

getVendor

String getVendor()

获得 string命名的公司，提供良好的银行

结果

供应商的字符串

getDescription

String getDescription()

获得声音库的文本描述，适合于显示。

结果

一个 String描述声音银行

getResources

SoundbankResource[] getResources()

提取声音库中包含的非工具资源列表。

结果

资源数组，不包括仪器。如果声音库不包含任何资源（其他工具），则返回一个长度为0的数组。

getInstruments

Instrument[] getInstruments()

获取包含在这个声音库中的仪器的列表。

结果

在这 SoundBank数组的 Instruments如果声音银行不包含工具，返回的数组长度为0。

另请参见：

Synthesizer.getLoadedInstruments()， getInstrument(Patch)

getInstrument

Instrument getInstrument(Patch patch)

从一个给定的 Patch Instrument。

参数

patch - Patch对象指定银行指数和程序更改号码

结果

要求的仪器，或 null如果声音银行不包含工具

另请参见：

getInstruments()， Synthesizer.loadInstruments(Soundbank, Patch[])