モジュール java.desktop
パッケージ 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
      戻り値:
      イベントを記述した文字列