Module javafx.media
Package javafx.scene.media

# Interface AudioSpectrumListener

public interface AudioSpectrumListener
Audio spectrum callback interface. The observer receives periodic updates of the audio spectrum. A single observer may be attached to a given `MediaPlayer` using `MediaPlayer.setAudioSpectrumListener(javafx.scene.media.AudioSpectrumListener)`.

Since:
  JavaFX 2.0
See Also:
  - `MediaPlayer`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `spectrumDataUpdate(double timestamp, double duration, float[] magnitudes, float[] phases)`
  Notifies the observer about new data available for the audio spectrum.

- ## Method Details

  - ### spectrumDataUpdate

    void spectrumDataUpdate(double timestamp, double duration, float[] magnitudes, float[] phases)
    Notifies the observer about new data available for the audio spectrum.

    The notification period for updates may be set using `MediaPlayer.setAudioSpectrumInterval(double)`, and the number of bands and sensitivity threshold via `MediaPlayer.setAudioSpectrumNumBands(int)` and `MediaPlayer.setAudioSpectrumThreshold(int)`, respectively. The default values of the settings are an interval of `0.1` seconds, `128` bands, and sensitivity threshold `-60.0` dB.

    The arrays passed to the listener should be considered to be read-only as the underlying implementation may re-use them.

    Parameters:
      `timestamp` - timestamp of the event in seconds.
      `duration` - duration for which the spectrum was computed in seconds.
      `magnitudes` - array containing the non-positive spectrum magnitude in decibels (dB) for each band. The size of the array equals the number of bands and should be considered to be read-only.
      `phases` - array containing the phase in the range [`Math.PI`, `Math.PI`] for each band. The size of the array equals the number of bands and should be considered to be read-only.