Класс MetaMessage
- Все реализованные интерфейсы:
Cloneable
public class MetaMessage extends MidiMessage
MetaMessage является MidiMessage, который не имеет смысла для синтезаторов, но может быть сохранён в файле MIDI и интерпретирован программой секвенсора. (См. обсуждение в описании класса MidiMessage). Спецификация Standard MIDI Files определяет различные типы метасобытий, такие как номер последовательности, текст, точка отсчёта и скорость воспроизведения. Также существуют метасобытия для информации, такой как текст, авторские права, указания темпа, знаки альтерации, маркеры и т. д. Для получения дополнительной информации см. спецификацию Standard MIDI Files 1.0, которая является частью Полной спецификации MIDI 1.0, опубликованной MIDI Manufacturer's Association (http://www.midi.org). При передаче данных с помощью протокола MIDI wire, ShortMessage со значением статуса 0xFF представляет собой сообщение о сбросе системы. В файлах MIDI это же значение статуса обозначает MetaMessage. Типы метасообщений различаются по первому байту, следующему за байтом статуса 0xFF. Последующие байты — это данные. Как и в случае с системными эксклюзивными сообщениями, количество байтов данных произвольное, в зависимости от типа MetaMessage.
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
META |
Байт статуса для MetaMessage (0xFF, или 255), используемый в файлах MIDI. |
Поля, объявленные в классе javax.sound.midi.MidiMessage
data, length
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
| Создаёт новый MetaMessage. |
||
protected |
Создаёт новый MetaMessage. |
|
| Создаёт новый MetaMessage и устанавливает параметры сообщения. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object |
clone() |
Создаёт новый объект того же класса и с тем же содержимым, что и этот объект. |
byte[] |
getData() |
Получает копию данных для метасообщения. |
int |
getType() |
Получает тип MetaMessage. |
void |
setMessage |
Устанавливает параметры сообщения для MetaMessage. |
Методы, объявленные в классе javax.sound.midi.MidiMessage
getLength, getMessage, getStatus, setMessage
Подробное описание полей
META
public static final int META
MetaMessage (0xFF, или 255), который используется в файлах MIDI. Он имеет то же значение, что и ShortMessage.SYSTEM_RESET, который используется в протоколе реального времени "MIDI провод".- См. также:
Подробное описание конструкторов
MetaMessage
public MetaMessage()
MetaMessage. Содержимое сообщения здесь не устанавливается; используйте setMessage, чтобы установить его позднее.MetaMessage
public MetaMessage(int type, byte[] data, int length) throws InvalidMidiDataException
MetaMessage и устанавливает параметры сообщения. Содержимое сообщения можно изменить, используя метод setMessage.- Параметры:
-
type- тип мета-сообщения (должен быть меньше 128) -
data- байты данных в сообщении MIDI -
length- количество байтов в массиве байтовdata; оно должно быть неотрицательным и меньше или равноdata.length - Исключения:
-
InvalidMidiDataException- если значения параметров не задают корректное мета-сообщение MIDI - С:
- 1.7
- См. также:
MetaMessage
protected MetaMessage(byte[] data)
MetaMessage.- Параметры:
-
data- массив байтов, содержащий полное сообщение. Данные сообщения можно изменить, используя методsetMessage. - См. также:
Подробное описание методов
setMessage
public void setMessage(int type, byte[] data, int length) throws InvalidMidiDataException
MetaMessage. Поскольку для мета-сообщений разрешено только одно значение байта состояния, 0xFF, его не нужно указывать здесь. Вызовы getStatus возвращают 0xFF для всех мета-сообщений. Аргумент type должен быть допустимым значением для байта, следующего за байтом состояния в MetaMessage. Аргумент data должен содержать все последующие байты MetaMessage. Другими словами, байт, указывающий тип MetaMessage, не считается байтом данных.
- Параметры:
-
type- тип мета-сообщения (должен быть меньше 128) -
data- байты данных в сообщении MIDI -
length- количество байтов в массиве байтовdata - Исключения:
-
InvalidMidiDataException- если значения параметров не задают корректное мета-сообщение MIDI
getType
public int getType()
MetaMessage.- Возвращает:
- целое число, представляющее тип
MetaMessage
getData
public byte[] getData()
- Возвращает:
- массив, содержащий данные мета-сообщения
- См. также:
clone
public Object clone()
- Определено в:
-
cloneв классеMidiMessage - Возвращает:
- клонированный экземпляр
- См. также:
© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/midi/MetaMessage.html
