javax.sound.midi

Class MidiMessage

java.lang.Object

javax.sound.midi.MidiMessage

All Implemented Interfaces:

Cloneable

已知直接子类：

MetaMessage， ShortMessage， SysexMessage

public abstract class MidiMessage
extends Object
implements Cloneable

MidiMessage是MIDI消息的基类。他们不仅包括标准的MIDI消息，合成器可以回应，而且“元事件”可以通过音序器程序使用。有元事件信息的歌词，版权，节奏的迹象，时间和关键特征，标记，等更多的信息，参见标准MIDI文件1规范，这是完整的MIDI 1详细规范由MIDI制造商协会公布的部分（ http://www.midi.org）。

基地MidiMessage类提供了三种有关MIDI消息的信息：

• 消息的状态字节
• 消息的总长度（状态字节加上任何数据字节）
• 一个包含完整消息的字节数组

MidiMessage包括方法得到，但没有设置，这些值。设置他们是一个子类的责任。

MIDI标准表示MIDI数据的字节数。然而，因为java^TM使用签名字节，java语音API使用整数而不是字节表示MIDI数据时。例如，返回的MidiMessage MIDI状态字节getStatus()方法为整数。如果你正在处理MIDI数据起源以外的声音现在java编码为符号字节，字节可以被转换为使用此转换整数：

int i = (int)(byte & 0xFF)

如果你只需要通过一个已知的MIDI字节值作为方法的参数，可以直接表达为一个整数，使用（例如）的十进制或十六进制记数法。例如，通过“主动感知”作为短信的setMessage(int)方法的第一个参数状态字节，你可以为254或0XFE表示。

另请参见：

Track， Sequence， Receiver

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	data MIDI消息数据。
protected int	length 在MIDI消息的字节数，包括任何数据的字节状态字节。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	MidiMessage(byte[] data) 构建了一种新的 MidiMessage。

方法摘要

Modifier and Type	Method and Description
abstract Object	clone() 创建同一个类的新对象，并具有与此对象相同的内容。
int	getLength() 得出在字节的MIDI消息的总长度。
byte[]	getMessage() 得到的MIDI消息数据。
int	getStatus() 得到的MIDI消息的状态字节。
protected void	setMessage(byte[] data, int length) 设置MIDI消息的数据。

Methods inherited from class java.lang.Object

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

Field Detail

data

protected byte[] data

MIDI消息数据。第一个字节是消息的状态字节；随后的字节到消息的长度是这个消息的数据字节。

另请参见：

getLength()

length

protected int length

在MIDI消息的字节数，包括任何数据的字节状态字节。

另请参见：

getLength()

Constructor Detail

MidiMessage

protected MidiMessage(byte[] data)

构建了一种新的 MidiMessage。这个受保护的构造函数被调用的具体的子类，这应确保数据数组指定一个完整的、有效的MIDI消息。

参数

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

另请参见：

setMessage(byte[], int)

方法详细信息

setMessage

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

设置MIDI消息的数据。这种保护方法被具体的子类，这应确保数据数组指定一个完整的、有效的MIDI消息。

参数

data在MIDI消息的数据字节

length数据字节数组中的字节数

异常

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

getMessage

public byte[] getMessage()

得到的MIDI消息数据。返回的字节数组的第一个字节是消息的状态字节。任何随后的字节到消息的长度都是数据字节。字节数组可能长度大于实际的消息；消息的字节总长度由 getLength()报道方法。

结果

包含完整的 MidiMessage数据的字节数组

getStatus

public int getStatus()

得到的MIDI消息的状态字节。状态“字节”是表示为一个整数；看到在 MidiMessage类描述的 discussion。

结果

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

getLength

public int getLength()

得出在字节的MIDI消息的总长度。MIDI消息包含一个状态字节和零个或多个数据字节。返回值范围从1系统实时消息，到2或3的信道消息，到任何值的元和系统的独家消息。

结果

消息的长度以字节为单位

clone

public abstract Object clone()

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

重写：

clone 方法重写，继承类 Object

结果

这个实例的克隆。

另请参见：

Cloneable