Класс MidiMessage

public abstract class MidiMessage extends Object implements Cloneable

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