javax.sound.midi
类 MidiMessage

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

所有已实现的接口：

Cloneable

直接已知子类：

MetaMessage, ShortMessage, SysexMessage

public abstract class MidiMessage
extends Object
implements Cloneable

MidiMessage 是 MIDI 消息的基类。这些基类中不仅包含了合成器可响应的标准 MIDI 消息，还包含可供 sequencer 程序使用的“元事件”。还有针对类似歌词、版权、速度指示、时间和主要签名、制造者等信息的元事件。有关更多的信息，请参见 Standard MIDI Files 1.0 规范，它是由 MIDI 制造商协会 (http://www.midi.org) 发布的 Complete MIDI 1.0 Detailed Specification 的一部分。

MidiMessage 基类提供了对有关 MIDI 消息的三类信息的访问：

• 消息的状态字节
• 消息的总长度，以字节为单位（状态字节加数据字节）
• 包含完整消息的 byte 数组

MIDI 标准用字节表示 MIDI 数据。但是，由于 Java^TM 使用带符号字节，所以 Java Sound API 表示 MIDI 数据时使用整数而不是字节。例如，MidiMessage 的 getStatus() 方法返回用整数表示的 MIDI 状态字节。如果处理来源于 Java Sound 之外的 MIDI 数据，而现在又编码为带符号字节，可使用以下转换将字节转换为整数：

如果只需要将一个已知 MIDI 字节值作为方法参数传递，则可使用（例如）十进制或十六进制符号直接将其表示为整数。例如，要传递“实际有意义的”状态字节作为 ShortMessage 的 setMessage(int) 方法的第一个参数，您可以将其表示为 254 或 0xFE。

另请参见：

Track, Sequence, Receiver

data

protected byte[] data

MIDI 消息数据。第一个字节是消息的状态字节；后面一直到消息长度字节为止的是此消息的数据字节。

另请参见：

getLength()

length

protected int length

MIDI 消息中的字节数，包括状态字节和数据字节。

另请参见：

getLength()

MidiMessage

protected MidiMessage(byte[] data)

构造一个新的 MidiMessage。此受保护的构造方法由具体子类调用，具体子类应确保数据数组指定一个完整有效的 MIDI 消息。

参数：

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

另请参见：

setMessage(byte[], int)

setMessage

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

为 MIDI 消息设置数据。此受保护的方法由具体子类调用，具体子类应确保数据数组指定一个完整有效的 MIDI 消息。

抛出：

InvalidMidiDataException

getMessage

public byte[] getMessage()

获得 MIDI 消息数据。返回的 byte 数组中的第一个字节是消息的状态字节。后面一直到消息长度字节为止的是数据字节。byte 数组的长度可能会大于实际消息的长度；消息总长度（以字节为单位）由 getLength() 方法报告。

返回：

包含完整的 MidiMessage 数据的 byte 数组

getStatus

public int getStatus()

获得 MIDI 消息的状态字节。以整数方式表示状态“字节”；请参见 MidiMessage 类描述中的讨论。

返回：

此事件的状态字节的整数表示形式

getLength

public int getLength()

获得 MIDI 消息的总长度，以字节为单位。一个 MIDI 消息包含一个状态字节和零个或多个数据字节。返回值的范围：系统实时消息为 1，通道消息为 2 或 3，元和系统独占消息为任意值。

返回：

消息的长度，以字节为单位

clone

public abstract Object clone()

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

覆盖：

类 Object 中的 clone

返回：

此实例的一个副本。

另请参见：

Cloneable

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。