Класс SoundbankResource

java.lang.Object
- javax.sound.midi.SoundbankResource

Прямые известные подклассы:: Instrument

public abstract class SoundbankResource
extends Object

A SoundbankResource представляет любой аудиоресурс, хранящийся в Soundbank. Общие ресурсы soundbank включают:

Инструменты. Инструмент может быть указан различными способами. Однако все soundbank имеют некоторый механизм для определения инструментов. При этом они могут ссылаться на другие ресурсы, хранящиеся в soundbank. Каждый инструмент имеет Patch, который определяет MIDI-программу и банк, по которым он может быть указан в MIDI-сообщениях. Информация об инструменте может храниться в объектах Instrument.
Аудиосэмплы. Сэмпл обычно представляет собой сэмплированную аудиоволну, которая содержит короткую звуковую запись, длительность которой составляет часть секунды или не более нескольких секунд. Эти аудиосэмплы могут использоваться Synthesizer для синтеза звука в ответ на MIDI-команды или извлекаться для использования приложением. (Терминология отражает музыкальное использование слова «сэмпл» для обозначения серии смежных аудиосэмплов или кадров, а не единичного мгновенного сэмпла.) Класс данных для аудиосэмпла будет объектом, который encapsulates сами аудиоданные и информацию о том, как их интерпретировать (формат аудиоданных), например, AudioInputStream.
Встроенные последовательности. Soundbank может содержать встроенные данные песен, хранящиеся в объекте данных, таком как Sequence.

Синтезаторы, использующие синтез волновых таблиц или родственные методы, воспроизводят аудио в сэмпле при синтезировании нот, часто при эмуляции реального инструмента, который был первоначально записан. Однако не обязательно существует взаимно однозначное соответствие между Instruments и сэмплами в Soundbank. Один Instrument может использовать несколько SoundbankResource (обычно для нот с различным тоном или яркостью). Кроме того, более одного Instrument может использовать один и тот же сэмпл.

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

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

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

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

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

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

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

SoundbankResource

protected SoundbankResource(Soundbank soundBank,
                            String name,
                            Class<?> dataClass)

Создает новый SoundbankResource из заданного sound bank и индекса wavetable. (Установка имени SoundbankResource's, данных сэмплированного аудио и инструментов является задачей подкласса.)

Параметры:: soundBank - sound bank, содержащий этот SoundbankResource; name - имя сэмпла; dataClass - класс, используемый для представления данных сэмпла
См. также:: getSoundbank(), getName(), getDataClass(), getData()

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

getSoundbank

public Soundbank getSoundbank()

Получает sound bank, содержащий этот SoundbankResource.

Возвращает:: sound bank, в котором хранится этот SoundbankResource

getName

public String getName()

Получает имя ресурса. Обычно это строка, описывающая ресурс.

Возвращает:: имя инструмента

getDataClass

public Class<?> getDataClass()

Получает класс, используемый этим сэмплом для представления его данных. Объект, возвращаемый getData, будет этого класса. Если этот объект SoundbankResource не поддерживает прямой доступ к своим данным, возвращает null.

Возвращает:: класс, используемый для представления данных сэмпла, или null, если данные недоступны

getData

public abstract Object getData()

Получает сэмплированное аудио, хранящееся в этом SoundbankResource. Тип возвращаемого объекта зависит от реализации конкретного класса и может быть запрошен с помощью getDataClass.

Возвращает:: объект, содержащий данные сэмплированного аудио
См. также:: getDataClass()