モジュール 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()
      イベントの文字列表現を返します。
      オーバーライド:
      toString、クラス: EventObject
      戻り値:
      イベントの文字列表現