javax.sound.midi

Class MetaMessage

java.lang.Object

javax.sound.midi.MidiMessage

javax.sound.midi.MetaMessage

All Implemented Interfaces:

Cloneable

public class MetaMessage
extends MidiMessage

一个 MetaMessage是 MidiMessage不是意义的合成器，但可以存储在一个MIDI文件和一个序列程序解释。（看在 MidiMessage类描述。讨论）标准MIDI文件规范定义了各种类型的元事件，如序列号、抒情，提示点，并设置节奏。也有元事件信息的歌词，版权，节奏的迹象，时间和关键特征，标记，等更多的信息，参见标准MIDI文件1规范，这是完整的MIDI 1详细规范由MIDI制造商协会公布的部分（ http://www.midi.org）。

当数据被使用MIDI线协议传输，一个状态值0xFF ShortMessage代表一个系统复位消息。在MIDI文件中，这一状态值表示一个MetaMessage。元信息的类型区分开来的第一个字节为状态字节0xFF后续字节数据的字节数。随着系统的独家消息，有任意数量的数据字节，取决于MetaMessage类型。

另请参见：

MetaEventListener

Field Summary

Fields

Modifier and Type	Field and Description
static int	META 对于 MetaMessage状态字节（0xFF，或255），这是用于MIDI文件。

Fields inherited from class javax.sound.midi.MidiMessage

data, length

构造方法摘要

构造方法

Modifier	Constructor and Description
	MetaMessage() 构建了一种新的 MetaMessage。
protected	MetaMessage(byte[] data) 构建了一种新的 MetaMessage。
	MetaMessage(int type, byte[] data, int length) 构建了一种新的 MetaMessage和设置消息参数。

方法摘要

Modifier and Type	Method and Description
Object	clone() 创建同一个类的新对象，并具有与此对象相同的内容。
byte[]	getData() 获取元数据的数据的副本。
int	getType() 得到的 MetaMessage类型。
void	setMessage(int type, byte[] data, int length) 设置一个 MetaMessage消息参数。

Methods inherited from class javax.sound.midi.MidiMessage

getLength, getMessage, getStatus, setMessage

Methods inherited from class java.lang.Object

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

Field Detail

META

public static final int META

对于 MetaMessage状态字节（0xFF，或255），这是用于MIDI文件。它具有system_reset相同的值，用于在实时MIDI线”协议。

另请参见：

MidiMessage.getStatus()， Constant Field Values

Constructor Detail

MetaMessage

public MetaMessage()

构建了一种新的 MetaMessage。消息的内容不在这里设置；使用 setMessage设置他们随后。

MetaMessage

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

构建了一种新的 MetaMessage和设置消息参数。短信的内容可以用 setMessage方法改变。

参数

type元消息类型（必须小于128）

data在MIDI消息的数据字节

length在 data字节数组的字节数量；它应该是非负且小于或等于 data.length

异常

InvalidMidiDataException -如果参数值没有指定一个有效的MIDI的元信息

从以下版本开始：

一点七

另请参见：

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

MetaMessage

protected MetaMessage(byte[] data)

构建了一种新的 MetaMessage。

参数

data -包含完整的信息的字节数组。消息数据可以使用 setMessage方法改变。

另请参见：

setMessage(int, byte[], int)

方法详细信息

setMessage

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

设置一个 MetaMessage消息参数。由于只有一个状态字节的值， 0xFF，允许的元信息，它不需要在这里指定。呼吁所有的元信息 getStatus返回 0xFF。

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

参数

type元消息类型（必须小于128）

data在MIDI消息的数据字节

length data字节数组中的字节数

异常

InvalidMidiDataException -如果参数值没有指定一个有效的MIDI的元信息

getType

public int getType()

得到的 MetaMessage类型。

结果

代表 MetaMessage型整数

getData

public byte[] getData()

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

结果

包含元数据数据的数组。

另请参见：

MidiMessage.getLength()

clone

public Object clone()

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

Specified by:

clone 方法重写，继承类 MidiMessage

结果

这个实例的克隆

另请参见：

Cloneable