ShortMessage (Java Platform SE 8 )

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

All Implemented Interfaces:

Cloneable
```
public class ShortMessage
extends MidiMessage
```
一个 ShortMessage包含MIDI消息，最多有两个数据字节后，状态字节。该类型的MIDI消息满足这一标准的信道的声音，渠道模式，系统，和系统的实时性，换句话说，除了系统专有和元事件。的 ShortMessage类提供了用于获取和设置MIDI消息内容的方法。
一些ShortMessage方法有整数参数由你指定一个MIDI状态或数据字节。如果你知道数字值，你可以直接表达。系统常见的系统实时信息，你可以经常使用ShortMessage相应的字段，如SYSTEM_RESET。渠道消息的状态字节的高四位的指令值和低四位指定的MIDI通道指定的号码。将输入的MIDI数据字节，在java的签名字节的形式，你可以使用在MidiMessage类描述了conversion code。

另请参见：

SysexMessage， MetaMessage

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ACTIVE_SENSING` 主动遥感信息状态字节（0XFE，或254）。
`static int`	`CHANNEL_PRESSURE` 通道压力指令值（触）消息（0xd0，或208）
`static int`	`CONTINUE` 状态字节继续消息（0xfb，或251）。
`static int`	`CONTROL_CHANGE` 控制改变信息指令值（0xb0，或176）
`static int`	`END_OF_EXCLUSIVE` 端系统专有信息状态字节（0xf7，或247）。
`static int`	`MIDI_TIME_CODE` MIDI时间码分帧的信息状态字节（0xf1，或241）。
`static int`	`NOTE_OFF` 请注意关闭消息的命令值（0x80，或128）
`static int`	`NOTE_ON` 对消息的注释命令值（0x90，或144）
`static int`	`PITCH_BEND` 对于弯消息命令值（0xE0，或224）
`static int`	`POLY_PRESSURE` 复调关键压力指令值（触）消息（0xA0，或160）
`static int`	`PROGRAM_CHANGE` 程序更改消息命令值（0xC0，或192）
`static int`	`SONG_POSITION_POINTER` 歌曲位置指针信息状态字节（0xf2，或242）。
`static int`	`SONG_SELECT` 状态字节的MIDI歌曲选择消息（0xf3，或243）。
`static int`	`START` 启动消息状态字节（0xfa，或250）。
`static int`	`STOP` 停止消息状态字节（0xfc，或252）。
`static int`	`SYSTEM_RESET` 系统的复位消息状态字节（0xFF，或255）。
`static int`	`TIMING_CLOCK` 定时时钟信息状态字节（0xf8，或248）。
`static int`	`TUNE_REQUEST` 用于调整请求消息状态字节（0xf6，或246）。

Fields inherited from class javax.sound.midi.MidiMessage
data, length

构造方法摘要

构造方法
Modifier	Constructor and Description
	`ShortMessage()` 构建了一种新的 `ShortMessage`。
`protected`	`ShortMessage(byte[] data)` 构建了一种新的 `ShortMessage`。
	`ShortMessage(int status)` 构建了一种新的 `ShortMessage`代表的MIDI信息，不需要数据字节。
	`ShortMessage(int status, int data1, int data2)` 构建了一种新的 `ShortMessage`代表的MIDI信息，需要两个数据字节。
	`ShortMessage(int command, int channel, int data1, int data2)` 构建了一种新的 `ShortMessage`代表一个通道的MIDI消息，需要两个数据字节。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Object`	`clone()` 创建同一个类的新对象，并具有与此对象相同的内容。
`int`	`getChannel()` 获取与此事件相关的MIDI通道。
`int`	`getCommand()` 获取与此事件相关的MIDI命令。
`int`	`getData1()` 在消息中获得第一个数据字节。
`int`	`getData2()` 在消息中获得第二个数据字节。
`protected int`	`getDataLength(int status)` 检索与特定状态字节值关联的数据字节数。
`void`	`setMessage(int status)` 设置MIDI消息不需要数据的字节数的参数。
`void`	`setMessage(int status, int data1, int data2)` 设置MIDI信息以一个或两个数据字节的参数。
`void`	`setMessage(int command, int channel, int data1, int data2)` 设置一个需要两个数据字节的信道消息的短消息参数。

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
  - MIDI_TIME_CODE
```
public static final int MIDI_TIME_CODE
```
    MIDI时间码分帧的信息状态字节（0xf1，或241）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - SONG_POSITION_POINTER
```
public static final int SONG_POSITION_POINTER
```
    歌曲位置指针信息状态字节（0xf2，或242）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - SONG_SELECT
```
public static final int SONG_SELECT
```
    状态字节的MIDI歌曲选择消息（0xf3，或243）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - TUNE_REQUEST
