Package schule.ngb.zm.media

Class Music

java.lang.Object
schule.ngb.zm.media.Music
All Implemented Interfaces:
Audio
public class Music extends Object implements Audio
Eine Musik, die abgespielt werden kann.

Im Gegensatz zu einem Sound wird Music für längere Audiodateien benutzt, die zum Beispiel als Hintergrundmusik gespielt werden. Die Audiodaten werden daher nicht vollständig in den Speicher geladen, sondern direkt aus der Quelle gestreamt und direkt wiedergegeben.

Daher ist es nicht möglich, die länge der Musik im Vorfeld abzufragen oder zu einer bestimmten Stelle im Stream zu springen.

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.

  • Constructor Summary

    Constructors
    Constructor
    Description
    Music(String audioSource)
    Erstellt eine Musik aus der angegebenen Audioquelle.

  • 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.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

  • Method Details

    • getSource

      public String getSource()
      Specified by:
      getSource in interface Audio
      Returns:
      Die Quelle, aus der das Medium geladen wurde.

    • isPlaying

      public boolean isPlaying()
      Description copied from interface: Audio
      Prüft, ob das Medium gerade abgespielt wird.
      Specified by:
      isPlaying in interface Audio
      Returns:
      true, wenn das Medium abgespielt wird, false sonst.

    • isLooping

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

    • setVolume

      public void setVolume(double volume)
      Description copied from interface: Audio
      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.

      Specified by:
      setVolume in interface Audio
      Parameters:
      volume - Die neue Lautstärke zwischen 0 und 1.
      See Also:

    • getVolume

      public double getVolume()
      Description copied from interface: Audio
      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.

      Specified by:
      getVolume in interface Audio
      Returns:
      Die Lautstärke als linear skalierter Wert.

    • play

      public void play()
      Description copied from interface: Audio
      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 Audio.playAndWait() verwendet werden.

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

      Specified by:
      play in interface Audio

    • playAndWait

      public void playAndWait()
      Description copied from interface: Audio
      Startet die Wiedergabe des Mediums und blockiert das Programm, bis die Wiedergabe beendet ist.
      Specified by:
      playAndWait in interface Audio

    • loop

      public void loop()
      Description copied from interface: Audio
      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 Audio.stop() aufgerufen werden.
      Specified by:
      loop in interface Audio

    • stop

      public void stop()
      Description copied from interface: Audio
      Stoppt die Wiedergabe. Wird das Medium gerade nicht abgespielt (isPlaying() == false), dann passiert nichts.
      Specified by:
      stop in interface Audio

    • dispose

      public void dispose()
      Description copied from interface: Audio
      Stoppt die Wiedergabe und gibt alle Ressourcen, die für das Medium verwendet werden, frei.
      Specified by:
      dispose in interface Audio

    • addAudioListener

      public void addAudioListener(AudioListener listener)
      Description copied from interface: Audio
      Fügt dem Medium das angegebene Objekt als AudioListener hinzu, der bei Start und Stopp der Wiedergabe informiert wird.
      Specified by:
      addAudioListener in interface Audio
      Parameters:
      listener - Das Listener-Objekt.

    • removeAudioListener

      public void removeAudioListener(AudioListener listener)
      Description copied from interface: Audio
      Entfernt den angegebenen AudioListener vom Medium.
      Specified by:
      removeAudioListener in interface Audio
      Parameters:
      listener - Das Listener-Objekt.