This is a basic template for adding SoundManager to your page.
This page includes the SM2 script, which starts up on its own as appropriate. By default it will try to start as soon as possible.
The minimal code needed to get SoundManager 2 going is below, with configurable parts. You can copy/paste it to get started.
<!-- include SM2 library -->
<script type="text/javascript" src="/path/to/soundmanager2.js"></script>
<!-- configure it for your use -->
<script type="text/javascript">
soundManager.url = '/path/to/sm2-flash-files/'; // directory where SM2 .SWFs live
/*
* Note that SoundManager will determine and append the appropriate .SWF file to the URL,
* eg. /path/to/sm2-flash-files/soundmanager2.swf automatically.
*
* Bonus: Read up on HTML5 audio support, if you're feeling adventurous.
* iPad/iPhone and devices without flash installed will always attempt to use it.
*
* Also, See the flashblock demo when you want to start getting fancy.
*/
// disable debug mode after development/testing..
// soundManager.debugMode = false;
// The basics: onready() callback
soundManager.onready(function(){
// SM2 has loaded - now you can create and play sounds!
var mySound = soundManager.createSound({
id: 'aSound',
url: '/path/to/an.mp3'
// onload: myOnloadHandler,
// other options here..
});
mySound.play();
});
// Optional: ontimeout() callback for handling start-up failure
soundManager.ontimeout(function(){
// Hrmm, SM2 could not start. Flash blocker involved? Show an error, etc.?
});
</script>
It's good to let users see the flash component of SM2, so those with flash blockers can unblock it and allow SM2 to start. For more info on this, see the Flashblock example.
If you prefer to have the library wait for window.onload() before making onready() / ontimeout() callbacks, you can modify SM2's "waitForWindowLoad" property:
soundManager.waitForWindowLoad = true;
SoundManager 2 will write to a debug <div> element or a javascript console if available, by default. To disable it, simply set the relevant property to false:
soundManager.debugMode = false;
To see related configuration code, refer to the source of this page which basically does all of the above "for real."
If SM2 is failing to start and throwing errors due to flash security, timeouts or other issues, check out the troubleshooting tool which can help you fix things.
Once development is finished, you can also use the "minified" (down to 10% of original size with gzip!) version of SM2, which has debug output and comments removed for you: soundmanager2-nodebug-jsmin.js. Serve with gzip compression wherever possible for best bandwidth savings.