Класс 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-команды или извлекаться для использования приложением. (Терминология отражает использование музыкантами слова "сэмпл" для обозначения серии смежных аудио-сэмплов или кадров, а не для обозначения одного мгновенного сэмпла.) Класс данных для аудио-сэмпла будет объектом, который инкапсулирует сами данные аудио-сэмпла и информацию о том, как их интерпретировать (формат аудиоданных), например AudioInputStream.
Встроенные последовательности. Soundbank может содержать встроенные данные песен, хранящиеся в объекте данных, таком как Sequence.

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

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

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

Модификатор	Конструктор	Описание
`protected`	Создаёт новый `SoundbankResource` из заданного sound bank и индекса волновой таблицы.

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

Модификатор и тип	Метод	Описание
`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 и индекса волновой таблицы. (Установка имени 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()

© 1993, 2021, 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/17/docs/api/java.desktop/javax/sound/midi/SoundbankResource.html