javax.sound.midi
类 SysexMessage

java.lang.Object
  javax.sound.midi.MidiMessage
      javax.sound.midi.SysexMessage

所有已实现的接口：

Cloneable

public class SysexMessage
     

      extends 
      MidiMessage
     

表示 MIDI 系统独占消息 SysexMessage 对象。

当从 MIDI 文件中读取系统独占消息时，它通常具有已定义的长度。取自 MIDI 文件的系统独占消息的数据应存储在 SysexMessage 的数据数组中，如下所示：系统独占消息状态字节（0xF0 或 0xF7），所有消息数据字节和最后的独占结束标志 (0xF7)。因此，SysexMessage 对象报告的长度为系统独占数据的长度加上两个字节：一个字节为状态字节，另一个为独占结束标志。

按照 Standard MIDI Files 规范的规定，有两个状态字节值对于从 MIDI 文件读取的 SysexMessage 是合法的：

• 0xF0:系统独占消息（与 MIDI 导线协议相同）
• 0xF7:特殊系统独占消息

当使用 Java Sound 处理通过 MIDI 导线协议接收的系统独占数据时，它应将数据置于一个或多个 SysexMessage 中。在这种情况下，预先不知道系统独占数据的长度；系统独占数据的结束由 MIDI 导线字节流中的一个独占结束标志 (0xF7) 所标记。

• 0xF0:系统独占消息（与 MIDI 导线协议相同）
• 0xF7:独占结束 (EOX)

如果使用 MIDI 导线协议传输取自 SysexMessage 对象的系统独占数据，则只有初始 0xF0 状态字节、系统独占数据本身和最终的 0xF7 (EOX) 字节应该被传播；任何用于指示 SysexMessage 包含连续系统独占数据的 0xF7 状态字节都不应该通过 MIDI 导线协议被传播。

SYSTEM_EXCLUSIVE

public static final int SYSTEM_EXCLUSIVE

用于 SYSTEM_EXCLUSIVE 消息的状态字节（0xF0 或 240）。

另请参见：

MidiMessage.getStatus(), 常量字段值

SPECIAL_SYSTEM_EXCLUSIVE

public static final int SPECIAL_SYSTEM_EXCLUSIVE

用于 SPECIAL_SYSTEM_EXCLUSIVE 消息的状态字节（0xF7 或 247），供在 MIDI 文件中使用。它与 END_OF_EXCLUSIVE 具有相同的值，用于实时 "MIDI wire" 协议中。

另请参见：

MidiMessage.getStatus(), 常量字段值

SysexMessage

public SysexMessage()

构造一个新的 SysexMessage。可保证新消息的内容指定一个有效的 MIDI 消息。之后，可以使用 setMessage 方法之一来设置消息的内容。

另请参见：

setMessage(byte[], int)

SysexMessage

protected SysexMessage(byte[] data)

构造一个新的 SysexMessage。

参数：

data - 包含完整消息的 byte 数组。使用 setMessage 方法可更改消息数据。

另请参见：

setMessage(byte[], int)

setMessage

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

为系统独占消息设置数据。数据数组的第一个字节必须是一个有效的系统独占状态字节（0xF0 或 0xF7）。

覆盖：

类 MidiMessage 中的 setMessage

参数：

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()

获得系统独占消息数据的副本。返回的 byte 数组不包括状态字节。

返回：

包含系统独占消息数据的数组。

clone

public Object clone()

创建一个与此对象具有相同类和相同内容的新对象。

指定者：

类 MidiMessage 中的 clone

返回：

此实例的一个副本。

另请参见：

Cloneable