javax.sound.midi
インタフェース MidiDevice

既知のサブインタフェースの一覧:

Sequencer, Synthesizer

public interface MidiDevice

MidiDevice は全 MIDI デバイスの基本インタフェースです。共通デバイスには、シンセサイザ、シーケンサ、MIDI 入力ポート、および MIDI 出力ポートが含まれます。MidiDevice は MIDI イベントのトランスミッタまたはレシーバ、あるいはその両方となります。このために、MidiDevice は通常、Transmitter または Receiver インタフェース (または両方) を実装しているか、あるいは実装しているオブジェクトにアクセスできます。

MidiDevice には、製造者情報などを提供する MidiDevice.Info オブジェクトが含まれます。

関連項目:

Synthesizer, Sequencer, MidiChannel.setMono(boolean)

内部クラスの概要

static class

MidiDevice.Info MidiDevice.Info オブジェクトは、デバイスの名前、製作会社名、説明テキストなど、MidiDevice に関連するデータを含んでいます。

メソッドの概要

void	close() デバイスを閉じ、使用していたシステムリソースをデバイスが解放することを示します。
MidiDevice.Info	getDeviceInfo() Java クラスと、名前、ベンダーおよび説明などの Strings を含む、デバイスに関する情報を取得します。
int	getMaxReceivers() この MIDI デバイスで MIDI データを受信するのに使用可能な MIDI IN 接続の最大数を取得します。
int	getMaxTransmitters() この MIDI デバイスで MIDI データを転送するのに使用可能な MIDI OUT 接続の最大数を取得します。
long	getMicrosecondPosition() デバイスの現在の時刻表示をマイクロ秒単位で取得します。
Receiver	getReceiver() MIDI デバイスが MIDI データを受信するのに経由する MIDI IN レシーバを取得します。
Transmitter	getTransmitter() MIDI デバイスが MIDI データを転送する MIDI OUT 接続を取得します。
boolean	isOpen() デバイスが開いているかどうかを報告します。
void	open() デバイスを開き、必要なシステムリソースをデバイスが獲得して操作可能になっていることを示します。

メソッドの詳細

getDeviceInfo

public MidiDevice.Info getDeviceInfo()

Java クラスと、名前、ベンダーおよび説明などの Strings を含む、デバイスに関する情報を取得します。

戻り値:

デバイス情報

open

public void open()
          throws MidiUnavailableException

デバイスを開き、必要なシステムリソースをデバイスが獲得して操作可能になっていることを示します。

デバイスによっては、一度閉じると再び開くことはできない点に注意してください。こうしたデバイスを再度開こうとすると、常に MidiUnavailableException になります。

例外:

MidiUnavailableException - リソースの制約のためにデバイスを開けない場合はスローされる

SecurityException - リソースの制約のためにデバイスを開けない場合はスローされる

関連項目:

close(), isOpen()

close

public void close()

デバイスを閉じ、使用していたシステムリソースをデバイスが解放することを示します。

関連項目:

open(), isOpen()

isOpen

public boolean isOpen()

デバイスが開いているかどうかを報告します。特定のデバイスを開く機構はサブインタフェースによって、またはこのインタフェースを実装しているクラスによって、あるいはその両方によって定義されます。

戻り値:

デバイスが開いている場合は true、そうでない場合は false

関連項目:

close()

getMicrosecondPosition

public long getMicrosecondPosition()

デバイスの現在の時刻表示をマイクロ秒単位で取得します。デバイスが時刻表示をサポートしている場合は、デバイスが開かれたときに 0 からカウントし始め、デバイスが閉じられるまでマイクロ秒単位でカウントし続けます。デバイスが時刻表示をサポートしていない場合は、常に -1 に戻ります。

戻り値:

マイクロ秒単位でのデバイスの現在の時刻表示、またはデバイスが時刻表示をサポートしていない場合は -1

getMaxReceivers

public int getMaxReceivers()

この MIDI デバイスで MIDI データを受信するのに使用可能な MIDI IN 接続の最大数を取得します。

戻り値:

MIDI IN 接続の最大数

getMaxTransmitters

public int getMaxTransmitters()

この MIDI デバイスで MIDI データを転送するのに使用可能な MIDI OUT 接続の最大数を取得します。

戻り値:

MIDI OUT 接続の最大数

getReceiver

public Receiver getReceiver()
                     throws MidiUnavailableException

MIDI デバイスが MIDI データを受信するのに経由する MIDI IN レシーバを取得します。返されたレシーバは、アプリケーションがそのレシーバの使用を終えたときに閉じる必要があります。

戻り値:

デバイスのレシーバ

例外:

MidiUnavailableException - リソースの制約のためにレシーバを使用できない場合はスローされる

関連項目:

Receiver.close()

getTransmitter

public Transmitter getTransmitter()
                           throws MidiUnavailableException

MIDI デバイスが MIDI データを転送する MIDI OUT 接続を取得します。返されたトランスミッタは、アプリケーションがそのトランスミッタの使用を終えたときに閉じる必要があります。

戻り値:

デバイスの MIDI OUT トランスミッタ

例外:

MidiUnavailableException - リソースの制約のためにトランスミッタを使用できない場合はスローされる

関連項目:

Transmitter.close()