站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

SysexMessage (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 5.0
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

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 是合法的：

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

第一个包含用于特定系统独占消息数据的 SysexMessage 对象应有状态值 0xF0。如果此消息包含该消息的所有系统独占数据，则它应以状态字节 0xF7 (EOX) 结束。否则，应在一个或多个 SysexMessage 中发送其他的系统独占数据，状态值为 0xF7。包含系统独占消息最后数据的 SysexMessage 应以 0xF7 (EOX) 值结束，以标记系统独占消息的结束。

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

字段摘要
static int SPECIAL_SYSTEM_EXCLUSIVE
          用于 SPECIAL_SYSTEM_EXCLUSIVE 消息的状态字节（0xF7 或 247），供在 MIDI 文件中使用。
static int SYSTEM_EXCLUSIVE
          用于 SYSTEM_EXCLUSIVE 消息的状态字节（0xF0 或 240）。
 
从类 javax.sound.midi.MidiMessage 继承的字段
data, length
 
构造方法摘要
  SysexMessage()
          构造一个新的 SysexMessage。
protected SysexMessage(byte[] data)
          构造一个新的 SysexMessage。
 
方法摘要
 Object clone()
          创建一个与此对象具有相同类和相同内容的新对象。
 byte[] getData()
          获得系统独占消息数据的副本。
 void setMessage(byte[] data, int length)
          为系统独占消息设置数据。
 void setMessage(int status, byte[] data, int length)
          为系统独占消息设置数据。
 
从类 javax.sound.midi.MidiMessage 继承的方法
getLength, getMessage, getStatus
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

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
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 5.0
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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