javax.sound.midi
介面 Soundbank

public interface Soundbank

Soundbank 套件含可載入到 Synthesizer 中的一組 Instruments。注意，Java Sound Soundbank 不同於 MIDI 資源庫。MIDI 允許有 16383 個資源庫，每個資源庫包含 128 種樂器（有時又稱程序、包或音色）。但是，一個 Soundbank 可包含 16383 乘以 128 種樂器，因為 Soundbank 中的樂器按 MIDI 程序號和 MIDI 資源庫號索引的（通過 Patch 物件）。因此，一個 Soundbank 可當作一組 MIDI 資源庫。

Soundbank 套件括了返回 String 物件的方法（該物件中包含音資源庫名稱、製造商、版本號和描述）。這些字元串的準確內容和格式留給實作程序掌握。

不同的合成器使用各種合成技巧。常見的一種合成技巧是波表合成，回放其中一個錄製的聲音段，通常使用循環和音高更改。Downloadable Sound (DLS) 格式使用錄製的聲音段，如同 Headspace Engine 一樣。基於波表合成（或其他使用所存儲的錄製聲音）的 Soundbanks 和 Instruments 通常應實作 getResources() 方法，以提供對這些錄製段的存取。但是，這是可選的；如果合成技巧未使用採樣聲音（FM 合成和物理建模是這類別技巧的範例），或者使用了採樣聲音但實作程序選擇了使採樣不可存取，則此方法可返回一個長度為零的陣列。

另請參見：

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

方法摘要

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[])