javax.sound.midi
클래스 SysexMessage

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

모든 구현된 인터페이스:

Cloneable

public class SysexMessage
extends MidiMessage 

SysexMessage객체는 MIDI 시스템에크스크루시브멧세이지를 나타냅니다.

MIDI 파일로부터 읽히는 시스템에크스크루시브멧세이지에는 반드시 길이가 정의되고 있습니다. MIDI 파일로부터 읽어들이는 시스템에크스크루시브멧세이지의 데이터는 시스템에크스크루시브멧세이지스테이타스바이트 (0xF0 또는 0xF7), 모든 메세지 데이터 바이트, 마지막에 엔드오브에크스크루시브후라그 (0xF7)의 순서에 SysexMessage 데이터 배열에 포함됩니다. 그 때문에 SysexMessage 객체가 보고하는 길이는 시스템에크스크루시브데이타의 길이에 스테이터스 바이트의 1 바이트와 엔드오브에크스크루시브후라그의 1 바이트의 합계 2 바이트를 더한 길이가 됩니다.

표준 MIDI 파일 사양의 규정에서는 MIDI 파일로부터 읽히는 SysexMessage 스테이터스 바이트의 정당한 값에는 다음의 2개가 있습니다.

• 0xF0: 시스템에크스크루시브멧세이지 (MIDI와이어 프로토콜에서의 경우와 같다)
• 0xF7: 특별한 시스템에크스크루시브멧세이지

MIDI와이어 프로토콜을 사용해 수신된 시스템에크스크루시브데이타가 Java Sound에 의해 처리되면, 데이터는 1개 이상의 SysexMessages에 배치됩니다. 이 경우 시스템에크스크루시브데이타의 길이는 사전에는 모릅니다. 시스템에크스크루시브데이타의 마지막은 MIDI와이어 바이트 스트림의 엔드오브에크스크루시브후라그 (0xF7)로 표현되고 있습니다.

• 0xF0: 시스템에크스크루시브멧세이지 (MIDI와이어 프로토콜에서의 경우와 같다)
• 0xF7: 엔드오브에크스크루시브 (EOX)

특정의 시스템에크스크루시브멧세이지의 데이터를 거둔 최초의 SysexMessage객체는 상태값이 0xF0 입니다. 이 메세지에 그 모든 시스템에크스크루시브데이타가 포함되어 있는 경우, 그 말미는 스테이터스 바이트 0xF7 (EOX)입니다. 포함되지 않은 시스템에크스크루시브데이타가 있는 경우는 상태값이 0xF7 1개 이상의 SysexMessages로 추가의 시스템에크스크루시브데이타가 송신됩니다. 그 시스템에크스크루시브멧세이지의 데이터의 말미를 포함하고 있는 SysexMessage는 말미의 값이 시스템에크스크루시브멧세이지의 마지막을 나타내는 0xF7 (EOX)입니다.

SysexMessages 객체로부터의 시스템에크스크루시브데이타가 MIDI와이어 프로토콜로 전송 되는 경우는 선두의 0xF0 스테이터스 바이트, 시스템에크스크루시브데이타 자체 및 말미의 0xF7 (EOX) 바이트만이 송신됩니다. SysexMessage에 추가의 시스템에크스크루시브데이타가 포함되어 있는 것을 나타내는 0xF7 스테이터스 바이트는 MIDI와이어 프로토콜에서는 송신되지 않습니다.

필드 개요

static int	SPECIAL_SYSTEM_EXCLUSIVE MIDI 파일로 사용되는 특별한 시스템에크스크루시브멧세이지의 스테이터스 바이트입니다 (0xF7 또는 247).
static int	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

시스템에크스크루시브멧세이지의 스테이터스 바이트 (0xF0 또는 240)

관련 항목:

MidiMessage.getStatus(), 정수 필드값

SPECIAL_SYSTEM_EXCLUSIVE

public static final int SPECIAL_SYSTEM_EXCLUSIVE

MIDI 파일로 사용되는 특별한 시스템에크스크루시브멧세이지의 스테이터스 바이트입니다 (0xF7 또는 247). 이 값은 리얼타임 「MIDI와이어」프로토콜로 사용되는 END_OF_EXCLUSIVE와 같습니다.

관련 항목:

MidiMessage.getStatus(), 정수 필드값

생성자 상세

SysexMessage

public SysexMessage()

새로운 SysexMessage를 구축합니다. 새로운 메세지의 내용에는 유효한 MIDI 메세지가 지정되는 것이 보증됩니다. 구축 후에 메세지의 내용을 설정하려면, setMessage 메서드의 1개를 사용합니다.

관련 항목:

setMessage(byte[], int)

SysexMessage

protected SysexMessage(byte[] data)

새로운 SysexMessage를 구축합니다.

파라미터:

data - 상세한 메세지를 포함한 바이트의 배열. 메세지 데이터는 setMessage 메서드를 사용해 변경할 수 있는

관련 항목:

setMessage(byte[], int)

메서드의 상세

setMessage

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

시스템에크스크루시브멧세이지의 데이터를 설정합니다. 데이터 배열의 선두의 바이트는 유효한 시스템에크스크루시브스테이타스바이트 (0xF0 또는 0xF7)일 필요가 있습니다.

오버라이드(override):

클래스 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()

시스템에크스크루시브멧세이지의 데이터의 복사본을 취득합니다. 리턴된 바이트의 배열에 스테이터스 바이트는 포함되지 않습니다.

반환값:

시스템에크스크루시브멧세이지데이타를 포함한 배열

clone

public Object  clone()

이 객체와 같은 클래스에서 같은 내용의 새로운 객체를 작성합니다.

정의:

클래스 MidiMessage 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable