javax.sound.midi

Класс SysexMessage

java.lang. Объект

javax.sound.midi. MidiMessage

javax.sound.midi. SysexMessage

Все Реализованные Интерфейсы:

Cloneable

public class SysexMessage
extends MidiMessage

A SysexMessage объект представляет систему MIDI монопольное сообщение.

Когда у системы, монопольное сообщение читается из файла MIDI, это всегда, есть определенная длина. Данные от системы монопольное сообщение от файла MIDI должны храниться в массиве данных a SysexMessage следующим образом: система монопольный байт состояния сообщения (0xF0 или 0xF7), все байты данных сообщения, и наконец флаг конца-монопольного (0xF7). Длина, о которой сообщают SysexMessage объект является поэтому длиной системы монопольные данные плюс два: один байт для байта состояния и один для флага конца-монопольного.

Как диктующийся Стандартной спецификацией Файлов MIDI, два значения байта состояния являются законными для a SysexMessage читайте из файла MIDI:

• 0xF0: Монопольное сообщение Системы (то же самое как в MIDI соединяет протокол проводом),
• 0xF7: Специальная Система Монопольное сообщение

Когда Звук Java используется, чтобы обработать систему монопольные данные, которые получаются, используя протокол провода MIDI, это должно поместить данные в один или больше SysexMessages. В этом случае длина системы монопольные данные не известна заранее; конец системы монопольные данные отмечается флагом конца-монопольного (0xF7) в потоке байтов провода MIDI.

• 0xF0: Монопольное сообщение Системы (то же самое как в MIDI соединяет протокол проводом),
• 0xF7: Конец Монопольных (EOX)

Первое SysexMessage у объекта, содержащего данные для определенной системы монопольное сообщение, должно быть значение состояния 0xF0. Если это сообщение содержит всю систему монопольные данные для сообщения, это должно закончиться байтом состояния 0xF7 (EOX). Иначе, дополнительная система монопольные данные должна быть отправлена в один или больше SysexMessages со значением состояния 0xF7. SysexMessage содержа последние из данных для системы монопольное сообщение должно закончиться значением 0xF7 (EOX), чтобы отметить конец системы монопольное сообщение.

Если система монопольные данные от SysexMessages объекты передаются, используя протокол провода MIDI, только начальная буква 0xF0 байт состояния, система монопольные данные непосредственно, и финал 0xF7 (EOX) байт должен быть распространен; любые 0xF7 байты состояния, используемые, чтобы указать на это a SysexMessage содержит продолжающуюся систему, монопольные данные не должны быть распространены через протокол провода MIDI.

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	SPECIAL_SYSTEM_EXCLUSIVE Байт состояния для Специальной Системы Монопольное сообщение (0xF7, или 247), который используется в файлах MIDI.
static int	SYSTEM_EXCLUSIVE Байт состояния для Системы Монопольное сообщение (0xF0, или 240).

Поля, наследованные от class javax.sound.midi. MidiMessage

data, length

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
	SysexMessage() Создает новое SysexMessage.
protected	SysexMessage(byte[] data) Создает новое SysexMessage.
	SysexMessage(byte[] data, int length) Создает новое SysexMessage и устанавливает данные для сообщения.
	SysexMessage(int status, byte[] data, int length) Создает новое SysexMessage и устанавливает данные для сообщения.

Сводка метода

Модификатор и Тип	Метод и Описание
Объект	clone() Создает новый объект того же самого class и с тем же самым содержанием как этот объект.
byte[]	getData() Получает копию данных для системы монопольное сообщение.
void	setMessage(byte[] data, int length) Устанавливает данные для системы монопольное сообщение.
void	setMessage(int status, byte[] data, int length) Устанавливает данные для системы монопольное сообщение.

Методы, наследованные от class javax.sound.midi. MidiMessage

getLength, getMessage, getStatus

Методы, наследованные от class java.lang. Объект

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

SYSTEM_EXCLUSIVE

public static final int SYSTEM_EXCLUSIVE

