Package schule.ngb.zm.media
Interface Audio
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 TypeMethodDescriptionvoid
addAudioListener
(AudioListener listener) Fügt dem Medium das angegebene Objekt alsAudioListener
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.double
Liefert die aktuelle Lautstärke dieses Mediums.boolean
Prüft, ob das Medium gerade in einer Schleife abgespielt wird.boolean
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
Startet die Wiedergabe des Mediums und blockiert das Programm, bis die Wiedergabe beendet ist.void
removeAudioListener
(AudioListener listener) Entfernt den angegebenenAudioListener
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. WennisLooping() == true
gilt, dann muss auch immerisPlaying() == 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, mussstop()
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
Fügt dem Medium das angegebene Objekt alsAudioListener
hinzu, der bei Start und Stopp der Wiedergabe informiert wird.- Parameters:
listener
- Das Listener-Objekt.
-
removeAudioListener
Entfernt den angegebenenAudioListener
vom Medium.- Parameters:
listener
- Das Listener-Objekt.
-