Класс MidiMessage

public abstract class MidiMessage extends Object implements Cloneable

MidiMessage — это базовый класс для сообщений MIDI. Он включает не только стандартные сообщения MIDI, на которые может реагировать синтезатор, но также и «метасобытия», которые могут использоваться программами секвенсоров. Существуют метасобытия для такой информации, как тексты, авторские права, указания темпа, знаки времени и тональности, маркеры и т. д. Более подробную информацию см. в спецификации Standard MIDI Files 1.0, которая является частью полной спецификации Complete MIDI 1.0 Detailed Specification, опубликованной Ассоциацией производителей MIDI (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.