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