AudioAnalyzer
AudioAnalyzer takes measurements from audio streams that are wired to it through Wire. It provides a single Input pin but does not produce any output streams.
Summary
Properties
The loudest volume observed during the last audio buffer.
The root-mean-square average volume observed during the last audio buffer.
Enables usage of GetSpectrum.
Methods
Returns an array of Wires that are connected to the specified pin.
Returns the frequency spectrum of the last audio buffer.
Events
Fires when another instance is connected to or disconnected from the AudioAnalyzer via a Wire.
Properties
PeakLevel
The loudest volume observed during the last audio buffer. This property changes often and thus does not fire changed events.
RmsLevel
The root-mean-square average volume observed during the last audio buffer. This property is generally more stable than PeakLevel but it may not capture momentary volume spikes.
SpectrumEnabled
Enables usage of GetSpectrum(). If false, GetSpectrum() returns an empty array, but the CPU overhead of the AudioAnalyzer is dramatically reduced. This means that if you are only analyzing the volume of an audio stream, you can disable this property to improve performance.
Methods
GetConnectedWires
Returns an array of Wires that are connected to the specified pin. AudioAnalyzer has one "Input" pin.
Parameters
Returns
GetSpectrum
Returns the frequency spectrum of the last audio buffer, as an array of numbers. The elements of the array are root-mean-square volume levels, evenly spaced from 0 hertz to 24,000 hertz. If any of the analyzer's inputs come from an AudioDeviceInput, this method returns an empty array.
Returns
Events
WiringChanged
Event that fires after a Wire becomes connected or disconnected, and that Wire is now or was previously connected to a pin on the AudioAnalyzer and to some other wirable instance.
Parameters
Whether the instance got connected or disconnected.
The pin on the AudioAnalyzer that the Wire targets.
The Wire between the AudioAnalyzer and the other instance.