The backgroundsounds plugin adds a possibility to define a background sound for a whole chapter, or a single page (as an alternative to the sound page element).

Attributes

Chapter

bgsound

• Type: String

URL to a sound file (MP3) to play in the background while any page of this chapter is visible. Sounds are looped infinitely and continue playing even if muted (e.g. no page in the chapter is visible). Can be an absolute or relative path. Relative paths are always relative to the megazine.swf file.

delay

• Type: Integer
• Default: 0

Time in milliseconds before the sound starts fading in. This does not affect fadeout, which will still begin immediately if all pages in the chapter become invisible.

fade

• Type: Integer
• Default: 2000

Time in milliseconds over which to fade in and out the sound when the chapter becomes visible or hidden, respectively (i.e. at least one page in the chapter gets visible, or all pages become invisible).

Page

Consider using the sound element to achieve the same effect for pages, with better configurability.

bgsound

• Type: String

URL to a sound file (MP3) to play in the background while the page is visible. Sounds are looped infinitely and continue playing even if muted (e.g. the page is invisible). Can be an absolute or relative path. Relative paths are always relative to the megazine.swf file.

delay

• Type: Integer
• Default: 0

Time in milliseconds before the sound starts fading in. This does not affect fadeout, which will still begin immediately if the containing page becomes invisible.

fade

• Type: Integer
• Default: 2000

Time in milliseconds over which to fade in and out the sound when the containing page becomes visible or hidden, respectively.

Example

<book plugins="backgroundsounds">
    <chapter>
        <!-- ... -->
    </chapter>
    <chapter bgsound="data/bg.mp3" fade="1000" delay="500">
        <!-- ... -->
    </chapter>
</book>