Skip to content

Add page-flip audio support with enableAudio prop#67

Open
rajeshias wants to merge 1 commit intoNodlik:masterfrom
rajeshias:pr/audio-feature-clean
Open

Add page-flip audio support with enableAudio prop#67
rajeshias wants to merge 1 commit intoNodlik:masterfrom
rajeshias:pr/audio-feature-clean

Conversation

@rajeshias
Copy link

@rajeshias rajeshias commented Mar 12, 2026


🔊 Add page-flip audio support (enableAudio prop)

Overview

Adds opt-in page-turn sound effects. Disabled by default — no impact on existing users.

<HTMLFlipBook enableAudio={true} {...otherProps}>

Details

Audio behaviour

  • Picks a random sound per flip to avoid sounding repetitive
  • Handles browser autoplay policy — resumes AudioContext on first user interaction

- usePageFlipAudio hook: plays a random page-turn sound on each flip
- defaultSounds.ts: bundled base64 WAV sound variations
- enableAudio prop on HTMLFlipBook (opt-in, defaults to false)
- onFlipProgress added to IEventProps for future speed-sync support
- page-flip.d.ts: type declaration for build compatibility
- AudioContext resumed on first user interaction (browser autoplay policy)
@rajeshias
Copy link
Author

For #66

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant