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) である必要があります。

オーバーライド:

クラス MidiMessage 内の setMessage

パラメータ:

data - システムエクスクルーシブメッセージのデータ

length - ステータスバイトなどの、配列内の有効なメッセージデータの長さ

setMessage

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

システムエクスクルーシブメッセージのデータを設定します。

パラメータ:

status - メッセージのステータスバイト (0xF0 または 0xF7)

data - システムエクスクルーシブメッセージのデータ

length - 配列内の有効なメッセージデータの長さ

getData

public byte[] getData()

システムエクスクルーシブメッセージのデータのコピーを取得します。返されるバイトの配列に、ステータスバイトは含まれません。

戻り値:

システムエクスクルーシブメッセージデータを含む配列

clone

public Object clone()

このオブジェクトとクラスおよび内容が同じ新しいオブジェクトを作成します。

オーバーライド:

クラス MidiMessage 内の clone

戻り値:

このインスタンスの複製