Automatic AudioContext management for Web Audio API - handles autoplay policy and page visibility
npm install audio-resumerbash
npm install audio-resumer
`
Usage
`javascript
import { AudioResumer } from 'audio-resumer';
// Create AudioContext
const audioContext = new AudioContext();
// Enable automatic AudioContext management
AudioResumer.create(audioContext);
// Now AudioContext will be automatically managed:
// - Unlocked on first user interaction
// - Suspended when page is hidden
// - Resumed when page becomes visible
`
What it solves
$3
Modern browsers block autoplay audio without user interaction. AudioResumer creates an invisible empty audio element that unlocks AudioContext when the user first interacts with the page.
$3
When a page is hidden (tab switched, minimized), AudioContext continues running and consumes resources. AudioResumer automatically suspends AudioContext when the page is hidden and resumes it when the page becomes visible again.
API
$3
#### Static Method: create
`javascript
AudioResumer.create(audioContext: AudioContext): AudioResumer
`
Creates and initializes AudioResumer for the given AudioContext. Starts managing the AudioContext automatically.
Parameters:
- audioContext - The AudioContext instance to manage
Returns:
- AudioResumer - The created AudioResumer instance (usually not needed to store)
Example:
`javascript
const audioContext = new AudioContext();
AudioResumer.create(audioContext);
`
How it works
1. Autoplay unlock: Creates an invisible empty WAV file (data URI) and plays it on user interaction to unlock AudioContext
2. Visibility tracking: Listens to visibilitychange, pagehide, and pageshow` events