webaudio-tools

useful tools for webaudio

🔧 Install · 🧩 Example · 📜 API docs · 🔥 Releases · 💪🏼 Contribute · 🖐️ Help

Install

$ npm i webaudio-tools

API

Table of Contents

• dbToFloat
  • Parameters
• floatToDb
  • Parameters
• PeakingDetectorNode
  • Parameters
  • isPeaking
  • decibelsThreshold
  • onpeaking
• SilenceDetectorNode
  • Parameters
  • isSilent
  • silenceThresholdSeconds
  • onsilent
  • onplaying

dbToFloat

src/db.ts:7-7

Convert dBFS value db to float.

Parameters

• db number Value in dBFS

Returns any the value in float

floatToDb

src/db.ts:15-15

Convert float value float to dBFS.

Parameters

• float number Value in float

Returns any the value in dBFS

PeakingDetectorNode

src/peaking-detector.ts:20-57

Extends GainNode

PeakingDetectorNode.

const peakingDetectorNode = new PeakingDetectorNode(ctx)
peakingDetectorNode.decibelsThreshold = -1
peakingDetectorNode.onpeaking = () => console.log('peaking')

someAudioNode.connect(peakingDetectorNode)
// ... sometime later peaking is detected and fired once ...
// => console: "peaking"
//
// ... then when issue is resolved by user
// we make it possible to emit "peaking" event again
peakingDetectorNode.reset()

Parameters

• ctx BaseAudioContext

isPeaking

src/peaking-detector.ts:22-22

Indicator whether node is peaking

decibelsThreshold

src/peaking-detector.ts:24-24

Decibels threshold in dBFS to emit peaking when above

onpeaking

src/peaking-detector.ts:26-26

Event callback that fires when peaking is detected

Returns void

SilenceDetectorNode

src/silence-detector.ts:18-67

Extends GainNode

SilenceDetectorNode.

const silenceDetectorNode = new SilenceDetectorNode(ctx)
silenceDetectorNode.silenceThresholdSeconds = 0.5
silenceDetectorNode.onplaying = () => console.log('playing')
silenceDetectorNode.onsilent = () => console.log('silent')

oscillatorNode.connect(silenceDetectorNode)
oscillatorNode.start() // => console: "playing"
...
oscillatorNode.stop()
// ... after 0.5 seconds ...
// => console: "silent"

Parameters

• ctx BaseAudioContext

isSilent

src/silence-detector.ts:20-20

Indicates whether there is silence or not

silenceThresholdSeconds

src/silence-detector.ts:22-22

How much silent time in seconds in order to detect silence (default: 0.5)

onsilent

src/silence-detector.ts:25-25

Event callback that fires when node becomes silent

Returns void

onplaying

src/silence-detector.ts:27-27

Event callback that fires when node receives audio

Returns void

Contribute

Fork or edit and submit a PR.

All contributions are welcome!

License

MIT © 2022 stagas