Класс MidiMessage
- Все реализуемые интерфейсы:
Cloneable
- Прямые известные подклассы:
-
MetaMessage,ShortMessage,SysexMessage
public abstract class MidiMessage extends Object implements Cloneable
MidiMessage является базовым классом для сообщений MIDI. Они включают не только стандартные сообщения MIDI, на которые может реагировать синтезатор, но также и «мета-события», которые могут использоваться программами секвенсоров. Существуют мета-события для такой информации, как тексты, авторские права, указания темпа, временные и тональные характеристики, метки и т. д. Для получения дополнительной информации см. спецификацию Standard MIDI Files 1.0, которая является частью полной спецификации MIDI 1.0, опубликованной MIDI Manufacturer's Association (http://www.midi.org). Базовый класс MidiMessage предоставляет доступ к трём типам информации о сообщении MIDI:
- Байт состояния сообщения
- Полная длина сообщения в байтах (байт состояния плюс любые данные байты)
- Массив байтов, содержащий полное сообщение
MidiMessage включает методы для получения, но не задания этих значений. Их задание является задачей подклассов. Стандарт MIDI выражает данные MIDI в байтах. Однако, поскольку Java использует знаковый байт, API Java Sound использует целые числа вместо байтов при выражении данных MIDI. Например, метод getStatus() класса MidiMessage возвращает байты состояния MIDI как целые числа. Если вы обрабатываете данные MIDI, полученные вне Java Sound и теперь закодированные как знакомые байты, байты можно преобразовать в целые числа с помощью этого преобразования:
int i = (int)(byte & 0xFF)
Если вам просто нужно передать известное значение байта MIDI в качестве параметра метода, его можно выразить непосредственно как целое число, используя, например, десятичную или шестнадцатеричную запись. Например, чтобы передать байт состояния «активного сканирования» в качестве первого аргумента методу setMessage(int) класса ShortMessage, вы можете выразить его как 254 или 0xFE.
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected byte[] |
data |
Данные сообщения MIDI. |
protected int |
length |
Количество байтов в сообщении MIDI, включая байт состояния и любые данные байты. |
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Создаёт новый MidiMessage. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract Object |
clone() |
Создаёт новый объект того же класса с тем же содержимым, что и этот объект. |
int |
getLength() |
Получает общую длину сообщения MIDI в байтах. |
byte[] |
getMessage() |
Получает данные сообщения MIDI. |
int |
getStatus() |
Получает байт состояния сообщения MIDI. |
protected void |
setMessage |
Устанавливает данные для сообщения MIDI. |
Подробное описание полей
data
protected byte[] data
- См. также:
length
protected int length
- См. также:
Подробное описание конструкторов
MidiMessage
protected MidiMessage(byte[] data)
MidiMessage. Этот защищённый конструктор вызывается конкретными подклассами, которые должны гарантировать, что массив данных определяет полное, действительное сообщение MIDI.- Параметры:
-
data- массив байтов, содержащий полное сообщение. Данные сообщения можно изменить с помощью методаsetMessage. - См. также:
Подробное описание методов
setMessage
protected void setMessage(byte[] data, int length) throws InvalidMidiDataException
- Параметры:
-
data- данные байты в сообщении MIDI -
length- количество байтов в массиве данных байтов - Исключения:
-
InvalidMidiDataException- если значения параметров не определяют действительное метасообщение MIDI
getMessage
public byte[] getMessage()
getLength().- Возвращает:
- массив байтов, содержащий полные данные
MidiMessage
getStatus
public int getStatus()
MidiMessage.- Возвращает:
- целочисленное представление байта состояния этого события
getLength
public int getLength()
- Возвращает:
- длину сообщения в байтах
clone
public abstract Object clone()
- Переопределяет:
-
cloneв классеObject - Возвращает:
- клонированный экземпляр
- См. также:
© 1993, 2023, 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/21/docs/api/java.desktop/javax/sound/midi/MidiMessage.html