```
public static final int TUNE_REQUEST
```
    用于调整请求消息状态字节（0xf6，或246）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - END_OF_EXCLUSIVE
```
public static final int END_OF_EXCLUSIVE
```
    端系统专有信息状态字节（0xf7，或247）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - TIMING_CLOCK
```
public static final int TIMING_CLOCK
```
    定时时钟信息状态字节（0xf8，或248）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - START
```
public static final int START
```
    启动消息状态字节（0xfa，或250）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - CONTINUE
```
public static final int CONTINUE
```
    状态字节继续消息（0xfb，或251）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - STOP
```
public static final int STOP
```
    停止消息状态字节（0xfc，或252）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - ACTIVE_SENSING
```
public static final int ACTIVE_SENSING
```
    主动遥感信息状态字节（0XFE，或254）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - SYSTEM_RESET
```
public static final int SYSTEM_RESET
```
    系统的复位消息状态字节（0xFF，或255）。
    
    另请参见：
    
    MidiMessage.getStatus()， Constant Field Values
  - NOTE_OFF
```
public static final int NOTE_OFF
```
    请注意关闭消息的命令值（0x80，或128）
    
    另请参见：
    
    Constant Field Values
  - NOTE_ON
```
public static final int NOTE_ON
```
    对消息的注释命令值（0x90，或144）
    
    另请参见：
    
    Constant Field Values
  - POLY_PRESSURE
```
public static final int POLY_PRESSURE
```
    复调关键压力指令值（触）消息（0xA0，或160）
    
    另请参见：
    
    Constant Field Values
  - CONTROL_CHANGE
```
public static final int CONTROL_CHANGE
```
    控制改变信息指令值（0xb0，或176）
    
    另请参见：
    
    Constant Field Values
  - PROGRAM_CHANGE
```
public static final int PROGRAM_CHANGE
```
    程序更改消息命令值（0xC0，或192）
    
    另请参见：
    
    Constant Field Values
  - CHANNEL_PRESSURE
```
public static final int CHANNEL_PRESSURE
```
    通道压力指令值（触）消息（0xd0，或208）
    
    另请参见：
    
    Constant Field Values
  - PITCH_BEND
```
public static final int PITCH_BEND
```
    对于弯消息命令值（0xE0，或224）
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - ShortMessage
```
public ShortMessage()
```
    构建了一种新的 ShortMessage。该消息的内容是保证指定一个有效的MIDI消息。随后，您可以设定消息内容的使用 setMessage方法。
    
    另请参见：
    
    setMessage(int)
  - ShortMessage
```
public ShortMessage(int status)
             throws InvalidMidiDataException
```
    构建了一种新的 ShortMessage代表的MIDI信息，不需要数据字节。短信的内容可以用一个 setMessage方法改变的。
    
    参数
    
    status - MIDI状态字节
    
    异常
    
    InvalidMidiDataException -如果 status不指定一个消息：不需要数据字节有效MIDI状态字节
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    setMessage(int)， setMessage(int, int, int)， setMessage(int, int, int, int)， MidiMessage.getStatus()
  - ShortMessage
```
public ShortMessage(int status,
                    int data1,
                    int data2)
             throws InvalidMidiDataException
```
    构建了一种新的 ShortMessage代表的MIDI信息，需要两个数据字节。如果消息只需要一个数据字节，则忽略第二个数据字节。如果消息不需要任何数据字节，则忽略两个数据字节数。短信的内容可以用一个 setMessage方法改变的。
    
    参数
    
    status - MIDI状态字节
    
    data1 -第一个数据字节
    
    data2 -第二数据字节
    
    异常
    
    InvalidMidiDataException如果状态字节或数据字节属于消息不指定一个有效的MIDI消息
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    setMessage(int)， setMessage(int, int, int)， setMessage(int, int, int, int)， MidiMessage.getStatus()， getData1()， getData2()
  - ShortMessage
```
public ShortMessage(int command,
                    int channel,
                    int data1,
                    int data2)
             throws InvalidMidiDataException
```
    构建了一种新的 ShortMessage代表一个通道的MIDI消息，需要两个数据字节。如果消息只需要一个数据字节，则忽略第二个数据字节。如果消息不需要任何数据字节，则忽略两个数据字节数。短信的内容可以用一个 setMessage方法改变的。
    
    参数
    
    command -这个消息表示的MIDI命令
    
    channel -通道与消息
    
    data1 -第一个数据字节
    
    data2 -第二数据字节
    
    异常
    
    InvalidMidiDataException -如果命令价值、渠道价值和所有的数据字节属于消息不指定一个有效的MIDI消息
    
    从以下版本开始：
    
    一点七
    
    另请参见：
    
    setMessage(int)， setMessage(int, int, int)， setMessage(int, int, int, int)， getCommand()， getChannel()， getData1()， getData2()
  - ShortMessage