Байт состояния для Системы Монопольное сообщение (0xF0, или 240).

См. Также:

MidiMessage.getStatus(), Постоянные Значения полей

SPECIAL_SYSTEM_EXCLUSIVE

public static final int SPECIAL_SYSTEM_EXCLUSIVE

Байт состояния для Специальной Системы Монопольное сообщение (0xF7, или 247), который используется в файлах MIDI. У этого есть то же самое значение как END_OF_EXCLUSIVE, который используется в "протоколе" провода MIDI в реальном времени.

См. Также:

MidiMessage.getStatus(), Постоянные Значения полей

Деталь конструктора

SysexMessage

public SysexMessage()

Создает новое SysexMessage. Содержание нового сообщения, как гарантируют, определит допустимое сообщение MIDI. Впоследствии, можно установить содержание сообщения, используя один из setMessage методы.

См. Также:

setMessage(byte[], int)

SysexMessage

public SysexMessage(byte[] data,
                    int length)
             throws InvalidMidiDataException

Создает новое SysexMessage и устанавливает данные для сообщения. Первый байт массива данных должен быть допустимой системой монопольный байт состояния (0xF0 или 0xF7). Содержание сообщения может быть изменено при использовании одного из setMessage методы.

Параметры:

data - система монопольные данные сообщения включая байт состояния

length - длина допустимых данных сообщения в массиве, включая байт состояния; это должно быть неотрицательным и меньше чем или равным data.length

Броски:

InvalidMidiDataException - если значения параметра не определяют допустимый MIDI meta сообщение.

С тех пор:

1.7

См. Также:

setMessage(byte[], int), setMessage(int, byte[], int), getData()

SysexMessage

public SysexMessage(int status,
                    byte[] data,
                    int length)
             throws InvalidMidiDataException

Создает новое SysexMessage и устанавливает данные для сообщения. Содержание сообщения может быть изменено при использовании одного из setMessage методы.

Параметры:

status - байт состояния для сообщения; это должна быть допустимая система монопольный байт состояния (0xF0 или 0xF7)

data - система монопольные данные сообщения (без байта состояния)

length - длина допустимых данных сообщения в массиве; это должно быть неотрицательным и меньше чем или равным data.length

Броски:

InvalidMidiDataException - если значения параметра не определяют допустимый MIDI meta сообщение.

С тех пор:

1.7

См. Также:

setMessage(byte[], int), setMessage(int, byte[], int), getData()

SysexMessage

protected SysexMessage(byte[] data)

Создает новое SysexMessage.

Параметры:

data - массив байтов, содержащих полное сообщение. Данные сообщения могут быть изменены, используя setMessage метод.

См. Также:

setMessage(byte[], int)

Деталь метода

setMessage

public void setMessage(byte[] data,
                       int length)
                throws InvalidMidiDataException

Устанавливает данные для системы монопольное сообщение. Первый байт массива данных должен быть допустимой системой монопольный байт состояния (0xF0 или 0xF7).

Переопределения:

setMessage в class MidiMessage

Параметры:

data - система монопольные данные сообщения

length - длина допустимых данных сообщения в массиве, включая байт состояния.

Броски:

InvalidMidiDataException

setMessage

public void setMessage(int status,
                       byte[] data,
                       int length)
                throws InvalidMidiDataException

Устанавливает данные для системы монопольное сообщение.

Параметры:

status - байт состояния для сообщения (0xF0 или 0xF7)

data - система монопольные данные сообщения

length - длина допустимых данных сообщения в массиве

Броски:

InvalidMidiDataException

getData

public byte[] getData()

Получает копию данных для системы монопольное сообщение. Возвращенный массив байтов не включает байт состояния.

Возвраты:

массив, содержащий систему монопольные данные сообщения.

клон

public Object clone()

Создает новый объект того же самого class и с тем же самым содержанием как этот объект.

Определенный:

clone в class MidiMessage

Возвраты:

клон этого экземпляра

См. Также:

Cloneable