Java javax.sound.midi 类 MetaMessage（JDK5）

所有类

javax.sound.midi
类 MetaMessage

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

所有已实现的接口：

Cloneable

public class MetaMessage
   
   
   
   
   
extends MidiMessage
   
   
   
   
   

MetaMessage 是一个 MidiMessage，它对于合成器没有任何意义，但可存储在一个 MIDI 文件中然后由 sequencer 程序解释。（请参阅 MidiMessage 类描述中的论述。）Standard MIDI Files 规范定义了各种元事件类型，例如序列号、歌词、提示点和设置的速度。还有针对类似歌词、版权、速度指示、时间和主要签名、制造者等信息的元事件。有关更多的信息，请参见 Standard MIDI Files 1.0 规范，它是由 MIDI 制造商协会 (http://www.midi.org) 发布的 Complete MIDI 1.0 Detailed Specification 的一部分。

使用 MIDI wire 协议传输数据时，ShortMessage 带状态值 0xFF 表示系统重置消息。在 MIDI 文件中，此相同的状态值表示 MetaMessage。各个元消息类型通过状态字节 0xFF 后面的第一个字节进行区分。后续的字节是数据字节。与系统独占消息相同，其中还有任意个数据字节，具体取决于 MetaMessage 的类型。

另请参见：

MetaEventListener

META

public static final int META

MetaMessage 的状态字节（0xFF 或 255），供在 MIDI 文件中使用。它与 SYSTEM_RESET 具有相同的值，用于实时 "MIDI wire" 协议中。

另请参见：

MidiMessage.getStatus(), 常量字段值

MetaMessage

public MetaMessage()

构造一个新的 MetaMessage。在此不设置消息的内容；可随后使用 setMessage 对其进行设置。

MetaMessage

protected MetaMessage(byte[] data)

构造一个新的 MetaMessage。

参数：

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

另请参见：

setMessage(int, byte[], int)

setMessage

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

为 MetaMessage 设置消息参数。由于元消息只允许有一个状态字节值 0xFF，因此在这里不需要对其进行指定。对于所有的元消息，调用 getStatus 都返回 0xFF。

type 参数应该是一个 MetaMessage 中的状态字节后的 byte 有效值。data 参数应包含 MetaMessage 的所有后续字节。换句话说，不将指定 MetaMessage 类型的字节认为是数据字节。

参数：

type - 元消息类型（不超过 128）

data - MIDI 消息中的数据字节

length - data byte 数组中的字节数

抛出：

InvalidMidiDataException - 如果参数值未指定有效的 MIDI 元消息

InvalidMidiDataException

getType

public int getType()

获得 MetaMessage 的类型。

返回：

一个表示 MetaMessage 类型的整数

getData

public byte[] getData()

获得元消息数据的副本。返回的 byte 数组不包括状态字节或消息长度数据。元消息的数据长度就是数组的长度。注意，整个消息的长度包括了状态字节和元消息类型字节，因此可能比返回的数组更长。

返回：

包含元消息数据的数组。

另请参见：

MidiMessage.getLength()

clone

public Object clone()

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

指定者：

类 MidiMessage 中的 clone

返回：

此实例的一个副本。

另请参见：

Cloneable