Class LoudnessMeter

constructor

• new LoudnessMeter(
      node: AudioWorkletNode,
      source: AudioNode,
      silentSink?: GainNode,
      sinkDestination?: AudioNode,
  ): LoudnessMeter

  Parameters

  • node: AudioWorkletNode

    The constructed loudness-meter AudioWorkletNode.

  • source: AudioNode

    The node whose output is being metered. Its output is branched into node here; the source's existing connections are untouched (the audible path is preserved).

  • OptionalsilentSink: GainNode

    Optional zero-gain node owned by the meter. When supplied, the worklet output is connected through it to sinkDestination, keeping the metering worklet on a pulled graph without adding audible output.

  • OptionalsinkDestination: AudioNode

    Destination for the owned zero-gain sink.

  Returns LoudnessMeter

OptionalonUpdate

integrated

• get integrated(): number

  Latest gated integrated loudness (since last reset) in LKFS.

  Returns number

momentary

• get momentary(): number

  Latest momentary loudness (400 ms) in LKFS.

  Returns number

reading

• get reading(): LoudnessReading

  A snapshot of all current readings.

  Returns LoudnessReading

shortTerm

• get shortTerm(): number

  Latest short-term loudness (3 s) in LKFS.

  Returns number

truePeak

• get truePeak(): number

  Latest true-peak level (since last reset) in dBTP.

  Returns number

workletNode

• get workletNode(): AudioWorkletNode

  The underlying metering worklet node (for advanced wiring).

  Returns AudioWorkletNode

disconnect

• disconnect(): void

  Stops metering: removes the branch tap from the source and detaches the message listener. The audible path (the source's other edges) is untouched.

  Returns void

reset

• reset(): void

  Resets the integrated-loudness gate accumulator and the true-peak hold on the worklet (momentary/short-term keep sliding). Use to start a fresh integrated measurement of a new programme.

  Returns void