soundmanager2-rails 2.97.20140901 → 2.97.20150601

data/vendor/assets/javascripts/soundmanager2.js

@@ -8,7 +8,7 @@
  * Code provided under the BSD License:
  * http://schillmania.com/projects/soundmanager2/license.txt
  *
- * V2.97a.20140901
+ * V2.97a.20150601
  */
 
 /*global window, SM2_DEFER, sm2Debugger, console, document, navigator, setTimeout, setInterval, clearInterval, Audio, opera, module, define */
@@ -80,7 +80,9 @@ function SoundManager(smURL, smID) {
     'wmode': null,                      // flash rendering mode - null, 'transparent', or 'opaque' (last two allow z-index to work)
     'allowScriptAccess': 'always',      // for scripting the SWF (object/embed property), 'always' or 'sameDomain'
     'useFlashBlock': false,             // *requires flashblock.css, see demos* - allow recovery from flash blockers. Wait indefinitely and apply timeout CSS to SWF, if applicable.
-    'useHTML5Audio': true,              // use HTML5 Audio() where API is supported (most Safari, Chrome versions), Firefox (no MP3/MP4.) Ideally, transparent vs. Flash API where possible.
+    'useHTML5Audio': true,              // use HTML5 Audio() where API is supported (most Safari, Chrome versions), Firefox (MP3/MP4 support varies.) Ideally, transparent vs. Flash API where possible.
+    'forceUseGlobalHTML5Audio': false,  // if true, a single Audio() object is used for all sounds - and only one can play at a time.
+    'ignoreMobileRestrictions': false,  // if true, SM2 will not apply global HTML5 audio rules to mobile UAs. iOS > 7 and WebViews may allow multiple Audio() instances.
     'html5Test': /^(probably|maybe)$/i, // HTML5 Audio() format support test. Use /^probably$/i; if you want to be more conservative.
     'preferFlash': false,               // overrides useHTML5audio, will use Flash for MP3/MP4/AAC if present. Potential option if HTML5 playback with these formats is quirky.
     'noSWFCache': false,                // if true, appends ?ts={date} to break aggressive SWF caching.
@@ -198,7 +200,7 @@ function SoundManager(smURL, smID) {
 
   // dynamic attributes
 
-  this.versionNumber = 'V2.97a.20140901';
+  this.versionNumber = 'V2.97a.20150601';
   this.version = null;
   this.movieURL = null;
   this.altURL = null;
@@ -212,28 +214,23 @@ function SoundManager(smURL, smID) {
   this.filePattern = null;
 
   this.filePatterns = {
-
     'flash8': /\.mp3(\?.*)?$/i,
     'flash9': /\.mp3(\?.*)?$/i
-
   };
 
   // support indicators, set at init
 
   this.features = {
-
     'buffering': false,
     'peakData': false,
     'waveformData': false,
     'eqData': false,
     'movieStar': false
-
   };
 
   // flash sandbox info, used primarily in troubleshooting
 
   this.sandbox = {
-
     // <d>
     'type': null,
     'types': {
@@ -246,7 +243,6 @@ function SoundManager(smURL, smID) {
     'noRemote': null,
     'noLocal': null
     // </d>
-
   };
 
   /**
@@ -274,15 +270,22 @@ function SoundManager(smURL, smID) {
    */
 
   var SMSound,
-  sm2 = this, globalHTML5Audio = null, flash = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', id, ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, fV, on_queue = [], debugOpen = true, debugTS, didAppend = false, appendSuccess = false, didInit = false, disabled = false, windowLoaded = false, _wDS, wdCount = 0, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, initUserOnload, delayWaitForEI, waitForEI, rebootIntoHTML5, setVersionInfo, handleFocus, strings, initMovie, preInit, domContentLoaded, winOnLoad, didDCLoaded, getDocument, createMovie, catchError, setPolling, initDebug, debugLevels = ['log', 'info', 'warn', 'error'], defaultFlashVersion = 8, disableObject, failSafely, normalizeMovieURL, oRemoved = null, oRemovedHTML = null, str, flashBlockHandler, getSWFCSS, swfCSS, toggleDebug, loopFix, policyFix, complain, idCheck, waitingForEI = false, initPending = false, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [],
-  canIgnoreFlash, needsFlash = null, featureCheck, html5OK, html5CanPlay, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, hasFlash, detectFlash, badSafariFix, html5_events, showSupport, flushMessages, wrapCallback, idCounter = 0,
-  is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/i), isIE = ua.match(/msie/i), isWebkit = ua.match(/webkit/i), isSafari = (ua.match(/safari/i) && !ua.match(/chrome/i)), isOpera = (ua.match(/opera/i)),
+  sm2 = this, globalHTML5Audio = null, flash = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', id, ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, fV, on_queue = [], debugOpen = true, debugTS, didAppend = false, appendSuccess = false, didInit = false, disabled = false, windowLoaded = false, _wDS, wdCount = 0, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, initUserOnload, delayWaitForEI, waitForEI, rebootIntoHTML5, setVersionInfo, handleFocus, strings, initMovie, domContentLoaded, winOnLoad, didDCLoaded, getDocument, createMovie, catchError, setPolling, initDebug, debugLevels = ['log', 'info', 'warn', 'error'], defaultFlashVersion = 8, disableObject, failSafely, normalizeMovieURL, oRemoved = null, oRemovedHTML = null, str, flashBlockHandler, getSWFCSS, swfCSS, toggleDebug, loopFix, policyFix, complain, idCheck, waitingForEI = false, initPending = false, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [],
+  canIgnoreFlash, needsFlash = null, featureCheck, html5OK, html5CanPlay, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, hasFlash, detectFlash, badSafariFix, html5_events, showSupport, flushMessages, wrapCallback, idCounter = 0, didSetup, msecScale = 1000,
+  is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/i), isIE = ua.match(/msie/i),
+  isWebkit = ua.match(/webkit/i),
+  isSafari = (ua.match(/safari/i) && !ua.match(/chrome/i)),
+  isOpera = (ua.match(/opera/i)),
   mobileHTML5 = (ua.match(/(mobile|pre\/|xoom)/i) || is_iDevice || isAndroid),
   isBadSafari = (!wl.match(/usehtml5audio/i) && !wl.match(/sm2\-ignorebadua/i) && isSafari && !ua.match(/silk/i) && ua.match(/OS X 10_6_([3-7])/i)), // Safari 4 and 5 (excluding Kindle Fire, "Silk") occasionally fail to load/play HTML5 audio on Snow Leopard 10.6.3 through 10.6.7 due to bug(s) in QuickTime X and/or other underlying frameworks. :/ Confirmed bug. https://bugs.webkit.org/show_bug.cgi?id=32159
-  hasConsole = (window.console !== _undefined && console.log !== _undefined), isFocused = (doc.hasFocus !== _undefined?doc.hasFocus():null), tryInitOnFocus = (isSafari && (doc.hasFocus === _undefined || !doc.hasFocus())), okToDisable = !tryInitOnFocus, flashMIME = /(mp3|mp4|mpa|m4a|m4b)/i, msecScale = 1000,
+  hasConsole = (window.console !== _undefined && console.log !== _undefined),
+  isFocused = (doc.hasFocus !== _undefined ? doc.hasFocus() : null),
+  tryInitOnFocus = (isSafari && (doc.hasFocus === _undefined || !doc.hasFocus())),
+  okToDisable = !tryInitOnFocus,
+  flashMIME = /(mp3|mp4|mpa|m4a|m4b)/i,
   emptyURL = 'about:blank', // safe URL to unload, or load nothing from (flash 8 + most HTML5 UAs)
   emptyWAV = 'data:audio/wave;base64,/UklGRiYAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQIAAAD//w==', // tiny WAV for HTML5 unloading
-  overHTTP = (doc.location?doc.location.protocol.match(/http/i):null),
+  overHTTP = (doc.location ? doc.location.protocol.match(/http/i) : null),
   http = (!overHTTP ? 'http:/'+'/' : ''),
   // mp3, mp4, aac etc.
   netStreamMimeTypes = /^\s*audio\/(?:x-)?(?:mpeg4|aac|flv|mov|mp4||m4v|m4a|m4b|mp4v|3gp|3g2)\s*(?:$|;)/i,
@@ -296,7 +299,6 @@ function SoundManager(smURL, smID) {
   this.useAltURL = !overHTTP;
 
   swfCSS = {
-
     'swfBox': 'sm2-object-box',
     'swfDefault': 'movieContainer',
     'swfError': 'swf_error', // SWF loaded, but SM2 couldn't start (other error)
@@ -306,7 +308,6 @@ function SoundManager(smURL, smID) {
     'sm2Debug': 'sm2_debug',
     'highPerf': 'high_performance',
     'flashDebug': 'flash_debug'
-
   };
 
   /**
@@ -350,6 +351,73 @@ function SoundManager(smURL, smID) {
 
     assign(options);
 
+    if (!useGlobalHTML5Audio) {
+
+      if (mobileHTML5) {
+
+        // force the singleton HTML5 pattern on mobile, by default.
+        if (!sm2.setupOptions.ignoreMobileRestrictions || sm2.setupOptions.forceUseGlobalHTML5Audio) {
+          messages.push(strings.globalHTML5);
+          useGlobalHTML5Audio = true;
+        }
+
+      } else {
+
+        // only apply singleton HTML5 on desktop if forced.
+        if (sm2.setupOptions.forceUseGlobalHTML5Audio) {
+          messages.push(strings.globalHTML5);
+          useGlobalHTML5Audio = true;
+        }
+
+      }
+
+    }
+
+    if (!didSetup && mobileHTML5) {
+
+      if (sm2.setupOptions.ignoreMobileRestrictions) {
+        
+        messages.push(strings.ignoreMobile);
+      
+      } else {
+
+        // prefer HTML5 for mobile + tablet-like devices, probably more reliable vs. flash at this point.
+
+        // <d>
+        if (!sm2.setupOptions.useHTML5Audio || sm2.setupOptions.preferFlash) {
+          // notify that defaults are being changed.
+          sm2._wD(strings.mobileUA);
+        }
+        // </d>
+
+        sm2.setupOptions.useHTML5Audio = true;
+        sm2.setupOptions.preferFlash = false;
+
+        if (is_iDevice) {
+
+          // no flash here.
+          sm2.ignoreFlash = true;
+
+        } else if ((isAndroid && !ua.match(/android\s2\.3/i)) || !isAndroid) {
+        
+          /**
+           * Android devices tend to work better with a single audio instance, specifically for chained playback of sounds in sequence.
+           * Common use case: exiting sound onfinish() -> createSound() -> play()
+           * Presuming similar restrictions for other mobile, non-Android, non-iOS devices.
+           */
+
+          // <d>
+          sm2._wD(strings.globalHTML5);
+          // </d>
+
+          useGlobalHTML5Audio = true;
+
+        }
+
+      }
+
+    }
+
     // special case 1: "Late setup". SM2 loaded normally, but user didn't assign flash URL eg., setup({url:...}) before SM2 init. Treat as delayed init.
 
     if (options) {
@@ -366,6 +434,8 @@ function SoundManager(smURL, smID) {
 
     }
 
+    didSetup = true;
+
     return sm2;
 
   };
@@ -386,9 +456,9 @@ function SoundManager(smURL, smID) {
   };
 
   /**
-   * Creates a SMSound sound object instance.
+   * Creates a SMSound sound object instance. Can also be overloaded, e.g., createSound('mySound', '/some.mp3');
    *
-   * @param {object} oOptions Sound options (at minimum, id and url parameters are required.)
+   * @param {object} oOptions Sound options (at minimum, url parameter is required.)
    * @return {object} SMSound The new SMSound object.
    */
 
@@ -398,7 +468,7 @@ function SoundManager(smURL, smID) {
 
     // <d>
     cs = sm + '.createSound(): ';
-    cs_string = cs + str(!didInit?'notReady':'notOK');
+    cs_string = cs + str(!didInit ? 'notReady' : 'notOK');
     // </d>
 
     if (!didInit || !sm2.ok()) {
@@ -407,7 +477,7 @@ function SoundManager(smURL, smID) {
     }
 
     if (_url !== _undefined) {
-      // function overloading in JS! :) ..assume simple createSound(id, url) use case
+      // function overloading in JS! :) ... assume simple createSound(id, url) use case.
       oOptions = {
         'id': oOptions,
         'url': _url
@@ -420,7 +490,7 @@ function SoundManager(smURL, smID) {
     options.url = parseURL(options.url);
 
     // generate an id, if needed.
-    if (options.id === undefined) {
+    if (options.id === _undefined) {
       options.id = sm2.setupOptions.idPrefix + (idCounter++);
     }
 
@@ -449,7 +519,11 @@ function SoundManager(smURL, smID) {
     if (html5OK(options)) {
 
       oSound = make();
-      sm2._wD(options.id + ': Using HTML5');
+      // <d>
+      if (!sm2.html5Only) {
+        sm2._wD(options.id + ': Using HTML5');
+      }
+      // </d>
       oSound._setup_html5(options);
 
     } else {
@@ -486,9 +560,9 @@ function SoundManager(smURL, smID) {
       oSound = make();
 
       if (fV === 8) {
-        flash._createSound(options.id, options.loops||1, options.usePolicyFile);
+        flash._createSound(options.id, options.loops || 1, options.usePolicyFile);
       } else {
-        flash._createSound(options.id, options.url, options.usePeakData, options.useWaveformData, options.useEQData, options.isMovieStar, (options.isMovieStar?options.bufferTime:false), options.loops||1, options.serverURL, options.duration||null, options.autoPlay, true, options.autoLoad, options.usePolicyFile);
+        flash._createSound(options.id, options.url, options.usePeakData, options.useWaveformData, options.useEQData, options.isMovieStar, (options.isMovieStar ? options.bufferTime : false), options.loops || 1, options.serverURL, options.duration || null, options.autoPlay, true, options.autoLoad, options.usePolicyFile);
         if (!options.serverURL) {
           // We are connected immediately
           oSound.connected = true;
@@ -530,10 +604,11 @@ function SoundManager(smURL, smID) {
 
     var oS = sm2.sounds[sID], i;
 
-    // Disable all callbacks while the sound is being destroyed
-    oS._iO = {};
-
     oS.stop();
+    
+    // Disable all callbacks after stop(), when the sound is being destroyed
+    oS._iO = {};
+    
     oS.unload();
 
     for (i = 0; i < sm2.soundIDs.length; i++) {
@@ -683,7 +758,8 @@ function SoundManager(smURL, smID) {
 
   };
 
-  this.start = this.play; // just for convenience
+  // just for convenience
+  this.start = this.play;
 
   /**
    * Calls the setPosition() method of a SMSound object by ID.
@@ -761,7 +837,7 @@ function SoundManager(smURL, smID) {
   this.pauseAll = function() {
 
     var i;
-    for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+    for (i = sm2.soundIDs.length - 1; i >= 0; i--) {
       sm2.sounds[sm2.soundIDs[i]].pause();
     }
 
@@ -790,7 +866,7 @@ function SoundManager(smURL, smID) {
   this.resumeAll = function() {
 
     var i;
-    for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+    for (i = sm2.soundIDs.length- 1 ; i >= 0; i--) {
       sm2.sounds[sm2.soundIDs[i]].resume();
     }
 
@@ -830,7 +906,8 @@ function SoundManager(smURL, smID) {
   };
 
   /**
-   * Calls the setVolume() method of a SMSound object by ID.
+   * Calls the setVolume() method of a SMSound object by ID
+   * Overloaded case: pass only volume argument eg., setVolume(50) to apply to all sounds.
    *
    * @param {string} sID The ID of the sound
    * @param {number} nVol The volume value (0 to 100)
@@ -839,9 +916,23 @@ function SoundManager(smURL, smID) {
 
   this.setVolume = function(sID, nVol) {
 
+    // setVolume(50) function overloading case - apply to all sounds
+
+    var i, j;
+
+    if (sID !== _undefined && !isNaN(sID) && nVol === _undefined) {
+      for (i = 0, j = sm2.soundIDs.length; i < j; i++) {
+        sm2.sounds[sm2.soundIDs[i]].setVolume(sID);
+      }
+      return;
+    }
+
+    // setVolume('mySound', 50) case
+
     if (!idCheck(sID)) {
       return false;
     }
+
     return sm2.sounds[sID].setVolume(nVol);
 
   };
@@ -863,7 +954,7 @@ function SoundManager(smURL, smID) {
     if (!sID) {
 
       sm2._wD(sm + '.mute(): Muting all sounds');
-      for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+      for (i = sm2.soundIDs.length - 1; i >= 0; i--) {
         sm2.sounds[sm2.soundIDs[i]].mute();
       }
       sm2.muted = true;
@@ -909,7 +1000,7 @@ function SoundManager(smURL, smID) {
     if (!sID) {
 
       sm2._wD(sm + '.unmute(): Unmuting all sounds');
-      for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+      for (i = sm2.soundIDs.length - 1; i >= 0; i--) {
         sm2.sounds[sm2.soundIDs[i]].unmute();
       }
       sm2.muted = false;
@@ -993,7 +1084,7 @@ function SoundManager(smURL, smID) {
     disabled = true;
     _wDS('shutdown', 1);
 
-    for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+    for (i = sm2.soundIDs.length - 1; i >= 0; i--) {
       disableObject(sm2.sounds[sm2.soundIDs[i]]);
     }
 
@@ -1014,7 +1105,9 @@ function SoundManager(smURL, smID) {
     var result;
 
     if (sm2.hasHTML5) {
-      result = html5CanPlay({type:sMIME});
+      result = html5CanPlay({
+        type: sMIME
+      });
     }
 
     if (!result && needsFlash) {
@@ -1038,7 +1131,9 @@ function SoundManager(smURL, smID) {
     var result;
 
     if (sm2.hasHTML5) {
-      result = html5CanPlay({url: sURL});
+      result = html5CanPlay({
+        url: sURL
+      });
     }
 
     if (!result && needsFlash) {
@@ -1186,7 +1281,7 @@ function SoundManager(smURL, smID) {
 
     var sDID = 'soundmanager-debug', o, oItem;
 
-    if (!sm2.debugMode) {
+    if (!sm2.setupOptions.debugMode) {
       return false;
     }
 
@@ -1295,7 +1390,7 @@ function SoundManager(smURL, smID) {
 
     var i, j, k;
 
-    for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+    for (i = sm2.soundIDs.length- 1 ; i >= 0; i--) {
       sm2.sounds[sm2.soundIDs[i]].destruct();
     }
 
@@ -1331,6 +1426,7 @@ function SoundManager(smURL, smID) {
     sm2.sounds = {};
 
     idCounter = 0;
+    didSetup = false;
 
     if (!resetEvents) {
       // reset callbacks for onready, ontimeout etc. so that they will fire again on re-init
@@ -1367,8 +1463,6 @@ function SoundManager(smURL, smID) {
 
     window.setTimeout(function() {
 
-      preInit();
-
       // by default, re-init
 
       if (!excludeInit) {
@@ -1654,12 +1748,15 @@ function SoundManager(smURL, smID) {
           if (fV === 8) {
             flash._load(s.id, instanceOptions.url, instanceOptions.stream, instanceOptions.autoPlay, instanceOptions.usePolicyFile);
           } else {
-            flash._load(s.id, instanceOptions.url, !!(instanceOptions.stream), !!(instanceOptions.autoPlay), instanceOptions.loops||1, !!(instanceOptions.autoLoad), instanceOptions.usePolicyFile);
+            flash._load(s.id, instanceOptions.url, !!(instanceOptions.stream), !!(instanceOptions.autoPlay), instanceOptions.loops || 1, !!(instanceOptions.autoLoad), instanceOptions.usePolicyFile);
           }
         } catch(e) {
           _wDS('smError', 2);
           debugTS('onload', false);
-          catchError({type:'SMSOUND_LOAD_JS_EXCEPTION', fatal:true});
+          catchError({
+            type: 'SMSOUND_LOAD_JS_EXCEPTION',
+            fatal: true
+          });
         }
 
       }
@@ -1814,17 +1911,24 @@ function SoundManager(smURL, smID) {
       }
 
       if (s.playState === 1 && !s.paused) {
+
         allowMulti = s._iO.multiShot;
+
         if (!allowMulti) {
+
           sm2._wD(fN + 'Already playing (one-shot)', 1);
+
           if (s.isHTML5) {
             // go back to original position.
             s.setPosition(s._iO.position);
           }
+
           exit = s;
+
         } else {
           sm2._wD(fN + 'Already playing (multi-shot)', 1);
         }
+
       }
 
       if (exit !== null) {
@@ -1900,7 +2004,7 @@ function SoundManager(smURL, smID) {
 
       if (!s.isHTML5 && fV === 9 && s.position > 0 && s.position === s.duration) {
         // flash 9 needs a position reset if play() is called while at the end of a sound.
-        sm2._wD(fN + 'Sound at end, resetting to position:0');
+        sm2._wD(fN + 'Sound at end, resetting to position: 0');
         oOptions.position = 0;
       }
 
@@ -2060,7 +2164,7 @@ function SoundManager(smURL, smID) {
             event.add(audioClone, 'ended', onended);
 
             // apply volume to clones, too
-            if (s._iO.volume !== undefined) {
+            if (s._iO.volume !== _undefined) {
               audioClone.volume = Math.max(0, Math.min(1, s._iO.volume/100));
             }
 
@@ -2252,7 +2356,7 @@ function SoundManager(smURL, smID) {
              * if seek is beyond (loaded?) position, "DOM exception 11"
              * "INDEX_SIZE_ERR": DOM exception 1
              */
-            sm2._wD(s.id + ': setPosition('+position1K+')');
+            sm2._wD(s.id + ': setPosition(' + position1K + ')');
 
             try {
               s._a.currentTime = position1K;
@@ -2276,8 +2380,7 @@ function SoundManager(smURL, smID) {
 
         if (s.paused) {
 
-          // if paused, refresh UI right away
-          // force update
+          // if paused, refresh UI right away by forcing update
           s._onTimer(true);
 
         }
@@ -2347,22 +2450,31 @@ function SoundManager(smURL, smID) {
       s.playState = 1;
 
       if (!s.isHTML5) {
+
         if (instanceOptions.isMovieStar && !instanceOptions.serverURL) {
           // Bizarre Webkit bug (Chrome reported via 8tracks.com dudes): AAC content paused for 30+ seconds(?) will not resume without a reposition.
           s.setPosition(s.position);
         }
+
         // flash method is toggle-based (pause/resume)
         flash._pause(s.id, instanceOptions.multiShot);
+
       } else {
+
         s._setup_html5().play();
         start_html5_timer();
+
       }
 
       if (!onplay_called && instanceOptions.onplay) {
+
         instanceOptions.onplay.apply(s);
         onplay_called = true;
+
       } else if (instanceOptions.onresume) {
+
         instanceOptions.onresume.apply(s);
+
       }
 
       return s;
@@ -2453,14 +2565,19 @@ function SoundManager(smURL, smID) {
       }
 
       if (!s.isHTML5) {
-        flash._setVolume(s.id, (sm2.muted && !s.muted) || s.muted?0:nVol);
+
+        flash._setVolume(s.id, (sm2.muted && !s.muted) || s.muted ? 0 : nVol);
+
       } else if (s._a) {
+
         if (sm2.muted && !s.muted) {
           s.muted = true;
           s._a.muted = true;
         }
-        // valid range: 0-1
+
+        // valid range for native HTML5 Audio(): 0-1
         s._a.volume = Math.max(0, Math.min(1, nVol/100));
+
       }
 
       s._iO.volume = nVol;
@@ -2506,7 +2623,7 @@ function SoundManager(smURL, smID) {
       var hasIO = (s._iO.volume !== _undefined);
 
       if (!s.isHTML5) {
-        flash._setVolume(s.id, hasIO?s._iO.volume:s.options.volume);
+        flash._setVolume(s.id, hasIO ? s._iO.volume : s.options.volume);
       } else if (s._a) {
         s._a.muted = false;
       }
@@ -2523,7 +2640,7 @@ function SoundManager(smURL, smID) {
 
     this.toggleMute = function() {
 
-      return (s.muted?s.unmute():s.mute());
+      return (s.muted ? s.unmute() : s.mute());
 
     };
 
@@ -2577,13 +2694,18 @@ function SoundManager(smURL, smID) {
 
         if (nPosition === onPositionItems[i].position) {
           // remove this item if no method was specified, or, if the method matches
+          
           if (!oMethod || (oMethod === onPositionItems[i].method)) {
+            
             if (onPositionItems[i].fired) {
               // decrement "fired" counter, too
               onPositionFired--;
             }
+            
             onPositionItems.splice(i, 1);
+          
           }
+        
         }
 
       }
@@ -2593,21 +2715,28 @@ function SoundManager(smURL, smID) {
     this._processOnPosition = function() {
 
       var i, item, j = onPositionItems.length;
-		
+
       if (!j || !s.playState || onPositionFired >= j) {
         return false;
       }
 
-      for (i=j-1; i >= 0; i--) {
+      for (i = j - 1; i >= 0; i--) {
+        
         item = onPositionItems[i];
+        
         if (!item.fired && s.position >= item.position) {
+        
           item.fired = true;
           onPositionFired++;
           item.method.apply(item.scope, [item.position]);
-		  j = onPositionItems.length; //  reset j -- onPositionItems.length can be changed in the item callback above... occasionally breaking the loop.
+        
+          //  reset j -- onPositionItems.length can be changed in the item callback above... occasionally breaking the loop.
+		      j = onPositionItems.length;
+        
         }
+      
       }
-	
+
       return true;
 
     };
@@ -2621,12 +2750,15 @@ function SoundManager(smURL, smID) {
         return false;
       }
 
-      for (i=j-1; i >= 0; i--) {
+      for (i = j - 1; i >= 0; i--) {
+        
         item = onPositionItems[i];
+        
         if (item.fired && nPosition <= item.position) {
           item.fired = false;
           onPositionFired--;
         }
+      
       }
 
       return true;
@@ -2841,7 +2973,7 @@ function SoundManager(smURL, smID) {
 
           if (isNew || bForce) {
 
-            s._whileplaying(time,x,x,x,x);
+            s._whileplaying(time, x, x, x, x);
 
           }
 
@@ -2863,7 +2995,7 @@ function SoundManager(smURL, smID) {
 
       var instanceOptions = s._iO,
           // if audio object exists, use its duration - else, instance option duration (if provided - it's a hack, really, and should be retired) OR null
-          d = (s._a && s._a.duration ? s._a.duration*msecScale : (instanceOptions && instanceOptions.duration ? instanceOptions.duration : null)),
+          d = (s._a && s._a.duration ? s._a.duration * msecScale : (instanceOptions && instanceOptions.duration ? instanceOptions.duration : null)),
           result = (d && !isNaN(d) && d !== Infinity ? d : null);
 
       return result;
@@ -3026,7 +3158,7 @@ function SoundManager(smURL, smID) {
       var f;
 
       function add(oEvt, oFn, bCapture) {
-        return s._a ? s._a.addEventListener(oEvt, oFn, bCapture||false) : null;
+        return s._a ? s._a.addEventListener(oEvt, oFn, bCapture || false) : null;
       }
 
       s._a._added_events = true;
@@ -3048,7 +3180,7 @@ function SoundManager(smURL, smID) {
       var f;
 
       function remove(oEvt, oFn, bCapture) {
-        return (s._a ? s._a.removeEventListener(oEvt, oFn, bCapture||false) : null);
+        return (s._a ? s._a.removeEventListener(oEvt, oFn, bCapture || false) : null);
       }
 
       sm2._wD(s.id + ': Removing event listeners');
@@ -3076,6 +3208,7 @@ function SoundManager(smURL, smID) {
       // <d>
       fN = s.id + ': ';
       sm2._wD(fN + (loadOK ? 'onload()' : 'Failed to load / invalid sound?' + (!s.duration ? ' Zero-length duration reported.' : ' -') + ' (' + s.url + ')'), (loadOK ? 1 : 2));
+
       if (!loadOK && !s.isHTML5) {
         if (sm2.sandbox.noRemote === true) {
           sm2._wD(fN + str('noNet'), 1);
@@ -3087,7 +3220,7 @@ function SoundManager(smURL, smID) {
       // </d>
 
       s.loaded = loadOK;
-      s.readyState = loadOK?3:2;
+      s.readyState = (loadOK ? 3 : 2);
       s._onbufferchange(0);
 
       if (s._iO.onload) {
@@ -3112,6 +3245,7 @@ function SoundManager(smURL, smID) {
       }
 
       s.isBuffering = (nIsBuffering === 1);
+      
       if (s._iO.onbufferchange) {
         sm2._wD(s.id + ': Buffer state change: ' + nIsBuffering);
         s._iO.onbufferchange.apply(s, [nIsBuffering]);
@@ -3351,9 +3485,8 @@ function SoundManager(smURL, smID) {
       for (i = 0, j = oMDProps.length; i < j; i++) {
         oData[oMDProps[i]] = oMDData[i];
       }
-      s.metadata = oData;
 
-console.log('updated metadata', s.metadata);
+      s.metadata = oData;
 
       if (s._iO.onmetadata) {
         s._iO.onmetadata.call(s, s.metadata);
@@ -3378,6 +3511,7 @@ console.log('updated metadata', s.metadata);
       for (i = 0, j = oID3Props.length; i < j; i++) {
         oData[oID3Props[i]] = oID3Data[i];
       }
+
       s.id3 = mixin(s.id3, oData);
 
       if (s._iO.onid3) {
@@ -3544,17 +3678,11 @@ console.log('updated metadata', s.metadata);
         if (bonusOptions.hasOwnProperty(i)) {
 
           if (typeof sm2[i] === 'object') {
-
-            result.push(i+': {...}');
-
+            result.push(i + ': {...}');
           } else if (sm2[i] instanceof Function) {
-
-            result.push(i+': function() {...}');
-
+            result.push(i + ': function() {...}');
           } else {
-
             result.push(i);
-
           }
 
         }
@@ -3609,7 +3737,7 @@ console.log('updated metadata', s.metadata);
 
             if (sm2[i] instanceof Function) {
 
-              sm2[i].apply(sm2, (o[i] instanceof Array? o[i] : [o[i]]));
+              sm2[i].apply(sm2, (o[i] instanceof Array ? o[i] : [o[i]]));
 
             } else {
 
@@ -3665,8 +3793,8 @@ console.log('updated metadata', s.metadata);
     // normalize event methods
     var old = (window.attachEvent),
     evt = {
-      add: (old?'attachEvent':'addEventListener'),
-      remove: (old?'detachEvent':'removeEventListener')
+      add: (old ? 'attachEvent' : 'addEventListener'),
+      remove: (old ? 'detachEvent' : 'removeEventListener')
     };
 
     // normalize "on" event prefix, optional capture argument
@@ -3706,15 +3834,11 @@ console.log('updated metadata', s.metadata);
     }
 
     function add() {
-
       apply(getArgs(arguments), 'add');
-
     }
 
     function remove() {
-
       apply(getArgs(arguments), 'remove');
-
     }
 
     return {
@@ -3921,8 +4045,8 @@ console.log('updated metadata', s.metadata);
           isProgress = (e.type === 'progress'),
           ranges = e.target.buffered,
           // firefox 3.6 implements e.loaded/total (bytes)
-          loaded = (e.loaded||0),
-          total = (e.total||1);
+          loaded = (e.loaded || 0),
+          total = (e.total || 1);
 
       // reset the "buffered" (loaded byte ranges) array
       s.buffered = [];
@@ -3934,7 +4058,7 @@ console.log('updated metadata', s.metadata);
 
         // re-build "buffered" array
         // HTML5 returns seconds. SM2 API uses msec for setPosition() etc., whether Flash or HTML5.
-        for (i=0, j=ranges.length; i<j; i++) {
+        for (i = 0, j = ranges.length; i < j; i++) {
           s.buffered.push({
             'start': ranges.start(i) * msecScale,
             'end': ranges.end(i) * msecScale
@@ -3945,20 +4069,20 @@ console.log('updated metadata', s.metadata);
         buffered = (ranges.end(0) - ranges.start(0)) * msecScale;
 
         // linear case, buffer sum; does not account for seeking and HTTP partials / byte ranges
-        loaded = Math.min(1, buffered/(e.target.duration*msecScale));
+        loaded = Math.min(1, buffered / (e.target.duration * msecScale));
 
         // <d>
         if (isProgress && ranges.length > 1) {
           progStr = [];
           j = ranges.length;
-          for (i=0; i<j; i++) {
-            progStr.push(e.target.buffered.start(i)*msecScale +'-'+ e.target.buffered.end(i)*msecScale);
+          for (i = 0; i < j; i++) {
+            progStr.push((e.target.buffered.start(i) * msecScale) + '-' + (e.target.buffered.end(i) * msecScale));
           }
           sm2._wD(this._s.id + ': progress, timeRanges: ' + progStr.join(', '));
         }
 
         if (isProgress && !isNaN(loaded)) {
-          sm2._wD(this._s.id + ': progress, ' + Math.floor(loaded*100) + '% loaded');
+          sm2._wD(this._s.id + ': progress, ' + Math.floor(loaded * 100) + '% loaded');
         }
         // </d>
 
@@ -4068,7 +4192,7 @@ console.log('updated metadata', s.metadata);
       oAudio.src = url;
 
       // reset some state, too
-      if (oAudio._called_unload !== undefined) {
+      if (oAudio._called_unload !== _undefined) {
         oAudio._called_load = false;
       }
 
@@ -4114,42 +4238,65 @@ console.log('updated metadata', s.metadata);
     }
 
     if (!html5Ext) {
+      
       html5Ext = [];
+      
       for (item in aF) {
+      
         if (aF.hasOwnProperty(item)) {
+      
           html5Ext.push(item);
+      
           if (aF[item].related) {
             html5Ext = html5Ext.concat(aF[item].related);
           }
+      
         }
+      
       }
+      
       html5Ext = new RegExp('\\.('+html5Ext.join('|')+')(\\?.*)?$','i');
+    
     }
 
     // TODO: Strip URL queries, etc.
     fileExt = (url ? url.toLowerCase().match(html5Ext) : null);
 
     if (!fileExt || !fileExt.length) {
+      
       if (!mime) {
+      
         result = false;
+      
       } else {
+      
         // audio/mp3 -> mp3, result should be known
         offset = mime.indexOf(';');
+      
         // strip "audio/X; codecs..."
-        fileExt = (offset !== -1?mime.substr(0,offset):mime).substr(6);
+        fileExt = (offset !== -1 ? mime.substr(0,offset) : mime).substr(6);
+      
       }
+    
     } else {
+    
       // match the raw extension name - "mp3", for example
       fileExt = fileExt[1];
+    
     }
 
     if (fileExt && sm2.html5[fileExt] !== _undefined) {
+    
       // result known
       result = (sm2.html5[fileExt] && !preferFlashCheck(fileExt));
+    
     } else {
-      mime = 'audio/'+fileExt;
+    
+      mime = 'audio/' + fileExt;
       result = sm2.html5.canPlayType({type:mime});
+    
       sm2.html5[fileExt] = result;
+    
       // sm2._wD('canPlayType, found result: ' + result);
       result = (result && sm2.html5[mime] && !preferFlashCheck(mime));
     }
@@ -4166,10 +4313,13 @@ console.log('updated metadata', s.metadata);
      */
 
     if (!sm2.useHTML5Audio || !sm2.hasHTML5) {
+    
       // without HTML5, we need Flash.
       sm2.html5.usingFlash = true;
       needsFlash = true;
+    
       return false;
+    
     }
 
     // double-whammy: Opera 9.64 throws WRONG_ARGUMENTS_ERR if no parameter passed to Audio(), and Webkit + iOS happily tries to load "null" as a URL. :/
@@ -4187,19 +4337,30 @@ console.log('updated metadata', s.metadata);
       }
 
       if (m instanceof Array) {
+    
         // iterate through all mime types, return any successes
-        for (i=0, j=m.length; i<j; i++) {
+    
+        for (i = 0, j = m.length; i < j; i++) {
+    
           if (sm2.html5[m[i]] || a.canPlayType(m[i]).match(sm2.html5Test)) {
+    
             isOK = true;
             sm2.html5[m[i]] = true;
+    
             // note flash support, too
             sm2.flash[m[i]] = !!(m[i].match(flashMIME));
+    
           }
+    
         }
+    
         result = isOK;
+    
       } else {
+    
         canPlay = (a && typeof a.canPlayType === 'function' ? a.canPlayType(m) : false);
         result = !!(canPlay && (canPlay.match(sm2.html5Test)));
+    
       }
 
       return result;
@@ -4238,10 +4399,10 @@ console.log('updated metadata', s.metadata);
 
         if (aF[item] && aF[item].related) {
 
-          for (i=aF[item].related.length-1; i >= 0; i--) {
+          for (i = aF[item].related.length - 1; i >= 0; i--) {
 
             // eg. audio/m4a
-            support['audio/'+aF[item].related[i]] = support[item];
+            support['audio/' + aF[item].related[i]] = support[item];
             sm2.html5[aF[item].related[i]] = support[item];
             sm2.flash[aF[item].related[i]] = support[item];
 
@@ -4253,7 +4414,7 @@ console.log('updated metadata', s.metadata);
 
     }
 
-    support.canPlayType = (a?cp:null);
+    support.canPlayType = (a ? cp : null);
     sm2.html5 = mixin(sm2.html5, support);
 
     sm2.html5.usingFlash = featureCheck();
@@ -4290,7 +4451,7 @@ console.log('updated metadata', s.metadata);
     shutdown: sm + '.disable(): Shutting down',
     queue: smc + 'Queueing %s handler',
     smError: 'SMSound.load(): Exception: JS-Flash communication failed, or JS error.',
-    fbTimeout: 'No flash response, applying .'+swfCSS.swfTimedout+' CSS...',
+    fbTimeout: 'No flash response, applying .' + swfCSS.swfTimedout + ' CSS...',
     fbLoaded: 'Flash loaded',
     fbHandler: smc + 'flashBlockHandler()',
     manURL: 'SMSound.load(): Using manually-assigned URL',
@@ -4311,7 +4472,8 @@ console.log('updated metadata', s.metadata);
     sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003),
     reset: sm + '.reset(): Removing event callbacks',
     mobileUA: 'Mobile UA detected, preferring HTML5 by default.',
-    globalHTML5: 'Using singleton HTML5 Audio() pattern for this device.'
+    globalHTML5: 'Using singleton HTML5 Audio() pattern for this device.',
+    ignoreMobile: 'Ignoring mobile restrictions for this device.'
     // </d>
 
   };
@@ -4419,16 +4581,23 @@ console.log('updated metadata', s.metadata);
     var urlParams = null, url;
 
     if (smURL) {
+      
       if (smURL.match(/\.swf(\?.*)?$/i)) {
+      
         urlParams = smURL.substr(smURL.toLowerCase().lastIndexOf('.swf?') + 4);
+      
         if (urlParams) {
           // assume user knows what they're doing
           return smURL;
         }
+      
       } else if (smURL.lastIndexOf('/') !== smURL.length - 1) {
+      
         // append trailing slash, if needed
         smURL += '/';
+      
       }
+    
     }
 
     url = (smURL && smURL.lastIndexOf('/') !== - 1 ? smURL.substr(0, smURL.lastIndexOf('/') + 1) : './') + sm2.movieURL;
@@ -4454,33 +4623,38 @@ console.log('updated metadata', s.metadata);
 
     // debug flash movie, if applicable
 
-    var isDebug = (sm2.debugMode || sm2.debugFlash?'_debug.swf':'.swf');
+    var isDebug = (sm2.debugMode || sm2.debugFlash ? '_debug.swf' : '.swf');
 
     if (sm2.useHTML5Audio && !sm2.html5Only && sm2.audioFormats.mp4.required && fV < 9) {
       sm2._wD(str('needfl9'));
       sm2.flashVersion = fV = 9;
     }
 
-    sm2.version = sm2.versionNumber + (sm2.html5Only?' (HTML5-only mode)':(fV === 9?' (AS3/Flash 9)':' (AS2/Flash 8)'));
+    sm2.version = sm2.versionNumber + (sm2.html5Only ? ' (HTML5-only mode)' : (fV === 9 ? ' (AS3/Flash 9)' : ' (AS2/Flash 8)'));
 
     // set up default options
     if (fV > 8) {
+    
       // +flash 9 base options
       sm2.defaultOptions = mixin(sm2.defaultOptions, sm2.flash9Options);
       sm2.features.buffering = true;
+    
       // +moviestar support
       sm2.defaultOptions = mixin(sm2.defaultOptions, sm2.movieStarOptions);
       sm2.filePatterns.flash9 = new RegExp('\\.(mp3|' + netStreamTypes.join('|') + ')(\\?.*)?$', 'i');
       sm2.features.movieStar = true;
+    
     } else {
+    
       sm2.features.movieStar = false;
+    
     }
 
     // regExp for flash canPlay(), etc.
-    sm2.filePattern = sm2.filePatterns[(fV !== 8?'flash9':'flash8')];
+    sm2.filePattern = sm2.filePatterns[(fV !== 8 ? 'flash9' : 'flash8')];
 
     // if applicable, use _debug versions of SWFs
-    sm2.movieURL = (fV === 8?'soundmanager2.swf':'soundmanager2_flash9.swf').replace('.swf', isDebug);
+    sm2.movieURL = (fV === 8 ? 'soundmanager2.swf' : 'soundmanager2_flash9.swf').replace('.swf', isDebug);
 
     sm2.features.peakData = sm2.features.waveformData = sm2.features.eqData = (fV > 8);
 
@@ -4503,7 +4677,7 @@ console.log('updated metadata', s.metadata);
     // allow force of debug mode via URL
     // <d>
     if (sm2.debugURLParam.test(wl)) {
-      sm2.debugMode = true;
+      sm2.setupOptions.debugMode = sm2.debugMode = true;
     }
 
     if (id(sm2.debugID)) {
@@ -4550,14 +4724,14 @@ console.log('updated metadata', s.metadata);
 
       oDebug = doc.createElement('div');
       oDebug.id = sm2.debugID;
-      oDebug.style.display = (sm2.debugMode?'block':'none');
+      oDebug.style.display = (sm2.debugMode ? 'block' : 'none');
 
       if (sm2.debugMode && !id(oD.id)) {
         try {
           oTarget = getDocument();
           oTarget.appendChild(oD);
         } catch(e2) {
-          throw new Error(str('domError')+' \n'+e2.toString());
+          throw new Error(str('domError') + ' \n' + e2.toString());
         }
         oTarget.appendChild(oDebug);
       }
@@ -4645,7 +4819,9 @@ console.log('updated metadata', s.metadata);
     var name = str('fbHandler'),
         p = sm2.getMoviePercent(),
         css = swfCSS,
-        error = {type:'FLASHBLOCK'};
+        error = {
+          type:'FLASHBLOCK'
+        };
 
     if (sm2.html5Only) {
       // no flash, or unused
@@ -4656,14 +4832,19 @@ console.log('updated metadata', s.metadata);
 
       if (needsFlash) {
         // make the movie more visible, so user can fix
-        sm2.oMC.className = getSWFCSS() + ' ' + css.swfDefault + ' ' + (p === null?css.swfTimedout:css.swfError);
+        sm2.oMC.className = getSWFCSS() + ' ' + css.swfDefault + ' ' + (p === null ? css.swfTimedout : css.swfError);
         sm2._wD(name + ': ' + str('fbTimeout') + (p ? ' (' + str('fbLoaded') + ')' : ''));
       }
 
       sm2.didFlashBlock = true;
 
       // fire onready(), complain lightly
-      processOnEvents({type:'ontimeout', ignoreInit:true, error:error});
+      processOnEvents({
+        type: 'ontimeout',
+        ignoreInit: true,
+        error: error
+      });
+
       catchError(error);
 
     } else {
@@ -4677,7 +4858,7 @@ console.log('updated metadata', s.metadata);
       // </d>
 
       if (sm2.oMC) {
-        sm2.oMC.className = [getSWFCSS(), css.swfDefault, css.swfLoaded + (sm2.didFlashBlock?' '+css.swfUnblocked:'')].join(' ');
+        sm2.oMC.className = [getSWFCSS(), css.swfDefault, css.swfLoaded + (sm2.didFlashBlock ? ' ' + css.swfUnblocked : '')].join(' ');
       }
 
     }
@@ -4719,11 +4900,11 @@ console.log('updated metadata', s.metadata);
     }
 
     var status = {
-          success: (oOptions && oOptions.ignoreInit?sm2.ok():!disabled)
+          success: (oOptions && oOptions.ignoreInit ? sm2.ok() : !disabled)
         },
 
         // queue specified by type, or none
-        srcQueue = (oOptions && oOptions.type?on_queue[oOptions.type]||[]:[]),
+        srcQueue = (oOptions && oOptions.type ? on_queue[oOptions.type] || [] : []),
 
         queue = [], i, j,
         args = [status],
@@ -4740,18 +4921,24 @@ console.log('updated metadata', s.metadata);
     }
 
     if (queue.length) {
-      // sm2._wD(sm + ': Firing ' + queue.length + ' ' + oOptions.type + '() item' + (queue.length === 1 ? '' : 's'));
+    
+      // sm2._wD(sm + ': Firing ' + queue.length + ' ' + oOptions.type + '() item' + (queue.length === 1 ? '' : 's')); 
       for (i = 0, j = queue.length; i < j; i++) {
+      
         if (queue[i].scope) {
           queue[i].method.apply(queue[i].scope, args);
         } else {
           queue[i].method.apply(this, args);
         }
+      
         if (!canRetry) {
           // useFlashBlock and SWF timeout case doesn't count here.
           queue[i].fired = true;
+      
         }
+      
       }
+    
     }
 
     return true;
@@ -4780,13 +4967,16 @@ console.log('updated metadata', s.metadata);
         event.add(window, 'load', initUserOnload);
       }
 
-    },1);
+    }, 1);
 
   };
 
   detectFlash = function() {
 
-    // hat tip: Flash Detect library (BSD, (C) 2007) by Carl "DocYes" S. Yestrau - http://featureblend.com/javascript-flash-detection-library.html / http://featureblend.com/license.txt
+    /**
+     * Hat tip: Flash Detect library (BSD, (C) 2007) by Carl "DocYes" S. Yestrau
+     * http://featureblend.com/javascript-flash-detection-library.html / http://featureblend.com/license.txt
+     */
 
     if (hasFlash !== _undefined) {
       // this work has already been done.
@@ -4796,12 +4986,16 @@ console.log('updated metadata', s.metadata);
     var hasPlugin = false, n = navigator, nP = n.plugins, obj, type, types, AX = window.ActiveXObject;
 
     if (nP && nP.length) {
+      
       type = 'application/x-shockwave-flash';
       types = n.mimeTypes;
+      
       if (types && types[type] && types[type].enabledPlugin && types[type].enabledPlugin.description) {
         hasPlugin = true;
       }
+    
     } else if (AX !== _undefined && !ua.match(/MSAppHost/i)) {
+    
       // Windows 8 Store Apps (MSAppHost) are weird (compatibility?) and won't complain here, but will barf if Flash/ActiveX object is appended to the DOM.
       try {
         obj = new AX('ShockwaveFlash.ShockwaveFlash');
@@ -4809,9 +5003,12 @@ console.log('updated metadata', s.metadata);
         // oh well
         obj = null;
       }
+      
       hasPlugin = (!!obj);
+      
       // cleanup, because it is ActiveX after all
       obj = null;
+    
     }
 
     hasFlash = hasPlugin;
@@ -4852,7 +5049,7 @@ featureCheck = function() {
 
         // <d>
         if (isBadSafari) {
-          sm2._wD(smc + 'Note: Buggy HTML5 Audio in Safari on this OS X release, see https://bugs.webkit.org/show_bug.cgi?id=32159 - ' + (!hasFlash ?' would use flash fallback for MP3/MP4, but none detected.' : 'will use flash fallback for MP3/MP4, if available'), 1);
+          sm2._wD(smc + 'Note: Buggy HTML5 Audio in Safari on this OS X release, see https://bugs.webkit.org/show_bug.cgi?id=32159 - ' + (!hasFlash ? ' would use flash fallback for MP3/MP4, but none detected.' : 'will use flash fallback for MP3/MP4, if available'), 1);
         }
         // </d>
 
@@ -4868,18 +5065,28 @@ featureCheck = function() {
       canIgnoreFlash = true;
 
       for (item in formats) {
+        
         if (formats.hasOwnProperty(item)) {
+        
           if (formats[item].required) {
+        
             if (!sm2.html5.canPlayType(formats[item].type)) {
+        
               // 100% HTML5 mode is not possible.
               canIgnoreFlash = false;
               flashNeeded = true;
+        
             } else if (sm2.preferFlash && (sm2.flash[item] || sm2.flash[formats[item].type])) {
+        
               // flash may be required, or preferred for this format.
               flashNeeded = true;
+        
             }
+        
           }
+
         }
+
       }
 
     }
@@ -4908,9 +5115,10 @@ featureCheck = function() {
     if (url instanceof Array) {
 
       // find the first good one
-      for (i=0, j=url.length; i<j; i++) {
+      for (i = 0, j = url.length; i < j; i++) {
 
         if (url[i] instanceof Object) {
+
           // MIME check
           if (sm2.canPlayMIME(url[i].type)) {
             urlResult = i;
@@ -4918,9 +5126,11 @@ featureCheck = function() {
           }
 
         } else if (sm2.canPlayURL(url[i])) {
+
           // URL string check
           urlResult = i;
           break;
+
         }
 
       }
@@ -4995,7 +5205,8 @@ featureCheck = function() {
   timerExecute = function() {
 
     /**
-     * manual polling for HTML5 progress events, ie., whileplaying() (can achieve greater precision than conservative default HTML5 interval)
+     * manual polling for HTML5 progress events, ie., whileplaying()
+     * (can achieve greater precision than conservative default HTML5 interval)
      */
 
     var i;
@@ -5014,12 +5225,10 @@ featureCheck = function() {
 
     // check all HTML5 sounds with timers
 
-    for (i = sm2.soundIDs.length-1; i >= 0; i--) {
+    for (i = sm2.soundIDs.length - 1; i >= 0; i--) {
 
       if (sm2.sounds[sm2.soundIDs[i]].isHTML5 && sm2.sounds[sm2.soundIDs[i]]._hasTimer) {
-
         sm2.sounds[sm2.soundIDs[i]]._onTimer();
-
       }
 
     }
@@ -5031,7 +5240,9 @@ featureCheck = function() {
     options = (options !== _undefined ? options : {});
 
     if (typeof sm2.onerror === 'function') {
-      sm2.onerror.apply(window, [{type:(options.type !== _undefined ? options.type : null)}]);
+      sm2.onerror.apply(window, [{
+        type: (options.type !== _undefined ? options.type : null)
+      }]);
     }
 
     if (options.fatal !== _undefined && options.fatal) {
@@ -5051,18 +5262,25 @@ featureCheck = function() {
     var aF = sm2.audioFormats, i, item;
 
     for (item in aF) {
+
       if (aF.hasOwnProperty(item)) {
+
         if (item === 'mp3' || item === 'mp4') {
+
           sm2._wD(sm + ': Using flash fallback for ' + item + ' format');
           sm2.html5[item] = false;
+
           // assign result to related formats, too
           if (aF[item] && aF[item].related) {
-            for (i = aF[item].related.length-1; i >= 0; i--) {
+            for (i = aF[item].related.length - 1; i >= 0; i--) {
               sm2.html5[aF[item].related[i]] = false;
             }
           }
+
         }
+
       }
+
     }
 
   };
@@ -5075,10 +5293,11 @@ featureCheck = function() {
   this._setSandboxType = function(sandboxType) {
 
     // <d>
+    // Security sandbox according to Flash plugin
     var sb = sm2.sandbox;
 
     sb.type = sandboxType;
-    sb.description = sb.types[(sb.types[sandboxType] !== _undefined?sandboxType:'unknown')];
+    sb.description = sb.types[(sb.types[sandboxType] !== _undefined?sandboxType : 'unknown')];
 
     if (sb.type === 'localWithFile') {
 
@@ -5245,15 +5464,15 @@ featureCheck = function() {
     oEmbed, oMovie, tmp, movieHTML, oEl, s, x, sClass;
 
     isRTL = (html && html.dir && html.dir.match(/rtl/i));
-    smID = (smID === _undefined?sm2.id:smID);
+    smID = (smID === _undefined ? sm2.id : smID);
 
     function param(name, value) {
-      return '<param name="'+name+'" value="'+value+'" />';
+      return '<param name="' + name + '" value="' + value + '" />';
     }
 
     // safety check for legacy (change to Flash 9 URL)
     setVersionInfo();
-    sm2.url = normalizeMovieURL(overHTTP?remoteURL:localURL);
+    sm2.url = normalizeMovieURL(overHTTP ? remoteURL : localURL);
     smURL = sm2.url;
 
     sm2.wmode = (!sm2.wmode && sm2.useHighPerformance ? 'transparent' : sm2.wmode);
@@ -5275,7 +5494,7 @@ featureCheck = function() {
       'quality': 'high',
       'allowScriptAccess': sm2.allowScriptAccess,
       'bgcolor': sm2.bgColor,
-      'pluginspage': http+'www.macromedia.com/go/getflashplayer',
+      'pluginspage': http + 'www.macromedia.com/go/getflashplayer',
       'title': swfTitle,
       'type': 'application/x-shockwave-flash',
       'wmode': sm2.wmode,
@@ -5297,7 +5516,7 @@ featureCheck = function() {
       // IE is "special".
       oMovie = doc.createElement('div');
       movieHTML = [
-        '<object id="' + smID + '" data="' + smURL + '" type="' + oEmbed.type + '" title="' + oEmbed.title +'" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="' + http+'download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,40,0">',
+        '<object id="' + smID + '" data="' + smURL + '" type="' + oEmbed.type + '" title="' + oEmbed.title +'" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,40,0">',
         param('movie', smURL),
         param('AllowScriptAccess', sm2.allowScriptAccess),
         param('quality', oEmbed.quality),
@@ -5356,7 +5575,7 @@ featureCheck = function() {
               'left': '-9999px'
             };
             if (isRTL) {
-              s.left = Math.abs(parseInt(s.left,10))+'px';
+              s.left = Math.abs(parseInt(s.left, 10)) + 'px';
             }
           }
         }
@@ -5375,31 +5594,40 @@ featureCheck = function() {
         }
 
         try {
+
           if (!isIE) {
             sm2.oMC.appendChild(oMovie);
           }
+
           oTarget.appendChild(sm2.oMC);
+
           if (isIE) {
             oEl = sm2.oMC.appendChild(doc.createElement('div'));
             oEl.className = swfCSS.swfBox;
             oEl.innerHTML = movieHTML;
           }
+
           appendSuccess = true;
+
         } catch(e) {
-          throw new Error(str('domError')+' \n'+e.toString());
+
+          throw new Error(str('domError') + ' \n' + e.toString());
+
         }
 
       } else {
 
         // SM2 container is already in the document (eg. flashblock use case)
         sClass = sm2.oMC.className;
-        sm2.oMC.className = (sClass?sClass+' ':swfCSS.swfDefault) + (extraClass?' '+extraClass:'');
+        sm2.oMC.className = (sClass ? sClass + ' ' : swfCSS.swfDefault) + (extraClass ? ' ' + extraClass : '');
         sm2.oMC.appendChild(oMovie);
+
         if (isIE) {
           oEl = sm2.oMC.appendChild(doc.createElement('div'));
           oEl.className = swfCSS.swfBox;
           oEl.innerHTML = movieHTML;
         }
+
         appendSuccess = true;
 
       }
@@ -5407,7 +5635,9 @@ featureCheck = function() {
     }
 
     didAppend = true;
+
     initMsg();
+
     // sm2._wD(sm + ': Trying to load ' + smURL + (!overHTTP && sm2.altURL ? ' (alternate URL)' : ''), 1);
 
     return true;
@@ -5443,20 +5673,28 @@ featureCheck = function() {
     flash = sm2.getMovie(sm2.id);
 
     if (!flash) {
+
       if (!oRemoved) {
+
         // try to create
         createMovie(sm2.id, sm2.url);
+
       } else {
+
         // try to re-append removed movie after reboot()
         if (!isIE) {
           sm2.oMC.appendChild(oRemoved);
         } else {
           sm2.oMC.innerHTML = oRemovedHTML;
         }
+
         oRemoved = null;
         didAppend = true;
+
       }
+
       flash = sm2.getMovie(sm2.id);
+
     }
 
     if (typeof sm2.oninitmovie === 'function') {
@@ -5543,7 +5781,7 @@ featureCheck = function() {
       // <d>
       if (!didInit) {
 
-        sm2._wD(sm + ': No Flash response within expected time. Likely causes: ' + (p === 0 ? 'SWF load failed, ':'') + 'Flash blocked or JS-Flash security error.' + (sm2.debugFlash?' ' + str('checkSWF'):''), 2);
+        sm2._wD(sm + ': No Flash response within expected time. Likely causes: ' + (p === 0 ? 'SWF load failed, ' : '') + 'Flash blocked or JS-Flash security error.' + (sm2.debugFlash ? ' ' + str('checkSWF') : ''), 2);
 
         if (!overHTTP && p) {
 
@@ -5562,7 +5800,7 @@ featureCheck = function() {
 
         }
 
-        debugTS('flashtojs', false, ': Timed out' + overHTTP?' (Check flash security or flash blockers)':' (No plugin/missing SWF?)');
+        debugTS('flashtojs', false, ': Timed out' + (overHTTP ? ' (Check flash security or flash blockers)':' (No plugin/missing SWF?)'));
 
       }
       // </d>
@@ -5598,7 +5836,13 @@ featureCheck = function() {
               _wDS('waitForever');
 
               // fire any regular registered ontimeout() listeners.
-              processOnEvents({type:'ontimeout', ignoreInit: true, error: {type: 'INIT_FLASHBLOCK'}});
+              processOnEvents({
+                type: 'ontimeout',
+                ignoreInit: true,
+                error: {
+                  type: 'INIT_FLASHBLOCK'
+                }
+              });
 
             }
 
@@ -5686,7 +5930,7 @@ featureCheck = function() {
     if (sm2.useHTML5Audio && sm2.hasHTML5) {
       for (item in sm2.audioFormats) {
         if (sm2.audioFormats.hasOwnProperty(item)) {
-          tests.push(item + ' = ' + sm2.html5[item] + (!sm2.html5[item] && needsFlash && sm2.flash[item] ? ' (using flash)' : (sm2.preferFlash && sm2.flash[item] && needsFlash ? ' (preferring flash)': (!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ':'') + 'and no flash support)' : ''))));
+          tests.push(item + ' = ' + sm2.html5[item] + (!sm2.html5[item] && needsFlash && sm2.flash[item] ? ' (using flash)' : (sm2.preferFlash && sm2.flash[item] && needsFlash ? ' (preferring flash)' : (!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') + 'and no flash support)' : ''))));
         }
       }
       sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1);
@@ -5719,34 +5963,54 @@ featureCheck = function() {
       didInit = true;
     }
 
-    error = {type: (!hasFlash && needsFlash ? 'NO_FLASH' : 'INIT_TIMEOUT')};
+    error = {
+      type: (!hasFlash && needsFlash ? 'NO_FLASH' : 'INIT_TIMEOUT')
+    };
 
     sm2._wD('SoundManager 2 ' + (disabled ? 'failed to load' : 'loaded') + ' (' + (disabled ? 'Flash security/load error' : 'OK') + ') ' + String.fromCharCode(disabled ? 10006 : 10003), disabled ? 2: 1);
 
     if (disabled || bNoDisable) {
+
       if (sm2.useFlashBlock && sm2.oMC) {
-        sm2.oMC.className = getSWFCSS() + ' ' + (sm2.getMoviePercent() === null?swfCSS.swfTimedout:swfCSS.swfError);
+        sm2.oMC.className = getSWFCSS() + ' ' + (sm2.getMoviePercent() === null ? swfCSS.swfTimedout : swfCSS.swfError);
       }
-      processOnEvents({type:'ontimeout', error:error, ignoreInit: true});
+
+      processOnEvents({
+        type: 'ontimeout',
+        error: error,
+        ignoreInit: true
+      });
+
       debugTS('onload', false);
       catchError(error);
+
       result = false;
+
     } else {
+
       debugTS('onload', true);
+
     }
 
     if (!disabled) {
+
       if (sm2.waitForWindowLoad && !windowLoaded) {
+
         _wDS('waitOnload');
         event.add(window, 'load', initUserOnload);
+
       } else {
+
         // <d>
         if (sm2.waitForWindowLoad && windowLoaded) {
           _wDS('docLoaded');
         }
         // </d>
+
         initUserOnload();
+
       }
+
     }
 
     return result;
@@ -5801,13 +6065,16 @@ featureCheck = function() {
     }
 
     if (sm2.html5Only) {
+
       if (!didInit) {
         // we don't need no steenking flash!
         cleanup();
         sm2.enabled = true;
         initComplete();
       }
+
       return true;
+
     }
 
     // flash path
@@ -5818,8 +6085,10 @@ featureCheck = function() {
       // attempt to talk to Flash
       flash._externalInterfaceTest(false);
 
-      // apply user-specified polling interval, OR, if "high performance" set, faster vs. default polling
-      // (determines frequency of whileloading/whileplaying callbacks, effectively driving UI framerates)
+      /**
+       * Apply user-specified polling interval, OR, if "high performance" set, faster vs. default polling
+       * (determines frequency of whileloading/whileplaying callbacks, effectively driving UI framerates)
+       */
       setPolling(true, (sm2.flashPollingInterval || (sm2.useHighPerformance ? 10 : 50)));
 
       if (!sm2.debugMode) {
@@ -5839,10 +6108,17 @@ featureCheck = function() {
     } catch(e) {
 
       sm2._wD('js/flash exception: ' + e.toString());
+
       debugTS('jstoflash', false);
-      catchError({type:'JS_TO_FLASH_EXCEPTION', fatal:true});
+
+      catchError({
+        type: 'JS_TO_FLASH_EXCEPTION',
+        fatal: true
+      });
+
       // don't disable, for reboot()
       failSafely(true);
+
       initComplete();
 
       return false;
@@ -5871,61 +6147,31 @@ featureCheck = function() {
 
     initDebug();
 
-    /**
-     * Temporary feature: allow force of HTML5 via URL params: sm2-usehtml5audio=0 or 1
-     * Ditto for sm2-preferFlash, too.
-     */
-    // <d>
-    (function(){
-
-      var a = 'sm2-usehtml5audio=',
-          a2 = 'sm2-preferflash=',
-          b = null,
-          b2 = null,
-          l = wl.toLowerCase();
-
-      if (l.indexOf(a) !== -1) {
-        b = (l.charAt(l.indexOf(a)+a.length) === '1');
-        if (hasConsole) {
-          console.log((b?'Enabling ':'Disabling ')+'useHTML5Audio via URL parameter');
-        }
-        sm2.setup({
-          'useHTML5Audio': b
-        });
-      }
-
-      if (l.indexOf(a2) !== -1) {
-        b2 = (l.charAt(l.indexOf(a2)+a2.length) === '1');
-        if (hasConsole) {
-          console.log((b2?'Enabling ':'Disabling ')+'preferFlash via URL parameter');
-        }
-        sm2.setup({
-          'preferFlash': b2
-        });
-      }
-
-    }());
-    // </d>
-
     if (!hasFlash && sm2.hasHTML5) {
+
       sm2._wD('SoundManager 2: No Flash detected' + (!sm2.useHTML5Audio ? ', enabling HTML5.' : '. Trying HTML5-only mode.'), 1);
+
       sm2.setup({
         'useHTML5Audio': true,
         // make sure we aren't preferring flash, either
         // TODO: preferFlash should not matter if flash is not installed. Currently, stuff breaks without the below tweak.
         'preferFlash': false
       });
+
     }
 
     testHTML5();
 
     if (!hasFlash && needsFlash) {
+
       messages.push(strings.needFlash);
+
       // TODO: Fatal here vs. timeout approach, etc.
       // hack: fail sooner.
       sm2.setup({
         'flashLoadTimeout': 1
       });
+
     }
 
     if (doc.removeEventListener) {
@@ -5961,44 +6207,6 @@ featureCheck = function() {
 
   };
 
-  /**
-   * miscellaneous run-time, pre-init stuff
-   */
-
-  preInit = function() {
-
-    if (mobileHTML5) {
-
-      // prefer HTML5 for mobile + tablet-like devices, probably more reliable vs. flash at this point.
-
-      // <d>
-      if (!sm2.setupOptions.useHTML5Audio || sm2.setupOptions.preferFlash) {
-        // notify that defaults are being changed.
-        messages.push(strings.mobileUA);
-      }
-      // </d>
-
-      sm2.setupOptions.useHTML5Audio = true;
-      sm2.setupOptions.preferFlash = false;
-
-      if (is_iDevice || (isAndroid && !ua.match(/android\s2\.3/i))) {
-        // iOS and Android devices tend to work better with a single audio instance, specifically for chained playback of sounds in sequence.
-        // common use case: exiting sound onfinish() -> createSound() -> play()
-        // <d>
-        messages.push(strings.globalHTML5);
-        // </d>
-        if (is_iDevice) {
-          sm2.ignoreFlash = true;
-        }
-        useGlobalHTML5Audio = true;
-      }
-
-    }
-
-  };
-
-  preInit();
-
   // sniff up-front
   detectFlash();
 
@@ -6019,7 +6227,10 @@ featureCheck = function() {
 
     // no add/attachevent support - safe to assume no JS -> Flash either
     debugTS('onload', false);
-    catchError({type:'NO_DOM2_EVENTS', fatal:true});
+    catchError({
+      type: 'NO_DOM2_EVENTS',
+      fatal: true
+    });
 
   }
 
@@ -6027,7 +6238,7 @@ featureCheck = function() {
 
 // SM2_DEFER details: http://www.schillmania.com/projects/soundmanager2/doc/getstarted/#lazy-loading
 
-if (window.SM2_DEFER === undefined || !SM2_DEFER) {
+if (window.SM2_DEFER === _undefined || !SM2_DEFER) {
   soundManager = new SoundManager();
 }
 
@@ -6040,33 +6251,75 @@ if (typeof module === 'object' && module && typeof module.exports === 'object')
 
   /**
    * commonJS module
-   * note: SM2 requires a window global due to Flash, which makes calls to window.soundManager.
-   * flash may not always be needed, but this is not known until async init and SM2 may even "reboot" into Flash mode.
    */
 
-  window.soundManager = soundManager;
-
   module.exports.SoundManager = SoundManager;
   module.exports.soundManager = soundManager;
 
 } else if (typeof define === 'function' && define.amd) {
 
-  // AMD - requireJS
+  /**
+   * AMD - requireJS
+   * basic usage:
+   * require(["/path/to/soundmanager2.js"], function(SoundManager) {
+   *   SoundManager.getInstance().setup({
+   *     url: '/swf/',
+   *     onready: function() { ... }
+   *   })
+   * });
+   *
+   * SM2_DEFER usage:
+   * window.SM2_DEFER = true;
+   * require(["/path/to/soundmanager2.js"], function(SoundManager) {
+   *   SoundManager.getInstance(function() {
+   *     var soundManager = new SoundManager.constructor();
+   *     soundManager.setup({
+   *       url: '/swf/',
+   *       ...
+   *     });
+   *     ...
+   *     soundManager.beginDelayedInit();
+   *     return soundManager;
+   *   })
+   * }); 
+   */
 
-  define('SoundManager', [], function() {
+  define(function() {
+    /**
+     * Retrieve the global instance of SoundManager.
+     * If a global instance does not exist it can be created using a callback.
+     *
+     * @param {Function} smBuilder Optional: Callback used to create a new SoundManager instance
+     * @return {SoundManager} The global SoundManager instance
+     */
+    function getInstance(smBuilder) {
+      if (!window.soundManager && smBuilder instanceof Function) {
+        var instance = smBuilder(SoundManager);
+        if (instance instanceof SoundManager) {
+          window.soundManager = instance;
+        }
+      }
+      return window.soundManager;
+    }
     return {
-      SoundManager: SoundManager,
-      soundManager: soundManager
-    };
+      constructor: SoundManager,
+      getInstance: getInstance
+    }
   });
 
-} else {
+}
 
-  // standard browser case
+// standard browser case
 
-  window.SoundManager = SoundManager; // constructor
-  window.soundManager = soundManager; // public API, flash callbacks etc.
+// constructor
+window.SoundManager = SoundManager;
 
-}
+/**
+ * note: SM2 requires a window global due to Flash, which makes calls to window.soundManager.
+ * Flash may not always be needed, but this is not known until async init and SM2 may even "reboot" into Flash mode.
+ */
+
+// public API, flash callbacks etc.
+window.soundManager = soundManager;
 
 }(window));