javax.sound.sampled

クラスLineEvent

java.lang.Object

java.util.EventObject

javax.sound.sampled.LineEvent

すべての実装されたインタフェース:

Serializable

public class LineEvent
extends EventObject

LineEventクラスは、ラインが開く、閉じる、開始する、または停止するたびにラインがリスナーに送信する情報をカプセル化します。これら4つの状態変化はそれぞれ、対応する型のイベントによって表されます。リスナーはイベントをupdateメソッドのパラメータとして受信します。イベントを照会することによってリスナーは、イベントのタイプ、イベントを処理するライン、およびイベント発生時にラインが処理し終えているデータ量を知ることができます。

このクラスはSerializableを実装していますが、LineEventオブジェクトを直列化しようとしても失敗します。

導入されたバージョン:

1.3

関連項目:

Line、LineListener.update(javax.sound.sampled.LineEvent)

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	LineEvent.Type LineEvent.Type内部クラスはラインで発生するイベントの種類を識別します。

フィールドのサマリー

クラス java.util.EventObjectから継承されたフィールド

source

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
LineEvent(Line line, LineEvent.Type type, long position) 指定されたラインで発生した、指定されたタイプのイベントを新しく構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
long	getFramePosition() イベント発生時のラインのオーディオ・データの位置を、サンプル・フレーム単位で取得します。
Line	getLine() このイベントの転送元であるオーディオ・ラインを取得します。
LineEvent.Type	getType() イベントのタイプを取得します。
String	toString() イベントの文字列表現を取得します。

クラス java.util.EventObjectから継承されたメソッド

getSource

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

LineEvent

public LineEvent(Line line,
                 LineEvent.Type type,
                 long position)

指定されたラインで発生した、指定されたタイプのイベントを新しく構築します。

パラメータ:

line - このイベントのソース

type - イベントのタイプ(OPEN、CLOSE、START、またはSTOP)

position - イベント発生時にラインがすでに処理し終わっているサンプル・フレームの数、またはAudioSystem.NOT_SPECIFIED

例外:

IllegalArgumentException - lineがnullである場合。

メソッドの詳細

getLine

public final Line getLine()

このイベントの転送元であるオーディオ・ラインを取得します。

戻り値:

このイベントを処理するライン

getType

public final LineEvent.Type getType()

イベントのタイプを取得します。

戻り値:

このイベントのタイプ(LineEvent.Type.OPEN、LineEvent.Type.CLOSE、LineEvent.Type.START、またはLineEvent.Type.STOP)

getFramePosition

public final long getFramePosition()

イベント発生時のラインのオーディオ・データの位置を、サンプル・フレーム単位で取得します。たとえば、一時停止時にソース・ラインがすでに14サンプル・フレームを再生している場合、一時停止イベントはラインの位置を14として報告します。処理する次のフレームのフレーム番号は、ゼロから始まる番号付けを使用する場合14、1から始まる番号付けを使用する場合15になります。

このフィールドは、STARTやSTOPなど、データ・ラインで生成されたの一部のイベントだけに当てはまります。サンプル・フレーム数をカウントしないラインによって生成されたイベントや、サンプル・フレームの値が未知のイベントの場合、位置の値はAudioSystem.NOT_SPECIFIEDになります。

戻り値:

サンプル・フレーム番号としてのラインの位置

toString

public String toString()

イベントの文字列表現を取得します。文字列の内容はJava Soundの実装によって異なります。

オーバーライド:

toString、クラス: EventObject

戻り値:

イベントを記述した文字列。