Spec-Zone.ru › OpenJDK 25

Класс SoundbankResource

java.lang.Object
javax.sound.midi.SoundbankResource
Прямые известные подклассы:
Instrument
public abstract class SoundbankResource extends Object
SoundbankResource представляет любой аудиоресурс, хранящийся в Soundbank. К распространённым ресурсам звукового банка относятся:
  • Инструменты. Инструмент может быть указан различными способами. Однако в каждом звуковом банке предусмотрен механизм определения инструментов. При этом могут использоваться ссылки на другие ресурсы, хранящиеся в звуковом банке. Каждый инструмент имеет Patch, который указывает MIDI-программу и банк, по которым на него можно ссылаться в MIDI-сообщениях. Информация об инструментах может храниться в объектах Instrument.
  • Аудиосэмплы. Сэмпл обычно представляет собой оцифрованную звуковую волну, содержащую короткую запись звука длительностью в доли секунды или, самое большее, несколько секунд. Эти аудиосэмплы могут использоваться Synthesizer для синтеза звука в ответ на MIDI-команды или извлекаться для использования приложением. (Терминология отражает употребление музыкантами слова «сэмпл» для обозначения последовательности непрерывных аудиосэмплов или кадров, а не одного мгновенного сэмпла.) Класс данных аудиосэмпла — это объект, инкапсулирующий сами данные аудиосэмпла и сведения об их интерпретации (формат аудиоданных), например AudioInputStream.
  • Встроенные последовательности. Звуковой банк может содержать встроенные данные музыкальных произведений, сохранённые в объекте данных, например Sequence.
Синтезаторы, использующие табличный синтез или связанные с ним методы, воспроизводят аудио из сэмпла при синтезе нот, часто имитируя реальный инструмент, запись которого была использована. Однако между Instruments и сэмплами в Soundbank не обязательно существует взаимно однозначное соответствие. Один Instrument может использовать несколько SoundbankResource (обычно для нот с различающейся высотой тона или яркостью звучания). Кроме того, один и тот же сэмпл могут использовать несколько Instrument.

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

SoundbankResource(Soundbank soundBank, String name, Class<?> dataClass)
Модификатор Конструктор Описание
protected
Создаёт новый SoundbankResource на основе указанного звукового банка и индекса таблицы волн.

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

Модификатор и тип Метод Описание
abstract Object getData()
Получает аудиосэмпл, хранящийся в этом SoundbankResource.
Class<?> getDataClass()
Получает класс, используемый этим сэмплом для представления его данных.
String getName()
Получает имя ресурса.
Soundbank getSoundbank()
Получает звуковой банк, содержащий этот SoundbankResource.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

SoundbankResource

protected SoundbankResource(Soundbank soundBank, String name, Class<?> dataClass)
Создаёт новый SoundbankResource на основе указанного звукового банка и индекса таблицы волн. (Задание имени SoundbankResource's, аудиоданных сэмпла и инструментов возлагается на подкласс.)
Параметры:
soundBank — звуковой банк, содержащий этот SoundbankResource
name — имя сэмпла
dataClass — класс, используемый для представления данных сэмпла
См. также:
  • getSoundbank()
  • getName()
  • getDataClass()
  • getData()

Подробное описание методов

getSoundbank

public Soundbank getSoundbank()
Получает звуковой банк, содержащий этот SoundbankResource.
Возвращает:
звуковой банк, в котором хранится этот SoundbankResource

getName

public String getName()
Получает имя ресурса. Как правило, это должна быть строка, описывающая ресурс.
Возвращает:
имя инструмента

getDataClass

public Class<?> getDataClass()
Получает класс, используемый этим сэмплом для представления его данных. Объект, возвращаемый getData, будет принадлежать этому классу. Если этот объект SoundbankResource не поддерживает прямой доступ к своим данным, возвращает null.
Возвращает:
класс, используемый для представления данных сэмпла, или null, если данные недоступны

getData

public abstract Object getData()
Получает аудиосэмпл, хранящийся в этом SoundbankResource. Тип возвращаемого объекта зависит от реализации конкретного класса; его можно определить с помощью getDataClass.
Возвращает:
объект, содержащий аудиоданные сэмпла
См. также:
  • getDataClass()

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по 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/SoundbankResource.html

Spec-Zone.ru

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