Spec-Zone.ru › OpenJDK 25

Интерфейс Soundbank

public interface Soundbank
Soundbank содержит набор Instruments, которые можно загрузить в Synthesizer. Обратите внимание, что 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(Soundbank)
  • Synthesizer.loadInstruments(Soundbank, Patch[])
  • Patch
  • Instrument
  • SoundbankResource

Краткое описание методов

Модификатор и тип Метод Описание
String getDescription()
Возвращает текстовое описание звукового банка, пригодное для отображения.
Instrument getInstrument(Patch patch)
Возвращает Instrument из указанного Patch.
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()
Возвращает список инструментов, содержащихся в этом звуковом банке.
Возвращает:
массив Instruments в этом SoundBank. Если звуковой банк не содержит инструментов, возвращается массив длины 0.
См. также:
  • Synthesizer.getLoadedInstruments()
  • getInstrument(Patch)

getInstrument

Instrument getInstrument(Patch patch)
Возвращает Instrument из указанного Patch.
Параметры:
patch — объект Patch, задающий индекс банка и номер смены программы
Возвращает:
запрошенный инструмент или null, если звуковой банк не содержит этот инструмент
См. также:
  • getInstruments()
  • Synthesizer.loadInstruments(Soundbank, Patch[])

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, общие сведения, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.desktop/javax/sound/midi/Soundbank.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API