```
protected ShortMessage(byte[] data)
```
    构建了一种新的 ShortMessage。
    
    参数
    
    data -包含完整的信息的字节数组。消息数据可以使用 setMessage方法改变。
    
    另请参见：
    
    setMessage(int)
- 方法详细信息
  - setMessage
```
public void setMessage(int status)
                throws InvalidMidiDataException
```
    设置MIDI消息不需要数据的字节数的参数。
    
    参数
    
    status - MIDI状态字节
    
    异常
    
    InvalidMidiDataException -如果 status不指定一个消息：不需要数据字节有效MIDI状态字节。
    
    另请参见：
    
    setMessage(int, int, int)， setMessage(int, int, int, int)
  - setMessage
```
public void setMessage(int status,
                       int data1,
                       int data2)
                throws InvalidMidiDataException
```
    设置MIDI信息以一个或两个数据字节的参数。如果消息只需要一个数据字节，第二个数据字节将被忽略；如果消息不采取任何数据字节，这两个数据字节将被忽略。
    
    参数
    
    status - MIDI状态字节
    
    data1 -第一个数据字节
    
    data2 -第二数据字节
    
    异常
    
    InvalidMidiDataException如果状态字节或字节的数据，都属于信息，不指定一个有效的MIDI消息。
    
    另请参见：
    
    setMessage(int, int, int, int)， setMessage(int)
  - setMessage
```
public void setMessage(int command,
                       int channel,
                       int data1,
                       int data2)
                throws InvalidMidiDataException
```
    设置一个需要两个数据字节的信道消息的短消息参数。如果消息只需要一个数据字节，第二个数据字节将被忽略；如果消息不采取任何数据字节，这两个数据字节将被忽略。
    
    参数
    
    command -这个消息表示的MIDI命令
    
    channel -通道与消息
    
    data1 -第一个数据字节
    
    data2 -第二数据字节
    
    异常
    
    InvalidMidiDataException如果状态字节或字节的数据属于信息，不指定一个有效的MIDI消息
    
    另请参见：
    
    setMessage(int, int, int)， setMessage(int)， getCommand()， getChannel()， getData1()， getData2()
  - getChannel
```
public int getChannel()
```
    获取与此事件相关的MIDI通道。这种方法假设的事件是一个MIDI通道的信息；如果没有，则返回值是没有意义的。
    
    结果
    
    MIDI通道相关的消息。
    
    另请参见：
    
    setMessage(int, int, int, int)
  - getCommand
```
public int getCommand()
```
    获取与此事件相关的MIDI命令。这种方法假设的事件是一个MIDI通道的信息；如果没有，则返回值是没有意义的。
    
    结果
    
    与此事件相关的MIDI命令
    
    另请参见：
    
    setMessage(int, int, int, int)
  - getData1
```
public int getData1()
```
    在消息中获得第一个数据字节。
    
    结果
    
    该 data1字段的值
    
    另请参见：
    
    setMessage(int, int, int)
  - getData2
```
public int getData2()
```
    在消息中获得第二个数据字节。
    
    结果
    
    该 data2字段的值
    
    另请参见：
    
    setMessage(int, int, int)
  - clone
```
public Object clone()
```
    创建同一个类的新对象，并具有与此对象相同的内容。
    
    Specified by:
    
    clone 方法重写，继承类 MidiMessage
    
    结果
    
    这个实例的克隆。
    
    另请参见：
    
    Cloneable
  - getDataLength
```
protected final int getDataLength(int status)
                           throws InvalidMidiDataException
```
    检索与特定状态字节值关联的数据字节数。
    
    参数
    
    status状态字节的值，它必须代表一个MIDI短消息
    
    结果
    
    字节长度（0，1，或2）
    
    异常
    
    InvalidMidiDataException -如果 status论点不代表任何短消息状态字节

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ShortMessage

Field Summary

Fields inherited from class javax.sound.midi.MidiMessage

构造方法摘要

方法摘要

Methods inherited from class javax.sound.midi.MidiMessage

Methods inherited from class java.lang.Object

Field Detail

MIDI_TIME_CODE

SONG_POSITION_POINTER

SONG_SELECT

TUNE_REQUEST

END_OF_EXCLUSIVE

TIMING_CLOCK

START

CONTINUE

STOP

ACTIVE_SENSING

SYSTEM_RESET

NOTE_OFF

NOTE_ON

POLY_PRESSURE

CONTROL_CHANGE

PROGRAM_CHANGE

CHANNEL_PRESSURE

PITCH_BEND

Constructor Detail

ShortMessage

ShortMessage

ShortMessage

ShortMessage

ShortMessage

方法详细信息

setMessage

setMessage

setMessage

getChannel

getCommand

getData1

getData2

clone

getDataLength