Package schule.ngb.zm.media

Interface Audio

All Known Implementing Classes:
Mixer, Music, Sound
public interface Audio
Schnittstelle für Audio-Medien.

MP3-Dateien verwenden

Java kann nativ nur Waveform (.wav) Dateien wiedergeben. Um auch MP3-Dateien zu nutzen, müssen die Bibliotheken jlayer, tritonus-share und mp3spi eingebunden werden. Details zur Verwendung können in der Dokumentation der Zeichenmaschine nachgelesen werden.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addAudioListener(AudioListener listener)
    Fügt dem Medium das angegebene Objekt als AudioListener hinzu, der bei Start und Stopp der Wiedergabe informiert wird.
    void
    dispose()
    Stoppt die Wiedergabe und gibt alle Ressourcen, die für das Medium verwendet werden, frei.
    String
    getSource()
     
    double
    getVolume()
    Liefert die aktuelle Lautstärke dieses Mediums.
    boolean
    isLooping()
    Prüft, ob das Medium gerade in einer Schleife abgespielt wird.
    boolean
    isPlaying()
    Prüft, ob das Medium gerade abgespielt wird.
    void
    loop()
    Spielt das Medium in einer kontinuierlichen Schleife ab.
    void
    play()
    Startet die Wiedergabe des Mediums.
    void
    playAndWait()
    Startet die Wiedergabe des Mediums und blockiert das Programm, bis die Wiedergabe beendet ist.
    void
    removeAudioListener(AudioListener listener)
    Entfernt den angegebenen AudioListener vom Medium.
    void
    setVolume(double volume)
    Legt die Lautstärke des Mediums beim Abspielen fest.
    void
    stop()
    Stoppt die Wiedergabe.

  • Method Details

    • getSource

      String getSource()
      Returns:
      Die Quelle, aus der das Medium geladen wurde.

    • isPlaying

      boolean isPlaying()
      Prüft, ob das Medium gerade abgespielt wird.
      Returns:
      true, wenn das Medium abgespielt wird, false sonst.

    • isLooping

      boolean isLooping()
      Prüft, ob das Medium gerade in einer Schleife abgespielt wird. Wenn isLooping() == true gilt, dann muss auch immer isPlaying() == true gelten.
      Returns:
      true, wenn das Medium in einer Schleife abgespielt wird, false sonst.

    • setVolume

      void setVolume(double volume)
      Legt die Lautstärke des Mediums beim Abspielen fest.

      Die Lautstärke wird auf einer linearen Skale festgelegt, wobei 0 kein Ton und 1 volle Lautstärke bedeutet. Werte über 1 verstärken den Ton des Mediums. Negative Werte setzen die Lautstärke aud 0.

      Parameters:
      volume - Die neue Lautstärke zwischen 0 und 1.
      See Also:

    • getVolume

      double getVolume()
      Liefert die aktuelle Lautstärke dieses Mediums.

      Die Lautstärke wird auf einer linearen Skale angegeben, wobei 0 kein Ton und 1 volle Lautstärke bedeutet. Werte über 1 verstärken den Ton des Mediums.

      Returns:
      Die Lautstärke als linear skalierter Wert.

    • play

      void play()
      Startet die Wiedergabe des Mediums. Das Audio-Medium wird einmal abgespielt und stoppt dann.

      Die Methode beendet sofort und die Wiedergabe erfolgt im Hintergrund. Soll die Programmausführung erst nach Wiedergabe des Mediums fortgesetzt werden, sollte playAndWait() verwendet werden.

      Soll die Wiedergabe im Hintergrund ablaufen, aber dennoch auf das Ende reagiert werden, kann ein AudioListener verwendet werden.

    • playAndWait

      void playAndWait()
      Startet die Wiedergabe des Mediums und blockiert das Programm, bis die Wiedergabe beendet ist.

    • loop

      void loop()
      Spielt das Medium in einer kontinuierlichen Schleife ab. Die Methode startet die Wiedergabe im Hintergrund und beendet dann sofort. Um die Wiedergabe zu stoppen, muss stop() aufgerufen werden.

    • stop

      void stop()
      Stoppt die Wiedergabe. Wird das Medium gerade nicht abgespielt (isPlaying() == false), dann passiert nichts.

    • dispose

      void dispose()
      Stoppt die Wiedergabe und gibt alle Ressourcen, die für das Medium verwendet werden, frei.

    • addAudioListener

      void addAudioListener(AudioListener listener)
      Fügt dem Medium das angegebene Objekt als AudioListener hinzu, der bei Start und Stopp der Wiedergabe informiert wird.
      Parameters:
      listener - Das Listener-Objekt.

    • removeAudioListener

      void removeAudioListener(AudioListener listener)
      Entfernt den angegebenen AudioListener vom Medium.
      Parameters:
      listener - Das Listener-Objekt.