AudioPlayer displays a Play button supplied as play.png located in a folder named 'AudioPlayer1'. When this play button is tapped, an MP3 file labelled audio.mp3 (located in the same folder) will play. Tapping the play button while the audio is playing will pause the audio. If, when you pause an audio file, you'd like the play button to be replaced by a pause button you can supply a pause.png that will be displayed automatically after the play button has been tapped.
You can also load remote MP3 or M4A files instead of supplying them locally by changing the hotspot URL - eg AudioPlayer1,url=http://link/to/audiofile.mp3. You must still create the folder for the hotspot and supply the play and pause button images for streaming audio.
Hotspot = AudioPlayer1
NOTE: Audio Player has undergone some changes and can now support a range of new options. Features that are exclusive to Oomph version 21.0.0 and higher are detailed in bold below.
|Position in Hotspot||Aligns to centre of hotspot. Content resizes to fill hotspot Yes - Scales to fill, i.e. does not keep aspect ratio.|
|Folder Name||AudioPlayer1 (2, 3 etc)|
M4A (AAC), (Oomph versions 20.0.8 and later)
audio.mp3 or audio.m4a (unless linking to a remote audio file, e.g. http://link/to/audiofile.mp3)
|Examples||QA Oomph Walkthough/Oomph_Walkthough/AudioPlayer|
|Transparent background allowed||Yes|
autoplay keyword will make the audio file play as soon as the widget displays on-screen.
loop keyword will make the audio continue to play in a continuous loop until the user taps the widget again to pause it.
ambient keyword will make the audio play in the background. It will continue to play in the background when you navigate away from the current page, no matter which section of the publication you navigate to.
As of version 20.0.8, you can have multiple audio widgets on the page simultaneously with in-page video content. When one audio widget starts to play, it will pause all other widgets on the page other than those that have the ambient keyword set. If you set the
concurrent keyword for an audio widget, it will not pause when another audio widget starts to play. However, note that this is different to the
ambient parameter in that concurrent widgets will stop playing audio when they go off-screen.
Audio streaming has been enhanced in version 20.0.8 and later and supports both fixed-length files stored on remote servers as well as true streaming audio.
iPad Preview Files
To view these files on your iPad click here to download Oomph Viewer onto your iPad. Once Oomph Viewer is installed download the Handy Book of Oomph in the Library section and preview all the Oomph features in one issue.
Got a question?