From bbcf96e69d0eb39d1de9c804b51c3c6ca00a9f66 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 8 Jul 2017 10:20:25 -0700 Subject: [PATCH 01/59] Copying soundmanager2.js -> soundmanager2-html5.js (no code changes yet) --- script/soundmanager2-html5.js | 6294 +++++++++++++++++++++++++++++++++ 1 file changed, 6294 insertions(+) create mode 100644 script/soundmanager2-html5.js diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js new file mode 100644 index 00000000..d38b38d5 --- /dev/null +++ b/script/soundmanager2-html5.js @@ -0,0 +1,6294 @@ +/** @license + * + * SoundManager 2: JavaScript Sound for the Web + * ---------------------------------------------- + * http://schillmania.com/projects/soundmanager2/ + * + * Copyright (c) 2007, Scott Schiller. All rights reserved. + * Code provided under the BSD License: + * http://schillmania.com/projects/soundmanager2/license.txt + * + * V2.97a.20170601 + */ + +/** + * About this file + * ------------------------------------------------------------------------------------- + * This is the fully-commented source version of the SoundManager 2 API, + * recommended for use during development and testing. + * + * See soundmanager2-nodebug-jsmin.js for an optimized build (~11KB with gzip.) + * http://schillmania.com/projects/soundmanager2/doc/getstarted/#basic-inclusion + * Alternately, serve this file with gzip for 75% compression savings (~30KB over HTTP.) + * + * You may notice and comments in this source; these are delimiters for + * debug blocks which are removed in the -nodebug builds, further optimizing code size. + * + * Also, as you may note: Whoa, reliable cross-platform/device audio support is hard! ;) + */ + +(function SM2(window, _undefined) { + +/* global Audio, document, window, navigator, define, module, SM2_DEFER, opera, setTimeout, setInterval, clearTimeout, sm2Debugger */ + +'use strict'; + +if (!window || !window.document) { + + // Don't cross the [environment] streams. SM2 expects to be running in a browser, not under node.js etc. + // Additionally, if a browser somehow manages to fail this test, as Egon said: "It would be bad." + + throw new Error('SoundManager requires a browser with window and document objects.'); + +} + +var soundManager = null; + +/** + * The SoundManager constructor. + * + * @constructor + * @param {string} smURL Optional: Path to SWF files + * @param {string} smID Optional: The ID to use for the SWF container element + * @this {SoundManager} + * @return {SoundManager} The new SoundManager instance + */ + +function SoundManager(smURL, smID) { + + /** + * soundManager configuration options list + * defines top-level configuration properties to be applied to the soundManager instance (eg. soundManager.flashVersion) + * to set these properties, use the setup() method - eg., soundManager.setup({url: '/swf/', flashVersion: 9}) + */ + + this.setupOptions = { + + url: (smURL || null), // path (directory) where SoundManager 2 SWFs exist, eg., /path/to/swfs/ + flashVersion: 8, // flash build to use (8 or 9.) Some API features require 9. + debugMode: true, // enable debugging output (console.log() with HTML fallback) + debugFlash: false, // enable debugging output inside SWF, troubleshoot Flash/browser issues + useConsole: true, // use console.log() if available (otherwise, writes to #soundmanager-debug element) + consoleOnly: true, // if console is being used, do not create/write to #soundmanager-debug + waitForWindowLoad: false, // force SM2 to wait for window.onload() before trying to call soundManager.onload() + bgColor: '#ffffff', // SWF background color. N/A when wmode = 'transparent' + useHighPerformance: false, // position:fixed flash movie can help increase js/flash speed, minimize lag + flashPollingInterval: null, // msec affecting whileplaying/loading callback frequency. If null, default of 50 msec is used. + html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. + flashLoadTimeout: 1000, // msec to wait for flash movie to load before failing (0 = infinity) + 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 (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. + idPrefix: 'sound' // if an id is not provided to createSound(), this prefix is used for generated IDs - 'sound0', 'sound1' etc. + + }; + + this.defaultOptions = { + + /** + * the default configuration for sound objects made with createSound() and related methods + * eg., volume, auto-load behaviour and so forth + */ + + autoLoad: false, // enable automatic loading (otherwise .load() will be called on demand with .play(), the latter being nicer on bandwidth - if you want to .load yourself, you also can) + autoPlay: false, // enable playing of file as soon as possible (much faster if "stream" is true) + from: null, // position to start playback within a sound (msec), default = beginning + loops: 1, // how many times to repeat the sound (position will wrap around to 0, setPosition() will break out of loop when >0) + onid3: null, // callback function for "ID3 data is added/available" + onerror: null, // callback function for "load failed" (or, playback/network/decode error under HTML5.) + onload: null, // callback function for "load finished" + whileloading: null, // callback function for "download progress update" (X of Y bytes received) + onplay: null, // callback for "play" start + onpause: null, // callback for "pause" + onresume: null, // callback for "resume" (pause toggle) + whileplaying: null, // callback during play (position update) + onposition: null, // object containing times and function callbacks for positions of interest + onstop: null, // callback for "user stop" + onfinish: null, // callback function for "sound finished playing" + multiShot: true, // let sounds "restart" or layer on top of each other when played multiple times, rather than one-shot/one at a time + multiShotEvents: false, // fire multiple sound events (currently onfinish() only) when multiShot is enabled + position: null, // offset (milliseconds) to seek to within loaded sound data. + pan: 0, // "pan" settings, left-to-right, -100 to 100 + playbackRate: 1, // rate at which to play the sound (HTML5-only) + stream: true, // allows playing before entire file has loaded (recommended) + to: null, // position to end playback within a sound (msec), default = end + type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 + usePolicyFile: false, // enable crossdomain.xml request for audio on remote domains (for ID3/waveform access) + volume: 100 // self-explanatory. 0-100, the latter being the max. + + }; + + this.flash9Options = { + + /** + * flash 9-only options, + * merged into defaultOptions if flash 9 is being used + */ + + onfailure: null, // callback function for when playing fails (Flash 9, MovieStar + RTMP-only) + isMovieStar: null, // "MovieStar" MPEG4 audio mode. Null (default) = auto detect MP4, AAC etc. based on URL. true = force on, ignore URL + usePeakData: false, // enable left/right channel peak (level) data + useWaveformData: false, // enable sound spectrum (raw waveform data) - NOTE: May increase CPU load. + useEQData: false, // enable sound EQ (frequency spectrum data) - NOTE: May increase CPU load. + onbufferchange: null, // callback for "isBuffering" property change + ondataerror: null // callback for waveform/eq data access error (flash playing audio in other tabs/domains) + + }; + + this.movieStarOptions = { + + /** + * flash 9.0r115+ MPEG4 audio options, + * merged into defaultOptions if flash 9+movieStar mode is enabled + */ + + bufferTime: 3, // seconds of data to buffer before playback begins (null = flash default of 0.1 seconds - if AAC playback is gappy, try increasing.) + serverURL: null, // rtmp: FMS or FMIS server to connect to, required when requesting media via RTMP or one of its variants + onconnect: null, // rtmp: callback for connection to flash media server + duration: null // rtmp: song duration (msec) + + }; + + this.audioFormats = { + + /** + * determines HTML5 support + flash requirements. + * if no support (via flash and/or HTML5) for a "required" format, SM2 will fail to start. + * flash fallback is used for MP3 or MP4 if HTML5 can't play it (or if preferFlash = true) + */ + + mp3: { + type: ['audio/mpeg; codecs="mp3"', 'audio/mpeg', 'audio/mp3', 'audio/MPA', 'audio/mpa-robust'], + required: true + }, + + mp4: { + related: ['aac', 'm4a', 'm4b'], // additional formats under the MP4 container + type: ['audio/mp4; codecs="mp4a.40.2"', 'audio/aac', 'audio/x-m4a', 'audio/MP4A-LATM', 'audio/mpeg4-generic'], + required: false + }, + + ogg: { + type: ['audio/ogg; codecs=vorbis'], + required: false + }, + + opus: { + type: ['audio/ogg; codecs=opus', 'audio/opus'], + required: false + }, + + wav: { + type: ['audio/wav; codecs="1"', 'audio/wav', 'audio/wave', 'audio/x-wav'], + required: false + }, + + flac: { + type: ['audio/flac'], + required: false + } + + }; + + // HTML attributes (id + class names) for the SWF container + + this.movieID = 'sm2-container'; + this.id = (smID || 'sm2movie'); + + this.debugID = 'soundmanager-debug'; + this.debugURLParam = /([#?&])debug=1/i; + + // dynamic attributes + + this.versionNumber = 'V2.97a.20170601'; + this.version = null; + this.movieURL = null; + this.altURL = null; + this.swfLoaded = false; + this.enabled = false; + this.oMC = null; + this.sounds = {}; + this.soundIDs = []; + this.muted = false; + this.didFlashBlock = false; + 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 = { + // + type: null, + types: { + remote: 'remote (domain-based) rules', + localWithFile: 'local with file access (no internet access)', + localWithNetwork: 'local with network (internet access only, no local access)', + localTrusted: 'local, trusted (local+internet access)' + }, + description: null, + noRemote: null, + noLocal: null + // + }; + + /** + * format support (html5/flash) + * stores canPlayType() results based on audioFormats. + * eg. { mp3: boolean, mp4: boolean } + * treat as read-only. + */ + + this.html5 = { + usingFlash: null // set if/when flash fallback is needed + }; + + // file type support hash + this.flash = {}; + + // determined at init time + this.html5Only = false; + + // used for special cases (eg. iPad/iPhone/palm OS?) + this.ignoreFlash = false; + + /** + * a few private internals (OK, a lot. :D) + */ + + 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, 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, html5ErrorCodes, 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|trident/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\sX\s10_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, + 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), + http = (!overHTTP ? '//' : ''), + // mp3, mp4, aac etc. + netStreamMimeTypes = /^\s*audio\/(?:x-)?(?:mpeg4|aac|flv|mov|mp4|m4v|m4a|m4b|mp4v|3gp|3g2)\s*(?:$|;)/i, + // Flash v9.0r115+ "moviestar" formats + netStreamTypes = ['mpeg4', 'aac', 'flv', 'mov', 'mp4', 'm4v', 'f4v', 'm4a', 'm4b', 'mp4v', '3gp', '3g2'], + netStreamPattern = new RegExp('\\.(' + netStreamTypes.join('|') + ')(\\?.*)?$', 'i'); + + this.mimePattern = /^\s*audio\/(?:x-)?(?:mp(?:eg|3))\s*(?:$|;)/i; // default mp3 set + + // use altURL if not "online" + this.useAltURL = !overHTTP; + + swfCSS = { + swfBox: 'sm2-object-box', + swfDefault: 'movieContainer', + swfError: 'swf_error', // SWF loaded, but SM2 couldn't start (other error) + swfTimedout: 'swf_timedout', + swfLoaded: 'swf_loaded', + swfUnblocked: 'swf_unblocked', // or loaded OK + sm2Debug: 'sm2_debug', + highPerf: 'high_performance', + flashDebug: 'flash_debug' + }; + + /** + * HTML5 error codes, per W3C + * Error code 1, MEDIA_ERR_ABORTED: Client aborted download at user's request. + * Error code 2, MEDIA_ERR_NETWORK: A network error of some description caused the user agent to stop fetching the media resource, after the resource was established to be usable. + * Error code 3, MEDIA_ERR_DECODE: An error of some description occurred while decoding the media resource, after the resource was established to be usable. + * Error code 4, MEDIA_ERR_SRC_NOT_SUPPORTED: Media (audio file) not supported ("not usable.") + * Reference: https://html.spec.whatwg.org/multipage/embedded-content.html#error-codes + */ + html5ErrorCodes = [ + null, + 'MEDIA_ERR_ABORTED', + 'MEDIA_ERR_NETWORK', + 'MEDIA_ERR_DECODE', + 'MEDIA_ERR_SRC_NOT_SUPPORTED' + ]; + + /** + * basic HTML5 Audio() support test + * try...catch because of IE 9 "not implemented" nonsense + * https://github.com/Modernizr/Modernizr/issues/224 + */ + + this.hasHTML5 = (function() { + try { + // new Audio(null) for stupid Opera 9.64 case, which throws not_enough_arguments exception otherwise. + return (Audio !== _undefined && (isOpera && opera !== _undefined && opera.version() < 10 ? new Audio(null) : new Audio()).canPlayType !== _undefined); + } catch(e) { + return false; + } + }()); + + /** + * Public SoundManager API + * ----------------------- + */ + + /** + * Configures top-level soundManager properties. + * + * @param {object} options Option parameters, eg. { flashVersion: 9, url: '/path/to/swfs/' } + * onready and ontimeout are also accepted parameters. call soundManager.setup() to see the full list. + */ + + this.setup = function(options) { + + var noURL = (!sm2.url); + + // warn if flash options have already been applied + + if (options !== _undefined && didInit && needsFlash && sm2.ok() && (options.flashVersion !== _undefined || options.url !== _undefined || options.html5Test !== _undefined)) { + complain(str('setupLate')); + } + + // TODO: defer: true? + + 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 if (sm2.setupOptions.forceUseGlobalHTML5Audio) { + + // only apply singleton HTML5 on desktop if forced. + 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. + + // + if (!sm2.setupOptions.useHTML5Audio || sm2.setupOptions.preferFlash) { + // notify that defaults are being changed. + sm2._wD(strings.mobileUA); + } + // + + 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. + */ + + // + sm2._wD(strings.globalHTML5); + // + + 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) { + + if (noURL && didDCLoaded && options.url !== _undefined) { + sm2.beginDelayedInit(); + } + + // special case 2: If lazy-loading SM2 (DOMContentLoaded has already happened) and user calls setup() with url: parameter, try to init ASAP. + + if (!didDCLoaded && options.url !== _undefined && doc.readyState === 'complete') { + setTimeout(domContentLoaded, 1); + } + + } + + didSetup = true; + + return sm2; + + }; + + this.ok = function() { + + return (needsFlash ? (didInit && !disabled) : (sm2.useHTML5Audio && sm2.hasHTML5)); + + }; + + this.supported = this.ok; // legacy + + this.getMovie = function(movie_id) { + + // safety net: some old browsers differ on SWF references, possibly related to ExternalInterface / flash version + return id(movie_id) || doc[movie_id] || window[movie_id]; + + }; + + /** + * Creates a SMSound sound object instance. Can also be overloaded, e.g., createSound('mySound', '/some.mp3'); + * + * @param {object} oOptions Sound options (at minimum, url parameter is required.) + * @return {object} SMSound The new SMSound object. + */ + + this.createSound = function(oOptions, _url) { + + var cs, cs_string, options, oSound = null; + + // + cs = sm + '.createSound(): '; + cs_string = cs + str(!didInit ? 'notReady' : 'notOK'); + // + + if (!didInit || !sm2.ok()) { + complain(cs_string); + return false; + } + + if (_url !== _undefined) { + // function overloading in JS! :) ... assume simple createSound(id, url) use case. + oOptions = { + id: oOptions, + url: _url + }; + } + + // inherit from defaultOptions + options = mixin(oOptions); + + options.url = parseURL(options.url); + + // generate an id, if needed. + if (options.id === _undefined) { + options.id = sm2.setupOptions.idPrefix + (idCounter++); + } + + // + if (options.id.toString().charAt(0).match(/^[0-9]$/)) { + sm2._wD(cs + str('badID', options.id), 2); + } + + sm2._wD(cs + options.id + (options.url ? ' (' + options.url + ')' : ''), 1); + // + + if (idCheck(options.id, true)) { + sm2._wD(cs + options.id + ' exists', 1); + return sm2.sounds[options.id]; + } + + function make() { + + options = loopFix(options); + sm2.sounds[options.id] = new SMSound(options); + sm2.soundIDs.push(options.id); + return sm2.sounds[options.id]; + + } + + if (html5OK(options)) { + + oSound = make(); + // + if (!sm2.html5Only) { + sm2._wD(options.id + ': Using HTML5'); + } + // + oSound._setup_html5(options); + + } else { + + if (sm2.html5Only) { + sm2._wD(options.id + ': No HTML5 support for this sound, and no Flash. Exiting.'); + return make(); + } + + // TODO: Move HTML5/flash checks into generic URL parsing/handling function. + + if (sm2.html5.usingFlash && options.url && options.url.match(/data:/i)) { + // data: URIs not supported by Flash, either. + sm2._wD(options.id + ': data: URIs not supported via Flash. Exiting.'); + return make(); + } + + if (fV > 8) { + if (options.isMovieStar === null) { + // attempt to detect MPEG-4 formats + options.isMovieStar = !!(options.serverURL || (options.type ? options.type.match(netStreamMimeTypes) : false) || (options.url && options.url.match(netStreamPattern))); + } + // + if (options.isMovieStar) { + sm2._wD(cs + 'using MovieStar handling'); + if (options.loops > 1) { + _wDS('noNSLoop'); + } + } + // + } + + options = policyFix(options, cs); + oSound = make(); + + if (fV === 8) { + 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); + if (!options.serverURL) { + // We are connected immediately + oSound.connected = true; + if (options.onconnect) { + options.onconnect.apply(oSound); + } + } + } + + if (!options.serverURL && (options.autoLoad || options.autoPlay)) { + // call load for non-rtmp streams + oSound.load(options); + } + + } + + // rtmp will play in onconnect + if (!options.serverURL && options.autoPlay) { + oSound.play(); + } + + return oSound; + + }; + + /** + * Destroys a SMSound sound object instance. + * + * @param {string} sID The ID of the sound to destroy + */ + + this.destroySound = function(sID, _bFromSound) { + + // explicitly destroy a sound before normal page unload, etc. + + if (!idCheck(sID)) return false; + + var oS = sm2.sounds[sID], i; + + 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++) { + if (sm2.soundIDs[i] === sID) { + sm2.soundIDs.splice(i, 1); + break; + } + } + + if (!_bFromSound) { + // ignore if being called from SMSound instance + oS.destruct(true); + } + + oS = null; + delete sm2.sounds[sID]; + + return true; + + }; + + /** + * Calls the load() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @param {object} oOptions Optional: Sound options + */ + + this.load = function(sID, oOptions) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].load(oOptions); + + }; + + /** + * Calls the unload() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + */ + + this.unload = function(sID) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].unload(); + + }; + + /** + * Calls the onPosition() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @param {number} nPosition The position to watch for + * @param {function} oMethod The relevant callback to fire + * @param {object} oScope Optional: The scope to apply the callback to + * @return {SMSound} The SMSound object + */ + + this.onPosition = function(sID, nPosition, oMethod, oScope) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].onposition(nPosition, oMethod, oScope); + + }; + + // legacy/backwards-compability: lower-case method name + this.onposition = this.onPosition; + + /** + * Calls the clearOnPosition() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @param {number} nPosition The position to watch for + * @param {function} oMethod Optional: The relevant callback to fire + * @return {SMSound} The SMSound object + */ + + this.clearOnPosition = function(sID, nPosition, oMethod) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].clearOnPosition(nPosition, oMethod); + + }; + + /** + * Calls the play() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @param {object} oOptions Optional: Sound options + * @return {SMSound} The SMSound object + */ + + this.play = function(sID, oOptions) { + + var result = null, + // legacy function-overloading use case: play('mySound', '/path/to/some.mp3'); + overloaded = (oOptions && !(oOptions instanceof Object)); + + if (!didInit || !sm2.ok()) { + complain(sm + '.play(): ' + str(!didInit ? 'notReady' : 'notOK')); + return false; + } + + if (!idCheck(sID, overloaded)) { + + // no sound found for the given ID. Bail. + if (!overloaded) return false; + + if (overloaded) { + oOptions = { + url: oOptions + }; + } + + if (oOptions && oOptions.url) { + // overloading use case, create+play: .play('someID', {url:'/path/to.mp3'}); + sm2._wD(sm + '.play(): Attempting to create "' + sID + '"', 1); + oOptions.id = sID; + result = sm2.createSound(oOptions).play(); + } + + } else if (overloaded) { + + // existing sound object case + oOptions = { + url: oOptions + }; + + } + + if (result === null) { + // default case + result = sm2.sounds[sID].play(oOptions); + } + + return result; + + }; + + // just for convenience + this.start = this.play; + + /** + * Calls the setPlaybackRate() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.setPlaybackRate = function(sID, rate, allowOverride) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].setPlaybackRate(rate, allowOverride); + + }; + + /** + * Calls the setPosition() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @param {number} nMsecOffset Position (milliseconds) + * @return {SMSound} The SMSound object + */ + + this.setPosition = function(sID, nMsecOffset) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].setPosition(nMsecOffset); + + }; + + /** + * Calls the stop() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.stop = function(sID) { + + if (!idCheck(sID)) return false; + + sm2._wD(sm + '.stop(' + sID + ')', 1); + + return sm2.sounds[sID].stop(); + + }; + + /** + * Stops all currently-playing sounds. + */ + + this.stopAll = function() { + + var oSound; + sm2._wD(sm + '.stopAll()', 1); + + for (oSound in sm2.sounds) { + if (sm2.sounds.hasOwnProperty(oSound)) { + // apply only to sound objects + sm2.sounds[oSound].stop(); + } + } + + }; + + /** + * Calls the pause() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.pause = function(sID) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].pause(); + + }; + + /** + * Pauses all currently-playing sounds. + */ + + this.pauseAll = function() { + + var i; + for (i = sm2.soundIDs.length - 1; i >= 0; i--) { + sm2.sounds[sm2.soundIDs[i]].pause(); + } + + }; + + /** + * Calls the resume() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.resume = function(sID) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].resume(); + + }; + + /** + * Resumes all currently-paused sounds. + */ + + this.resumeAll = function() { + + var i; + for (i = sm2.soundIDs.length - 1; i >= 0; i--) { + sm2.sounds[sm2.soundIDs[i]].resume(); + } + + }; + + /** + * Calls the togglePause() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.togglePause = function(sID) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].togglePause(); + + }; + + /** + * Calls the setPan() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @param {number} nPan The pan value (-100 to 100) + * @return {SMSound} The SMSound object + */ + + this.setPan = function(sID, nPan) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].setPan(nPan); + + }; + + /** + * 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) + * @return {SMSound} The SMSound object + */ + + 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 false; + } + + // setVolume('mySound', 50) case + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].setVolume(nVol); + + }; + + /** + * Calls the mute() method of either a single SMSound object by ID, or all sound objects. + * + * @param {string} sID Optional: The ID of the sound (if omitted, all sounds will be used.) + */ + + this.mute = function(sID) { + + var i = 0; + + if (sID instanceof String) { + sID = null; + } + + if (!sID) { + + sm2._wD(sm + '.mute(): Muting all sounds'); + for (i = sm2.soundIDs.length - 1; i >= 0; i--) { + sm2.sounds[sm2.soundIDs[i]].mute(); + } + sm2.muted = true; + + } else { + + if (!idCheck(sID)) return false; + + sm2._wD(sm + '.mute(): Muting "' + sID + '"'); + return sm2.sounds[sID].mute(); + + } + + return true; + + }; + + /** + * Mutes all sounds. + */ + + this.muteAll = function() { + + sm2.mute(); + + }; + + /** + * Calls the unmute() method of either a single SMSound object by ID, or all sound objects. + * + * @param {string} sID Optional: The ID of the sound (if omitted, all sounds will be used.) + */ + + this.unmute = function(sID) { + + var i; + + if (sID instanceof String) { + sID = null; + } + + if (!sID) { + + sm2._wD(sm + '.unmute(): Unmuting all sounds'); + for (i = sm2.soundIDs.length - 1; i >= 0; i--) { + sm2.sounds[sm2.soundIDs[i]].unmute(); + } + sm2.muted = false; + + } else { + + if (!idCheck(sID)) return false; + + sm2._wD(sm + '.unmute(): Unmuting "' + sID + '"'); + + return sm2.sounds[sID].unmute(); + + } + + return true; + + }; + + /** + * Unmutes all sounds. + */ + + this.unmuteAll = function() { + + sm2.unmute(); + + }; + + /** + * Calls the toggleMute() method of a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.toggleMute = function(sID) { + + if (!idCheck(sID)) return false; + + return sm2.sounds[sID].toggleMute(); + + }; + + /** + * Retrieves the memory used by the flash plugin. + * + * @return {number} The amount of memory in use + */ + + this.getMemoryUse = function() { + + // flash-only + var ram = 0; + + if (flash && fV !== 8) { + ram = parseInt(flash._getMemoryUse(), 10); + } + + return ram; + + }; + + /** + * Undocumented: NOPs soundManager and all SMSound objects. + */ + + this.disable = function(bNoDisable) { + + // destroy all functions + var i; + + if (bNoDisable === _undefined) { + bNoDisable = false; + } + + // already disabled? + if (disabled) return false; + + disabled = true; + + _wDS('shutdown', 1); + + for (i = sm2.soundIDs.length - 1; i >= 0; i--) { + disableObject(sm2.sounds[sm2.soundIDs[i]]); + } + + disableObject(sm2); + + // fire "complete", despite fail + initComplete(bNoDisable); + + event.remove(window, 'load', initUserOnload); + + return true; + + }; + + /** + * Determines playability of a MIME type, eg. 'audio/mp3'. + */ + + this.canPlayMIME = function(sMIME) { + + var result; + + if (sm2.hasHTML5) { + result = html5CanPlay({ + type: sMIME + }); + } + + if (!result && needsFlash) { + // if flash 9, test netStream (movieStar) types as well. + result = (sMIME && sm2.ok() ? !!((fV > 8 ? sMIME.match(netStreamMimeTypes) : null) || sMIME.match(sm2.mimePattern)) : null); // TODO: make less "weird" (per JSLint) + } + + return result; + + }; + + /** + * Determines playability of a URL based on audio support. + * + * @param {string} sURL The URL to test + * @return {boolean} URL playability + */ + + this.canPlayURL = function(sURL) { + + var result; + + if (sm2.hasHTML5) { + result = html5CanPlay({ + url: sURL + }); + } + + if (!result && needsFlash) { + result = (sURL && sm2.ok() ? !!(sURL.match(sm2.filePattern)) : null); + } + + return result; + + }; + + /** + * Determines playability of an HTML DOM <a> object (or similar object literal) based on audio support. + * + * @param {object} oLink an HTML DOM <a> object or object literal including href and/or type attributes + * @return {boolean} URL playability + */ + + this.canPlayLink = function(oLink) { + + if (oLink.type !== _undefined && oLink.type && sm2.canPlayMIME(oLink.type)) return true; + + return sm2.canPlayURL(oLink.href); + + }; + + /** + * Retrieves a SMSound object by ID. + * + * @param {string} sID The ID of the sound + * @return {SMSound} The SMSound object + */ + + this.getSoundById = function(sID, _suppressDebug) { + + if (!sID) return null; + + var result = sm2.sounds[sID]; + + // + if (!result && !_suppressDebug) { + sm2._wD(sm + '.getSoundById(): Sound "' + sID + '" not found.', 2); + } + // + + return result; + + }; + + /** + * Queues a callback for execution when SoundManager has successfully initialized. + * + * @param {function} oMethod The callback method to fire + * @param {object} oScope Optional: The scope to apply to the callback + */ + + this.onready = function(oMethod, oScope) { + + var sType = 'onready', + result = false; + + if (typeof oMethod === 'function') { + + // + if (didInit) { + sm2._wD(str('queue', sType)); + } + // + + if (!oScope) { + oScope = window; + } + + addOnEvent(sType, oMethod, oScope); + processOnEvents(); + + result = true; + + } else { + + throw str('needFunction', sType); + + } + + return result; + + }; + + /** + * Queues a callback for execution when SoundManager has failed to initialize. + * + * @param {function} oMethod The callback method to fire + * @param {object} oScope Optional: The scope to apply to the callback + */ + + this.ontimeout = function(oMethod, oScope) { + + var sType = 'ontimeout', + result = false; + + if (typeof oMethod === 'function') { + + // + if (didInit) { + sm2._wD(str('queue', sType)); + } + // + + if (!oScope) { + oScope = window; + } + + addOnEvent(sType, oMethod, oScope); + processOnEvents({ type: sType }); + + result = true; + + } else { + + throw str('needFunction', sType); + + } + + return result; + + }; + + /** + * Writes console.log()-style debug output to a console or in-browser element. + * Applies when debugMode = true + * + * @param {string} sText The console message + * @param {object} nType Optional log level (number), or object. Number case: Log type/style where 0 = 'info', 1 = 'warn', 2 = 'error'. Object case: Object to be dumped. + */ + + this._writeDebug = function(sText, sTypeOrObject) { + + // pseudo-private console.log()-style output + // + + var sDID = 'soundmanager-debug', o, oItem; + + if (!sm2.setupOptions.debugMode) return false; + + if (hasConsole && sm2.useConsole) { + if (sTypeOrObject && typeof sTypeOrObject === 'object') { + // object passed; dump to console. + console.log(sText, sTypeOrObject); + } else if (debugLevels[sTypeOrObject] !== _undefined) { + console[debugLevels[sTypeOrObject]](sText); + } else { + console.log(sText); + } + if (sm2.consoleOnly) return true; + } + + o = id(sDID); + + if (!o) return false; + + oItem = doc.createElement('div'); + + if (++wdCount % 2 === 0) { + oItem.className = 'sm2-alt'; + } + + if (sTypeOrObject === _undefined) { + sTypeOrObject = 0; + } else { + sTypeOrObject = parseInt(sTypeOrObject, 10); + } + + oItem.appendChild(doc.createTextNode(sText)); + + if (sTypeOrObject) { + if (sTypeOrObject >= 2) { + oItem.style.fontWeight = 'bold'; + } + if (sTypeOrObject === 3) { + oItem.style.color = '#ff3333'; + } + } + + // top-to-bottom + // o.appendChild(oItem); + + // bottom-to-top + o.insertBefore(oItem, o.firstChild); + + o = null; + // + + return true; + + }; + + // + // last-resort debugging option + if (wl.indexOf('sm2-debug=alert') !== -1) { + this._writeDebug = function(sText) { + window.alert(sText); + }; + } + // + + // alias + this._wD = this._writeDebug; + + /** + * Provides debug / state information on all SMSound objects. + */ + + this._debug = function() { + + // + var i, j; + _wDS('currentObj', 1); + + for (i = 0, j = sm2.soundIDs.length; i < j; i++) { + sm2.sounds[sm2.soundIDs[i]]._debug(); + } + // + + }; + + /** + * Restarts and re-initializes the SoundManager instance. + * + * @param {boolean} resetEvents Optional: When true, removes all registered onready and ontimeout event callbacks. + * @param {boolean} excludeInit Options: When true, does not call beginDelayedInit() (which would restart SM2). + * @return {object} soundManager The soundManager instance. + */ + + this.reboot = function(resetEvents, excludeInit) { + + // reset some (or all) state, and re-init unless otherwise specified. + + // + if (sm2.soundIDs.length) { + sm2._wD('Destroying ' + sm2.soundIDs.length + ' SMSound object' + (sm2.soundIDs.length !== 1 ? 's' : '') + '...'); + } + // + + var i, j, k; + + for (i = sm2.soundIDs.length - 1; i >= 0; i--) { + sm2.sounds[sm2.soundIDs[i]].destruct(); + } + + // trash ze flash (remove from the DOM) + + if (flash) { + + try { + + if (isIE) { + oRemovedHTML = flash.innerHTML; + } + + oRemoved = flash.parentNode.removeChild(flash); + + } catch(e) { + + // Remove failed? May be due to flash blockers silently removing the SWF object/embed node from the DOM. Warn and continue. + + _wDS('badRemove', 2); + + } + + } + + // actually, force recreate of movie. + + oRemovedHTML = oRemoved = needsFlash = flash = null; + + sm2.enabled = didDCLoaded = didInit = waitingForEI = initPending = didAppend = appendSuccess = disabled = useGlobalHTML5Audio = sm2.swfLoaded = false; + + sm2.soundIDs = []; + sm2.sounds = {}; + + idCounter = 0; + didSetup = false; + + if (!resetEvents) { + // reset callbacks for onready, ontimeout etc. so that they will fire again on re-init + for (i in on_queue) { + if (on_queue.hasOwnProperty(i)) { + for (j = 0, k = on_queue[i].length; j < k; j++) { + on_queue[i][j].fired = false; + } + } + } + } else { + // remove all callbacks entirely + on_queue = []; + } + + // + if (!excludeInit) { + sm2._wD(sm + ': Rebooting...'); + } + // + + // reset HTML5 and flash canPlay test results + + sm2.html5 = { + usingFlash: null + }; + + sm2.flash = {}; + + // reset device-specific HTML/flash mode switches + + sm2.html5Only = false; + sm2.ignoreFlash = false; + + window.setTimeout(function() { + + // by default, re-init + + if (!excludeInit) { + sm2.beginDelayedInit(); + } + + }, 20); + + return sm2; + + }; + + this.reset = function() { + + /** + * Shuts down and restores the SoundManager instance to its original loaded state, without an explicit reboot. All onready/ontimeout handlers are removed. + * After this call, SM2 may be re-initialized via soundManager.beginDelayedInit(). + * @return {object} soundManager The soundManager instance. + */ + + _wDS('reset'); + + return sm2.reboot(true, true); + + }; + + /** + * Undocumented: Determines the SM2 flash movie's load progress. + * + * @return {number or null} Percent loaded, or if invalid/unsupported, null. + */ + + this.getMoviePercent = function() { + + /** + * Interesting syntax notes... + * Flash/ExternalInterface (ActiveX/NPAPI) bridge methods are not typeof "function" nor instanceof Function, but are still valid. + * Furthermore, using (flash && flash.PercentLoaded) causes IE to throw "object doesn't support this property or method". + * Thus, 'in' syntax must be used. + */ + + return (flash && 'PercentLoaded' in flash ? flash.PercentLoaded() : null); + + }; + + /** + * Additional helper for manually invoking SM2's init process after DOM Ready / window.onload(). + */ + + this.beginDelayedInit = function() { + + windowLoaded = true; + domContentLoaded(); + + setTimeout(function() { + + if (initPending) return false; + + createMovie(); + initMovie(); + initPending = true; + + return true; + + }, 20); + + delayWaitForEI(); + + }; + + /** + * Destroys the SoundManager instance and all SMSound instances. + */ + + this.destruct = function() { + + sm2._wD(sm + '.destruct()'); + sm2.disable(true); + + }; + + /** + * SMSound() (sound object) constructor + * ------------------------------------ + * + * @param {object} oOptions Sound options (id and url are required attributes) + * @return {SMSound} The new SMSound object + */ + + SMSound = function(oOptions) { + + var s = this, resetProperties, add_html5_events, remove_html5_events, stop_html5_timer, start_html5_timer, attachOnPosition, onplay_called = false, onPositionItems = [], onPositionFired = 0, detachOnPosition, applyFromTo, lastURL = null, lastHTML5State, urlOmitted; + + lastHTML5State = { + // tracks duration + position (time) + duration: null, + time: null + }; + + this.id = oOptions.id; + + // legacy + this.sID = this.id; + + this.url = oOptions.url; + this.options = mixin(oOptions); + + // per-play-instance-specific options + this.instanceOptions = this.options; + + // short alias + this._iO = this.instanceOptions; + + // assign property defaults + this.pan = this.options.pan; + this.volume = this.options.volume; + + // whether or not this object is using HTML5 + this.isHTML5 = false; + + // internal HTML5 Audio() object reference + this._a = null; + + // for flash 8 special-case createSound() without url, followed by load/play with url case + urlOmitted = (!this.url); + + /** + * SMSound() public methods + * ------------------------ + */ + + this.id3 = {}; + + /** + * Writes SMSound object parameters to debug console + */ + + this._debug = function() { + + // + sm2._wD(s.id + ': Merged options:', s.options); + // + + }; + + /** + * Begins loading a sound per its *url*. + * + * @param {object} options Optional: Sound options + * @return {SMSound} The SMSound object + */ + + this.load = function(options) { + + var oSound = null, instanceOptions; + + if (options !== _undefined) { + s._iO = mixin(options, s.options); + } else { + options = s.options; + s._iO = options; + if (lastURL && lastURL !== s.url) { + _wDS('manURL'); + s._iO.url = s.url; + s.url = null; + } + } + + if (!s._iO.url) { + s._iO.url = s.url; + } + + s._iO.url = parseURL(s._iO.url); + + // ensure we're in sync + s.instanceOptions = s._iO; + + // local shortcut + instanceOptions = s._iO; + + sm2._wD(s.id + ': load (' + instanceOptions.url + ')'); + + if (!instanceOptions.url && !s.url) { + sm2._wD(s.id + ': load(): url is unassigned. Exiting.', 2); + return s; + } + + // + if (!s.isHTML5 && fV === 8 && !s.url && !instanceOptions.autoPlay) { + // flash 8 load() -> play() won't work before onload has fired. + sm2._wD(s.id + ': Flash 8 load() limitation: Wait for onload() before calling play().', 1); + } + // + + if (instanceOptions.url === s.url && s.readyState !== 0 && s.readyState !== 2) { + _wDS('onURL', 1); + // if loaded and an onload() exists, fire immediately. + if (s.readyState === 3 && instanceOptions.onload) { + // assume success based on truthy duration. + wrapCallback(s, function() { + instanceOptions.onload.apply(s, [(!!s.duration)]); + }); + } + return s; + } + + // reset a few state properties + + s.loaded = false; + s.readyState = 1; + s.playState = 0; + s.id3 = {}; + + // TODO: If switching from HTML5 -> flash (or vice versa), stop currently-playing audio. + + if (html5OK(instanceOptions)) { + + oSound = s._setup_html5(instanceOptions); + + if (!oSound._called_load) { + + s._html5_canplay = false; + + // TODO: review called_load / html5_canplay logic + + // if url provided directly to load(), assign it here. + + if (s.url !== instanceOptions.url) { + + sm2._wD(_wDS('manURL') + ': ' + instanceOptions.url); + + s._a.src = instanceOptions.url; + + // TODO: review / re-apply all relevant options (volume, loop, onposition etc.) + + // reset position for new URL + s.setPosition(0); + + } + + // given explicit load call, try to preload. + + // early HTML5 implementation (non-standard) + s._a.autobuffer = 'auto'; + + // standard property, values: none / metadata / auto + // reference: http://msdn.microsoft.com/en-us/library/ie/ff974759%28v=vs.85%29.aspx + s._a.preload = 'auto'; + + s._a._called_load = true; + + } else { + + sm2._wD(s.id + ': Ignoring request to load again'); + + } + + } else { + + if (sm2.html5Only) { + sm2._wD(s.id + ': No flash support. Exiting.'); + return s; + } + + if (s._iO.url && s._iO.url.match(/data:/i)) { + // data: URIs not supported by Flash, either. + sm2._wD(s.id + ': data: URIs not supported via Flash. Exiting.'); + return s; + } + + try { + s.isHTML5 = false; + s._iO = policyFix(loopFix(instanceOptions)); + // if we have "position", disable auto-play as we'll be seeking to that position at onload(). + if (s._iO.autoPlay && (s._iO.position || s._iO.from)) { + sm2._wD(s.id + ': Disabling autoPlay because of non-zero offset case'); + s._iO.autoPlay = false; + } + // re-assign local shortcut + instanceOptions = s._iO; + 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); + } + } catch(e) { + _wDS('smError', 2); + debugTS('onload', false); + catchError({ + type: 'SMSOUND_LOAD_JS_EXCEPTION', + fatal: true + }); + } + + } + + // after all of this, ensure sound url is up to date. + s.url = instanceOptions.url; + + return s; + + }; + + /** + * Unloads a sound, canceling any open HTTP requests. + * + * @return {SMSound} The SMSound object + */ + + this.unload = function() { + + // Flash 8/AS2 can't "close" a stream - fake it by loading an empty URL + // Flash 9/AS3: Close stream, preventing further load + // HTML5: Most UAs will use empty URL + + if (s.readyState !== 0) { + + sm2._wD(s.id + ': unload()'); + + if (!s.isHTML5) { + + if (fV === 8) { + flash._unload(s.id, emptyURL); + } else { + flash._unload(s.id); + } + + } else { + + stop_html5_timer(); + + if (s._a) { + + s._a.pause(); + + // update empty URL, too + lastURL = html5Unload(s._a); + + } + + } + + // reset load/status flags + resetProperties(); + + } + + return s; + + }; + + /** + * Unloads and destroys a sound. + */ + + this.destruct = function(_bFromSM) { + + sm2._wD(s.id + ': Destruct'); + + if (!s.isHTML5) { + + // kill sound within Flash + // Disable the onfailure handler + s._iO.onfailure = null; + flash._destroySound(s.id); + + } else { + + stop_html5_timer(); + + if (s._a) { + s._a.pause(); + html5Unload(s._a); + if (!useGlobalHTML5Audio) { + remove_html5_events(); + } + // break obvious circular reference + s._a._s = null; + s._a = null; + } + + } + + if (!_bFromSM) { + // ensure deletion from controller + sm2.destroySound(s.id, true); + } + + }; + + /** + * Begins playing a sound. + * + * @param {object} options Optional: Sound options + * @return {SMSound} The SMSound object + */ + + this.play = function(options, _updatePlayState) { + + var fN, allowMulti, a, onready, + audioClone, onended, oncanplay, + startOK = true; + + // + fN = s.id + ': play(): '; + // + + // default to true + _updatePlayState = (_updatePlayState === _undefined ? true : _updatePlayState); + + if (!options) { + options = {}; + } + + // first, use local URL (if specified) + if (s.url) { + s._iO.url = s.url; + } + + // mix in any options defined at createSound() + s._iO = mixin(s._iO, s.options); + + // mix in any options specific to this method + s._iO = mixin(options, s._iO); + + s._iO.url = parseURL(s._iO.url); + + s.instanceOptions = s._iO; + + // RTMP-only + if (!s.isHTML5 && s._iO.serverURL && !s.connected) { + if (!s.getAutoPlay()) { + sm2._wD(fN + ' Netstream not connected yet - setting autoPlay'); + s.setAutoPlay(true); + } + // play will be called in onconnect() + return s; + } + + if (html5OK(s._iO)) { + s._setup_html5(s._iO); + start_html5_timer(); + } + + 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); + } + + return s; + + } + + sm2._wD(fN + 'Already playing (multi-shot)', 1); + + } + + // edge case: play() with explicit URL parameter + if (options.url && options.url !== s.url) { + + // special case for createSound() followed by load() / play() with url; avoid double-load case. + if (!s.readyState && !s.isHTML5 && fV === 8 && urlOmitted) { + + urlOmitted = false; + + } else { + + // load using merged options + s.load(s._iO); + + } + + } + + if (!s.loaded) { + + if (s.readyState === 0) { + + sm2._wD(fN + 'Attempting to load'); + + // try to get this sound playing ASAP + if (!s.isHTML5 && !sm2.html5Only) { + + // flash: assign directly because setAutoPlay() increments the instanceCount + s._iO.autoPlay = true; + s.load(s._iO); + + } else if (s.isHTML5) { + + // iOS needs this when recycling sounds, loading a new URL on an existing object. + s.load(s._iO); + + } else { + + sm2._wD(fN + 'Unsupported type. Exiting.'); + + return s; + + } + + // HTML5 hack - re-set instanceOptions? + s.instanceOptions = s._iO; + + } else if (s.readyState === 2) { + + sm2._wD(fN + 'Could not load - exiting', 2); + + return s; + + } else { + + sm2._wD(fN + 'Loading - attempting to play...'); + + } + + } else { + + // "play()" + sm2._wD(fN.substr(0, fN.lastIndexOf(':'))); + + } + + 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'); + options.position = 0; + } + + /** + * Streams will pause when their buffer is full if they are being loaded. + * In this case paused is true, but the song hasn't started playing yet. + * If we just call resume() the onplay() callback will never be called. + * So only call resume() if the position is > 0. + * Another reason is because options like volume won't have been applied yet. + * For normal sounds, just resume. + */ + + if (s.paused && s.position >= 0 && (!s._iO.serverURL || s.position > 0)) { + + // https://gist.github.com/37b17df75cc4d7a90bf6 + sm2._wD(fN + 'Resuming from paused state', 1); + s.resume(); + + } else { + + s._iO = mixin(options, s._iO); + + /** + * Preload in the event of play() with position under Flash, + * or from/to parameters and non-RTMP case + */ + if (((!s.isHTML5 && s._iO.position !== null && s._iO.position > 0) || (s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0 && !s._iO.serverURL) { + + onready = function() { + // sound "canplay" or onload() + // re-apply position/from/to to instance options, and start playback + s._iO = mixin(options, s._iO); + s.play(s._iO); + }; + + // HTML5 needs to at least have "canplay" fired before seeking. + if (s.isHTML5 && !s._html5_canplay) { + + // this hasn't been loaded yet. load it first, and then do this again. + sm2._wD(fN + 'Beginning load for non-zero offset case'); + + s.load({ + // note: custom HTML5-only event added for from/to implementation. + _oncanplay: onready + }); + + } else if (!s.isHTML5 && !s.loaded && (!s.readyState || s.readyState !== 2)) { + + // to be safe, preload the whole thing in Flash. + + sm2._wD(fN + 'Preloading for non-zero offset case'); + + s.load({ + onload: onready + }); + + } + + // otherwise, we're ready to go. re-apply local options, and continue + + s._iO = applyFromTo(); + + } + + // sm2._wD(fN + 'Starting to play'); + + // increment instance counter, where enabled + supported + if (!s.instanceCount || s._iO.multiShotEvents || (s.isHTML5 && s._iO.multiShot && !useGlobalHTML5Audio) || (!s.isHTML5 && fV > 8 && !s.getAutoPlay())) { + s.instanceCount++; + } + + // if first play and onposition parameters exist, apply them now + if (s._iO.onposition && s.playState === 0) { + attachOnPosition(s); + } + + s.playState = 1; + s.paused = false; + + s.position = (s._iO.position !== _undefined && !isNaN(s._iO.position) ? s._iO.position : 0); + + if (!s.isHTML5) { + s._iO = policyFix(loopFix(s._iO)); + } + + if (s._iO.onplay && _updatePlayState) { + s._iO.onplay.apply(s); + onplay_called = true; + } + + s.setVolume(s._iO.volume, true); + s.setPan(s._iO.pan, true); + + if (s._iO.playbackRate !== 1) { + s.setPlaybackRate(s._iO.playbackRate); + } + + if (!s.isHTML5) { + + startOK = flash._start(s.id, s._iO.loops || 1, (fV === 9 ? s.position : s.position / msecScale), s._iO.multiShot || false); + + if (fV === 9 && !startOK) { + // edge case: no sound hardware, or 32-channel flash ceiling hit. + // applies only to Flash 9, non-NetStream/MovieStar sounds. + // http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html#play%28%29 + sm2._wD(fN + 'No sound hardware, or 32-sound ceiling hit', 2); + if (s._iO.onplayerror) { + s._iO.onplayerror.apply(s); + } + + } + + } else if (s.instanceCount < 2) { + + // HTML5 single-instance case + + start_html5_timer(); + + a = s._setup_html5(); + + s.setPosition(s._iO.position); + + a.play(); + + } else { + + // HTML5 multi-shot case + + sm2._wD(s.id + ': Cloning Audio() for instance #' + s.instanceCount + '...'); + + audioClone = new Audio(s._iO.url); + + onended = function() { + event.remove(audioClone, 'ended', onended); + s._onfinish(s); + // cleanup + html5Unload(audioClone); + audioClone = null; + }; + + oncanplay = function() { + event.remove(audioClone, 'canplay', oncanplay); + try { + audioClone.currentTime = s._iO.position / msecScale; + } catch(err) { + complain(s.id + ': multiShot play() failed to apply position of ' + (s._iO.position / msecScale)); + } + audioClone.play(); + }; + + event.add(audioClone, 'ended', onended); + + // apply volume to clones, too + if (s._iO.volume !== _undefined) { + audioClone.volume = Math.max(0, Math.min(1, s._iO.volume / 100)); + } + + // playing multiple muted sounds? if you do this, you're weird ;) - but let's cover it. + if (s.muted) { + audioClone.muted = true; + } + + if (s._iO.position) { + // HTML5 audio can't seek before onplay() event has fired. + // wait for canplay, then seek to position and start playback. + event.add(audioClone, 'canplay', oncanplay); + } else { + // begin playback at currentTime: 0 + audioClone.play(); + } + + } + + } + + return s; + + }; + + // just for convenience + this.start = this.play; + + /** + * Stops playing a sound (and optionally, all sounds) + * + * @param {boolean} bAll Optional: Whether to stop all sounds + * @return {SMSound} The SMSound object + */ + + this.stop = function(bAll) { + + var instanceOptions = s._iO, + originalPosition; + + if (s.playState === 1) { + + sm2._wD(s.id + ': stop()'); + + s._onbufferchange(0); + s._resetOnPosition(0); + s.paused = false; + + if (!s.isHTML5) { + s.playState = 0; + } + + // remove onPosition listeners, if any + detachOnPosition(); + + // and "to" position, if set + if (instanceOptions.to) { + s.clearOnPosition(instanceOptions.to); + } + + if (!s.isHTML5) { + + flash._stop(s.id, bAll); + + // hack for netStream: just unload + if (instanceOptions.serverURL) { + s.unload(); + } + + } else if (s._a) { + + originalPosition = s.position; + + // act like Flash, though + s.setPosition(0); + + // hack: reflect old position for onstop() (also like Flash) + s.position = originalPosition; + + // html5 has no stop() + // NOTE: pausing means iOS requires interaction to resume. + s._a.pause(); + + s.playState = 0; + + // and update UI + s._onTimer(); + + stop_html5_timer(); + + } + + s.instanceCount = 0; + s._iO = {}; + + if (instanceOptions.onstop) { + instanceOptions.onstop.apply(s); + } + + } + + return s; + + }; + + /** + * Undocumented/internal: Sets autoPlay for RTMP. + * + * @param {boolean} autoPlay state + */ + + this.setAutoPlay = function(autoPlay) { + + sm2._wD(s.id + ': Autoplay turned ' + (autoPlay ? 'on' : 'off')); + s._iO.autoPlay = autoPlay; + + if (!s.isHTML5) { + flash._setAutoPlay(s.id, autoPlay); + if (autoPlay) { + // only increment the instanceCount if the sound isn't loaded (TODO: verify RTMP) + if (!s.instanceCount && s.readyState === 1) { + s.instanceCount++; + sm2._wD(s.id + ': Incremented instance count to ' + s.instanceCount); + } + } + } + + }; + + /** + * Undocumented/internal: Returns the autoPlay boolean. + * + * @return {boolean} The current autoPlay value + */ + + this.getAutoPlay = function() { + + return s._iO.autoPlay; + + }; + + /** + * Sets the playback rate of a sound (HTML5-only.) + * + * @param {number} playbackRate (+/-) + * @return {SMSound} The SMSound object + */ + + this.setPlaybackRate = function(playbackRate) { + + // Per Mozilla, limit acceptable values to prevent playback from stopping (unless allowOverride is truthy.) + // https://developer.mozilla.org/en-US/Apps/Build/Audio_and_video_delivery/WebAudio_playbackRate_explained + var normalizedRate = Math.max(0.5, Math.min(4, playbackRate)); + + // + if (normalizedRate !== playbackRate) { + sm2._wD(s.id + ': setPlaybackRate(' + playbackRate + '): limiting rate to ' + normalizedRate, 2); + } + // + + if (s.isHTML5) { + try { + s._iO.playbackRate = normalizedRate; + s._a.playbackRate = normalizedRate; + } catch(e) { + sm2._wD(s.id + ': setPlaybackRate(' + normalizedRate + ') failed: ' + e.message, 2); + } + } + + return s; + + }; + + /** + * Sets the position of a sound. + * + * @param {number} nMsecOffset Position (milliseconds) + * @return {SMSound} The SMSound object + */ + + this.setPosition = function(nMsecOffset) { + + if (nMsecOffset === _undefined) { + nMsecOffset = 0; + } + + var position, position1K, + // Use the duration from the instance options, if we don't have a track duration yet. + // position >= 0 and <= current available (loaded) duration + offset = (s.isHTML5 ? Math.max(nMsecOffset, 0) : Math.min(s.duration || s._iO.duration, Math.max(nMsecOffset, 0))); + + s.position = offset; + position1K = s.position / msecScale; + s._resetOnPosition(s.position); + s._iO.position = offset; + + if (!s.isHTML5) { + + position = (fV === 9 ? s.position : position1K); + + if (s.readyState && s.readyState !== 2) { + // if paused or not playing, will not resume (by playing) + flash._setPosition(s.id, position, (s.paused || !s.playState), s._iO.multiShot); + } + + } else if (s._a) { + + // Set the position in the canplay handler if the sound is not ready yet + if (s._html5_canplay) { + + if (s._a.currentTime.toFixed(3) !== position1K.toFixed(3)) { + + /** + * DOM/JS errors/exceptions to watch out for: + * if seek is beyond (loaded?) position, "DOM exception 11" + * "INDEX_SIZE_ERR": DOM exception 1 + */ + sm2._wD(s.id + ': setPosition(' + position1K + ')'); + + try { + s._a.currentTime = position1K; + if (s.playState === 0 || s.paused) { + // allow seek without auto-play/resume + s._a.pause(); + } + } catch(e) { + sm2._wD(s.id + ': setPosition(' + position1K + ') failed: ' + e.message, 2); + } + + } + + } else if (position1K) { + + // warn on non-zero seek attempts + sm2._wD(s.id + ': setPosition(' + position1K + '): Cannot seek yet, sound not ready', 2); + return s; + + } + + if (s.paused) { + + // if paused, refresh UI right away by forcing update + s._onTimer(true); + + } + + } + + return s; + + }; + + /** + * Pauses sound playback. + * + * @return {SMSound} The SMSound object + */ + + this.pause = function(_bCallFlash) { + + if (s.paused || (s.playState === 0 && s.readyState !== 1)) return s; + + sm2._wD(s.id + ': pause()'); + s.paused = true; + + if (!s.isHTML5) { + if (_bCallFlash || _bCallFlash === _undefined) { + flash._pause(s.id, s._iO.multiShot); + } + } else { + s._setup_html5().pause(); + stop_html5_timer(); + } + + if (s._iO.onpause) { + s._iO.onpause.apply(s); + } + + return s; + + }; + + /** + * Resumes sound playback. + * + * @return {SMSound} The SMSound object + */ + + /** + * When auto-loaded streams pause on buffer full they have a playState of 0. + * We need to make sure that the playState is set to 1 when these streams "resume". + * When a paused stream is resumed, we need to trigger the onplay() callback if it + * hasn't been called already. In this case since the sound is being played for the + * first time, I think it's more appropriate to call onplay() rather than onresume(). + */ + + this.resume = function() { + + var instanceOptions = s._iO; + + if (!s.paused) return s; + + sm2._wD(s.id + ': resume()'); + s.paused = false; + 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; + + }; + + /** + * Toggles sound playback. + * + * @return {SMSound} The SMSound object + */ + + this.togglePause = function() { + + sm2._wD(s.id + ': togglePause()'); + + if (s.playState === 0) { + s.play({ + position: (fV === 9 && !s.isHTML5 ? s.position : s.position / msecScale) + }); + return s; + } + + if (s.paused) { + s.resume(); + } else { + s.pause(); + } + + return s; + + }; + + /** + * Sets the panning (L-R) effect. + * + * @param {number} nPan The pan value (-100 to 100) + * @return {SMSound} The SMSound object + */ + + this.setPan = function(nPan, bInstanceOnly) { + + if (nPan === _undefined) { + nPan = 0; + } + + if (bInstanceOnly === _undefined) { + bInstanceOnly = false; + } + + if (!s.isHTML5) { + flash._setPan(s.id, nPan); + } // else { no HTML5 pan? } + + s._iO.pan = nPan; + + if (!bInstanceOnly) { + s.pan = nPan; + s.options.pan = nPan; + } + + return s; + + }; + + /** + * Sets the volume. + * + * @param {number} nVol The volume value (0 to 100) + * @return {SMSound} The SMSound object + */ + + this.setVolume = function(nVol, _bInstanceOnly) { + + /** + * Note: Setting volume has no effect on iOS "special snowflake" devices. + * Hardware volume control overrides software, and volume + * will always return 1 per Apple docs. (iOS 4 + 5.) + * http://developer.apple.com/library/safari/documentation/AudioVideo/Conceptual/HTML-canvas-guide/AddingSoundtoCanvasAnimations/AddingSoundtoCanvasAnimations.html + */ + + if (nVol === _undefined) { + nVol = 100; + } + + if (_bInstanceOnly === _undefined) { + _bInstanceOnly = false; + } + + if (!s.isHTML5) { + + 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 for native HTML5 Audio(): 0-1 + s._a.volume = Math.max(0, Math.min(1, nVol / 100)); + + } + + s._iO.volume = nVol; + + if (!_bInstanceOnly) { + s.volume = nVol; + s.options.volume = nVol; + } + + return s; + + }; + + /** + * Mutes the sound. + * + * @return {SMSound} The SMSound object + */ + + this.mute = function() { + + s.muted = true; + + if (!s.isHTML5) { + flash._setVolume(s.id, 0); + } else if (s._a) { + s._a.muted = true; + } + + return s; + + }; + + /** + * Unmutes the sound. + * + * @return {SMSound} The SMSound object + */ + + this.unmute = function() { + + s.muted = false; + var hasIO = (s._iO.volume !== _undefined); + + if (!s.isHTML5) { + flash._setVolume(s.id, hasIO ? s._iO.volume : s.options.volume); + } else if (s._a) { + s._a.muted = false; + } + + return s; + + }; + + /** + * Toggles the muted state of a sound. + * + * @return {SMSound} The SMSound object + */ + + this.toggleMute = function() { + + return (s.muted ? s.unmute() : s.mute()); + + }; + + /** + * Registers a callback to be fired when a sound reaches a given position during playback. + * + * @param {number} nPosition The position to watch for + * @param {function} oMethod The relevant callback to fire + * @param {object} oScope Optional: The scope to apply the callback to + * @return {SMSound} The SMSound object + */ + + this.onPosition = function(nPosition, oMethod, oScope) { + + // TODO: basic dupe checking? + + onPositionItems.push({ + position: parseInt(nPosition, 10), + method: oMethod, + scope: (oScope !== _undefined ? oScope : s), + fired: false + }); + + return s; + + }; + + // legacy/backwards-compability: lower-case method name + this.onposition = this.onPosition; + + /** + * Removes registered callback(s) from a sound, by position and/or callback. + * + * @param {number} nPosition The position to clear callback(s) for + * @param {function} oMethod Optional: Identify one callback to be removed when multiple listeners exist for one position + * @return {SMSound} The SMSound object + */ + + this.clearOnPosition = function(nPosition, oMethod) { + + var i; + + nPosition = parseInt(nPosition, 10); + + if (isNaN(nPosition)) { + // safety check + return; + } + + for (i = 0; i < onPositionItems.length; i++) { + + 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); + + } + + } + + } + + }; + + this._processOnPosition = function() { + + var i, item, j = onPositionItems.length; + + if (!j || !s.playState || onPositionFired >= j) return false; + + 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]); + + // reset j -- onPositionItems.length can be changed in the item callback above... occasionally breaking the loop. + j = onPositionItems.length; + + } + + } + + return true; + + }; + + this._resetOnPosition = function(nPosition) { + + // reset "fired" for items interested in this position + var i, item, j = onPositionItems.length; + + if (!j) return false; + + for (i = j - 1; i >= 0; i--) { + + item = onPositionItems[i]; + + if (item.fired && nPosition <= item.position) { + item.fired = false; + onPositionFired--; + } + + } + + return true; + + }; + + /** + * SMSound() private internals + * -------------------------------- + */ + + applyFromTo = function() { + + var instanceOptions = s._iO, + f = instanceOptions.from, + t = instanceOptions.to, + start, end; + + end = function() { + + // end has been reached. + sm2._wD(s.id + ': "To" time of ' + t + ' reached.'); + + // detach listener + s.clearOnPosition(t, end); + + // stop should clear this, too + s.stop(); + + }; + + start = function() { + + sm2._wD(s.id + ': Playing "from" ' + f); + + // add listener for end + if (t !== null && !isNaN(t)) { + s.onPosition(t, end); + } + + }; + + if (f !== null && !isNaN(f)) { + + // apply to instance options, guaranteeing correct start position. + instanceOptions.position = f; + + // multiShot timing can't be tracked, so prevent that. + instanceOptions.multiShot = false; + + start(); + + } + + // return updated instanceOptions including starting position + return instanceOptions; + + }; + + attachOnPosition = function() { + + var item, + op = s._iO.onposition; + + // attach onposition things, if any, now. + + if (op) { + + for (item in op) { + if (op.hasOwnProperty(item)) { + s.onPosition(parseInt(item, 10), op[item]); + } + } + + } + + }; + + detachOnPosition = function() { + + var item, + op = s._iO.onposition; + + // detach any onposition()-style listeners. + + if (op) { + + for (item in op) { + if (op.hasOwnProperty(item)) { + s.clearOnPosition(parseInt(item, 10)); + } + } + + } + + }; + + start_html5_timer = function() { + + if (s.isHTML5) { + startTimer(s); + } + + }; + + stop_html5_timer = function() { + + if (s.isHTML5) { + stopTimer(s); + } + + }; + + resetProperties = function(retainPosition) { + + if (!retainPosition) { + onPositionItems = []; + onPositionFired = 0; + } + + onplay_called = false; + + s._hasTimer = null; + s._a = null; + s._html5_canplay = false; + s.bytesLoaded = null; + s.bytesTotal = null; + s.duration = (s._iO && s._iO.duration ? s._iO.duration : null); + s.durationEstimate = null; + s.buffered = []; + + // legacy: 1D array + s.eqData = []; + + s.eqData.left = []; + s.eqData.right = []; + + s.failures = 0; + s.isBuffering = false; + s.instanceOptions = {}; + s.instanceCount = 0; + s.loaded = false; + s.metadata = {}; + + // 0 = uninitialised, 1 = loading, 2 = failed/error, 3 = loaded/success + s.readyState = 0; + + s.muted = false; + s.paused = false; + + s.peakData = { + left: 0, + right: 0 + }; + + s.waveformData = { + left: [], + right: [] + }; + + s.playState = 0; + s.position = null; + + s.id3 = {}; + + }; + + resetProperties(); + + /** + * Pseudo-private SMSound internals + * -------------------------------- + */ + + this._onTimer = function(bForce) { + + /** + * HTML5-only _whileplaying() etc. + * called from both HTML5 native events, and polling/interval-based timers + * mimics flash and fires only when time/duration change, so as to be polling-friendly + */ + + var duration, isNew = false, time, x = {}; + + if (s._hasTimer || bForce) { + + // TODO: May not need to track readyState (1 = loading) + + if (s._a && (bForce || ((s.playState > 0 || s.readyState === 1) && !s.paused))) { + + duration = s._get_html5_duration(); + + if (duration !== lastHTML5State.duration) { + + lastHTML5State.duration = duration; + s.duration = duration; + isNew = true; + + } + + // TODO: investigate why this goes wack if not set/re-set each time. + s.durationEstimate = s.duration; + + time = (s._a.currentTime * msecScale || 0); + + if (time !== lastHTML5State.time) { + + lastHTML5State.time = time; + isNew = true; + + } + + if (isNew || bForce) { + + s._whileplaying(time, x, x, x, x); + + } + + }/* else { + + // sm2._wD('_onTimer: Warn for "'+s.id+'": '+(!s._a?'Could not find element. ':'')+(s.playState === 0?'playState bad, 0?':'playState = '+s.playState+', OK')); + + return false; + + }*/ + + } + + return isNew; + + }; + + this._get_html5_duration = function() { + + 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)), + result = (d && !isNaN(d) && d !== Infinity ? d : null); + + return result; + + }; + + this._apply_loop = function(a, nLoops) { + + /** + * boolean instead of "loop", for webkit? - spec says string. http://www.w3.org/TR/html-markup/audio.html#audio.attrs.loop + * note that loop is either off or infinite under HTML5, unlike Flash which allows arbitrary loop counts to be specified. + */ + + // + if (!a.loop && nLoops > 1) { + sm2._wD('Note: Native HTML5 looping is infinite.', 1); + } + // + + a.loop = (nLoops > 1 ? 'loop' : ''); + + }; + + this._setup_html5 = function(options) { + + var instanceOptions = mixin(s._iO, options), + a = useGlobalHTML5Audio ? globalHTML5Audio : s._a, + dURL = decodeURI(instanceOptions.url), + sameURL; + + /** + * "First things first, I, Poppa..." (reset the previous state of the old sound, if playing) + * Fixes case with devices that can only play one sound at a time + * Otherwise, other sounds in mid-play will be terminated without warning and in a stuck state + */ + + if (useGlobalHTML5Audio) { + + if (dURL === decodeURI(lastGlobalHTML5URL)) { + // global HTML5 audio: re-use of URL + sameURL = true; + } + + } else if (dURL === decodeURI(lastURL)) { + + // options URL is the same as the "last" URL, and we used (loaded) it + sameURL = true; + + } + + if (a) { + + if (a._s) { + + if (useGlobalHTML5Audio) { + + if (a._s && a._s.playState && !sameURL) { + + // global HTML5 audio case, and loading a new URL. stop the currently-playing one. + a._s.stop(); + + } + + } else if (!useGlobalHTML5Audio && dURL === decodeURI(lastURL)) { + + // non-global HTML5 reuse case: same url, ignore request + s._apply_loop(a, instanceOptions.loops); + + return a; + + } + + } + + if (!sameURL) { + + // don't retain onPosition() stuff with new URLs. + + if (lastURL) { + resetProperties(false); + } + + // assign new HTML5 URL + + a.src = instanceOptions.url; + + s.url = instanceOptions.url; + + lastURL = instanceOptions.url; + + lastGlobalHTML5URL = instanceOptions.url; + + a._called_load = false; + + } + + } else { + + if (instanceOptions.autoLoad || instanceOptions.autoPlay) { + + s._a = new Audio(instanceOptions.url); + s._a.load(); + + } else { + + // null for stupid Opera 9.64 case + s._a = (isOpera && opera.version() < 10 ? new Audio(null) : new Audio()); + + } + + // assign local reference + a = s._a; + + a._called_load = false; + + if (useGlobalHTML5Audio) { + + globalHTML5Audio = a; + + } + + } + + s.isHTML5 = true; + + // store a ref on the track + s._a = a; + + // store a ref on the audio + a._s = s; + + add_html5_events(); + + s._apply_loop(a, instanceOptions.loops); + + if (instanceOptions.autoLoad || instanceOptions.autoPlay) { + + s.load(); + + } else { + + // early HTML5 implementation (non-standard) + a.autobuffer = false; + + // standard ('none' is also an option.) + a.preload = 'auto'; + + } + + return a; + + }; + + add_html5_events = function() { + + if (s._a._added_events) return false; + + var f; + + function add(oEvt, oFn, bCapture) { + return s._a ? s._a.addEventListener(oEvt, oFn, bCapture || false) : null; + } + + s._a._added_events = true; + + for (f in html5_events) { + if (html5_events.hasOwnProperty(f)) { + add(f, html5_events[f]); + } + } + + return true; + + }; + + remove_html5_events = function() { + + // Remove event listeners + + var f; + + function remove(oEvt, oFn, bCapture) { + return (s._a ? s._a.removeEventListener(oEvt, oFn, bCapture || false) : null); + } + + sm2._wD(s.id + ': Removing event listeners'); + s._a._added_events = false; + + for (f in html5_events) { + if (html5_events.hasOwnProperty(f)) { + remove(f, html5_events[f]); + } + } + + }; + + /** + * Pseudo-private event internals + * ------------------------------ + */ + + this._onload = function(nSuccess) { + + var fN, + // check for duration to prevent false positives from flash 8 when loading from cache. + loadOK = !!nSuccess || (!s.isHTML5 && fV === 8 && s.duration); + + // + 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); + } + if (sm2.sandbox.noLocal === true) { + sm2._wD(fN + str('noLocal'), 1); + } + } + // + + s.loaded = loadOK; + s.readyState = (loadOK ? 3 : 2); + s._onbufferchange(0); + + if (!loadOK && !s.isHTML5) { + // note: no error code from Flash. + s._onerror(); + } + + if (s._iO.onload) { + wrapCallback(s, function() { + s._iO.onload.apply(s, [loadOK]); + }); + } + + return true; + + }; + + this._onerror = function(errorCode, description) { + + // https://html.spec.whatwg.org/multipage/embedded-content.html#error-codes + if (s._iO.onerror) { + wrapCallback(s, function() { + s._iO.onerror.apply(s, [errorCode, description]); + }); + } + + }; + + this._onbufferchange = function(nIsBuffering) { + + // ignore if not playing + if (s.playState === 0) return false; + + if ((nIsBuffering && s.isBuffering) || (!nIsBuffering && !s.isBuffering)) return false; + + s.isBuffering = (nIsBuffering === 1); + + if (s._iO.onbufferchange) { + sm2._wD(s.id + ': Buffer state change: ' + nIsBuffering); + s._iO.onbufferchange.apply(s, [nIsBuffering]); + } + + return true; + + }; + + /** + * Playback may have stopped due to buffering, or related reason. + * This state can be encountered on iOS < 6 when auto-play is blocked. + */ + + this._onsuspend = function() { + + if (s._iO.onsuspend) { + sm2._wD(s.id + ': Playback suspended'); + s._iO.onsuspend.apply(s); + } + + return true; + + }; + + /** + * flash 9/movieStar + RTMP-only method, should fire only once at most + * at this point we just recreate failed sounds rather than trying to reconnect + */ + + this._onfailure = function(msg, level, code) { + + s.failures++; + sm2._wD(s.id + ': Failure (' + s.failures + '): ' + msg); + + if (s._iO.onfailure && s.failures === 1) { + s._iO.onfailure(msg, level, code); + } else { + sm2._wD(s.id + ': Ignoring failure'); + } + + }; + + /** + * flash 9/movieStar + RTMP-only method for unhandled warnings/exceptions from Flash + * e.g., RTMP "method missing" warning (non-fatal) for getStreamLength on server + */ + + this._onwarning = function(msg, level, code) { + + if (s._iO.onwarning) { + s._iO.onwarning(msg, level, code); + } + + }; + + this._onfinish = function() { + + // store local copy before it gets trashed... + var io_onfinish = s._iO.onfinish; + + s._onbufferchange(0); + s._resetOnPosition(0); + + // reset some state items + if (s.instanceCount) { + + s.instanceCount--; + + if (!s.instanceCount) { + + // remove onPosition listeners, if any + detachOnPosition(); + + // reset instance options + s.playState = 0; + s.paused = false; + s.instanceCount = 0; + s.instanceOptions = {}; + s._iO = {}; + stop_html5_timer(); + + // reset position, too + if (s.isHTML5) { + s.position = 0; + } + + } + + if (!s.instanceCount || s._iO.multiShotEvents) { + // fire onfinish for last, or every instance + if (io_onfinish) { + sm2._wD(s.id + ': onfinish()'); + wrapCallback(s, function() { + io_onfinish.apply(s); + }); + } + } + + } + + }; + + this._whileloading = function(nBytesLoaded, nBytesTotal, nDuration, nBufferLength) { + + var instanceOptions = s._iO; + + s.bytesLoaded = nBytesLoaded; + s.bytesTotal = nBytesTotal; + s.duration = Math.floor(nDuration); + s.bufferLength = nBufferLength; + + if (!s.isHTML5 && !instanceOptions.isMovieStar) { + + if (instanceOptions.duration) { + // use duration from options, if specified and larger. nobody should be specifying duration in options, actually, and it should be retired. + s.durationEstimate = (s.duration > instanceOptions.duration) ? s.duration : instanceOptions.duration; + } else { + s.durationEstimate = parseInt((s.bytesTotal / s.bytesLoaded) * s.duration, 10); + } + + } else { + + s.durationEstimate = s.duration; + + } + + // for flash, reflect sequential-load-style buffering + if (!s.isHTML5) { + s.buffered = [{ + start: 0, + end: s.duration + }]; + } + + // allow whileloading to fire even if "load" fired under HTML5, due to HTTP range/partials + if ((s.readyState !== 3 || s.isHTML5) && instanceOptions.whileloading) { + instanceOptions.whileloading.apply(s); + } + + }; + + this._whileplaying = function(nPosition, oPeakData, oWaveformDataLeft, oWaveformDataRight, oEQData) { + + var instanceOptions = s._iO, + eqLeft; + + // flash safety net + if (isNaN(nPosition) || nPosition === null) return false; + + // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. Unexpected/invalid per W3, I think. Normalize to 0. + s.position = Math.max(0, nPosition); + + s._processOnPosition(); + + if (!s.isHTML5 && fV > 8) { + + if (instanceOptions.usePeakData && oPeakData !== _undefined && oPeakData) { + s.peakData = { + left: oPeakData.leftPeak, + right: oPeakData.rightPeak + }; + } + + if (instanceOptions.useWaveformData && oWaveformDataLeft !== _undefined && oWaveformDataLeft) { + s.waveformData = { + left: oWaveformDataLeft.split(','), + right: oWaveformDataRight.split(',') + }; + } + + if (instanceOptions.useEQData) { + if (oEQData !== _undefined && oEQData && oEQData.leftEQ) { + eqLeft = oEQData.leftEQ.split(','); + s.eqData = eqLeft; + s.eqData.left = eqLeft; + if (oEQData.rightEQ !== _undefined && oEQData.rightEQ) { + s.eqData.right = oEQData.rightEQ.split(','); + } + } + } + + } + + if (s.playState === 1) { + + // special case/hack: ensure buffering is false if loading from cache (and not yet started) + if (!s.isHTML5 && fV === 8 && !s.position && s.isBuffering) { + s._onbufferchange(0); + } + + if (instanceOptions.whileplaying) { + // flash may call after actual finish + instanceOptions.whileplaying.apply(s); + } + + } + + return true; + + }; + + this._oncaptiondata = function(oData) { + + /** + * internal: flash 9 + NetStream (MovieStar/RTMP-only) feature + * + * @param {object} oData + */ + + sm2._wD(s.id + ': Caption data received.'); + + s.captiondata = oData; + + if (s._iO.oncaptiondata) { + s._iO.oncaptiondata.apply(s, [oData]); + } + + }; + + this._onmetadata = function(oMDProps, oMDData) { + + /** + * internal: flash 9 + NetStream (MovieStar/RTMP-only) feature + * RTMP may include song title, MovieStar content may include encoding info + * + * @param {array} oMDProps (names) + * @param {array} oMDData (values) + */ + + sm2._wD(s.id + ': Metadata received.'); + + var oData = {}, i, j; + + for (i = 0, j = oMDProps.length; i < j; i++) { + oData[oMDProps[i]] = oMDData[i]; + } + + s.metadata = oData; + + if (s._iO.onmetadata) { + s._iO.onmetadata.call(s, s.metadata); + } + + }; + + this._onid3 = function(oID3Props, oID3Data) { + + /** + * internal: flash 8 + flash 9 ID3 feature + * may include artist, song title etc. + * + * @param {array} oID3Props (names) + * @param {array} oID3Data (values) + */ + + sm2._wD(s.id + ': ID3 data received.'); + + var oData = [], i, j; + + for (i = 0, j = oID3Props.length; i < j; i++) { + oData[oID3Props[i]] = oID3Data[i]; + } + + s.id3 = mixin(s.id3, oData); + + if (s._iO.onid3) { + s._iO.onid3.apply(s); + } + + }; + + // flash/RTMP-only + + this._onconnect = function(bSuccess) { + + bSuccess = (bSuccess === 1); + sm2._wD(s.id + ': ' + (bSuccess ? 'Connected.' : 'Failed to connect? - ' + s.url), (bSuccess ? 1 : 2)); + s.connected = bSuccess; + + if (bSuccess) { + + s.failures = 0; + + if (idCheck(s.id)) { + if (s.getAutoPlay()) { + // only update the play state if auto playing + s.play(_undefined, s.getAutoPlay()); + } else if (s._iO.autoLoad) { + s.load(); + } + } + + if (s._iO.onconnect) { + s._iO.onconnect.apply(s, [bSuccess]); + } + + } + + }; + + this._ondataerror = function(sError) { + + // flash 9 wave/eq data handler + // hack: called at start, and end from flash at/after onfinish() + if (s.playState > 0) { + sm2._wD(s.id + ': Data error: ' + sError); + if (s._iO.ondataerror) { + s._iO.ondataerror.apply(s); + } + } + + }; + + // + this._debug(); + // + + }; // SMSound() + + /** + * Private SoundManager internals + * ------------------------------ + */ + + getDocument = function() { + + return (doc.body || doc.getElementsByTagName('div')[0]); + + }; + + id = function(sID) { + + return doc.getElementById(sID); + + }; + + mixin = function(oMain, oAdd) { + + // non-destructive merge + var o1 = (oMain || {}), o2, o; + + // if unspecified, o2 is the default options object + o2 = (oAdd === _undefined ? sm2.defaultOptions : oAdd); + + for (o in o2) { + + if (o2.hasOwnProperty(o) && o1[o] === _undefined) { + + if (typeof o2[o] !== 'object' || o2[o] === null) { + + // assign directly + o1[o] = o2[o]; + + } else { + + // recurse through o2 + o1[o] = mixin(o1[o], o2[o]); + + } + + } + + } + + return o1; + + }; + + wrapCallback = function(oSound, callback) { + + /** + * 03/03/2013: Fix for Flash Player 11.6.602.171 + Flash 8 (flashVersion = 8) SWF issue + * setTimeout() fix for certain SMSound callbacks like onload() and onfinish(), where subsequent calls like play() and load() fail when Flash Player 11.6.602.171 is installed, and using soundManager with flashVersion = 8 (which is the default). + * Not sure of exact cause. Suspect race condition and/or invalid (NaN-style) position argument trickling down to the next JS -> Flash _start() call, in the play() case. + * Fix: setTimeout() to yield, plus safer null / NaN checking on position argument provided to Flash. + * https://getsatisfaction.com/schillmania/topics/recent_chrome_update_seems_to_have_broken_my_sm2_audio_player + */ + if (!oSound.isHTML5 && fV === 8) { + window.setTimeout(callback, 0); + } else { + callback(); + } + + }; + + // additional soundManager properties that soundManager.setup() will accept + + extraOptions = { + onready: 1, + ontimeout: 1, + defaultOptions: 1, + flash9Options: 1, + movieStarOptions: 1 + }; + + assign = function(o, oParent) { + + /** + * recursive assignment of properties, soundManager.setup() helper + * allows property assignment based on whitelist + */ + + var i, + result = true, + hasParent = (oParent !== _undefined), + setupOptions = sm2.setupOptions, + bonusOptions = extraOptions; + + // + + // if soundManager.setup() called, show accepted parameters. + + if (o === _undefined) { + + result = []; + + for (i in setupOptions) { + + if (setupOptions.hasOwnProperty(i)) { + result.push(i); + } + + } + + for (i in bonusOptions) { + + if (bonusOptions.hasOwnProperty(i)) { + + if (typeof sm2[i] === 'object') { + result.push(i + ': {...}'); + } else if (sm2[i] instanceof Function) { + result.push(i + ': function() {...}'); + } else { + result.push(i); + } + + } + + } + + sm2._wD(str('setup', result.join(', '))); + + return false; + + } + + // + + for (i in o) { + + if (o.hasOwnProperty(i)) { + + // if not an {object} we want to recurse through... + + if (typeof o[i] !== 'object' || o[i] === null || o[i] instanceof Array || o[i] instanceof RegExp) { + + // check "allowed" options + + if (hasParent && bonusOptions[oParent] !== _undefined) { + + // valid recursive / nested object option, eg., { defaultOptions: { volume: 50 } } + sm2[oParent][i] = o[i]; + + } else if (setupOptions[i] !== _undefined) { + + // special case: assign to setupOptions object, which soundManager property references + sm2.setupOptions[i] = o[i]; + + // assign directly to soundManager, too + sm2[i] = o[i]; + + } else if (bonusOptions[i] === _undefined) { + + // invalid or disallowed parameter. complain. + complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); + + result = false; + + } else if (sm2[i] instanceof Function) { + + /** + * valid extraOptions (bonusOptions) parameter. + * is it a method, like onready/ontimeout? call it. + * multiple parameters should be in an array, eg. soundManager.setup({onready: [myHandler, myScope]}); + */ + sm2[i].apply(sm2, (o[i] instanceof Array ? o[i] : [o[i]])); + + } else { + + // good old-fashioned direct assignment + sm2[i] = o[i]; + + } + + } else if (bonusOptions[i] === _undefined) { + + // recursion case, eg., { defaultOptions: { ... } } + + // invalid or disallowed parameter. complain. + complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); + + result = false; + + } else { + + // recurse through object + return assign(o[i], i); + + } + + } + + } + + return result; + + }; + + function preferFlashCheck(kind) { + + // whether flash should play a given type + return (sm2.preferFlash && hasFlash && !sm2.ignoreFlash && (sm2.flash[kind] !== _undefined && sm2.flash[kind])); + + } + + /** + * Internal DOM2-level event helpers + * --------------------------------- + */ + + event = (function() { + + // normalize event methods + var old = (window.attachEvent), + evt = { + add: (old ? 'attachEvent' : 'addEventListener'), + remove: (old ? 'detachEvent' : 'removeEventListener') + }; + + // normalize "on" event prefix, optional capture argument + function getArgs(oArgs) { + + var args = slice.call(oArgs), + len = args.length; + + if (old) { + // prefix + args[1] = 'on' + args[1]; + if (len > 3) { + // no capture + args.pop(); + } + } else if (len === 3) { + args.push(false); + } + + return args; + + } + + function apply(args, sType) { + + // normalize and call the event method, with the proper arguments + var element = args.shift(), + method = [evt[sType]]; + + if (old) { + // old IE can't do apply(). + element[method](args[0], args[1]); + } else { + element[method].apply(element, args); + } + + } + + function add() { + apply(getArgs(arguments), 'add'); + } + + function remove() { + apply(getArgs(arguments), 'remove'); + } + + return { + add: add, + remove: remove + }; + + }()); + + /** + * Internal HTML5 event handling + * ----------------------------- + */ + + function html5_event(oFn) { + + // wrap html5 event handlers so we don't call them on destroyed and/or unloaded sounds + + return function(e) { + + var s = this._s, + result; + + if (!s || !s._a) { + // + if (s && s.id) { + sm2._wD(s.id + ': Ignoring ' + e.type); + } else { + sm2._wD(h5 + 'Ignoring ' + e.type); + } + // + result = null; + } else { + result = oFn.call(this, e); + } + + return result; + + }; + + } + + html5_events = { + + // HTML5 event-name-to-handler map + + abort: html5_event(function() { + + sm2._wD(this._s.id + ': abort'); + + }), + + // enough has loaded to play + + canplay: html5_event(function() { + + var s = this._s, + position1K; + + if (s._html5_canplay) { + // this event has already fired. ignore. + return; + } + + s._html5_canplay = true; + sm2._wD(s.id + ': canplay'); + s._onbufferchange(0); + + // position according to instance options + position1K = (s._iO.position !== _undefined && !isNaN(s._iO.position) ? s._iO.position / msecScale : null); + + // set the position if position was provided before the sound loaded + if (this.currentTime !== position1K) { + sm2._wD(s.id + ': canplay: Setting position to ' + position1K); + try { + this.currentTime = position1K; + } catch(ee) { + sm2._wD(s.id + ': canplay: Setting position of ' + position1K + ' failed: ' + ee.message, 2); + } + } + + // hack for HTML5 from/to case + if (s._iO._oncanplay) { + s._iO._oncanplay(); + } + + }), + + canplaythrough: html5_event(function() { + + var s = this._s; + + if (!s.loaded) { + s._onbufferchange(0); + s._whileloading(s.bytesLoaded, s.bytesTotal, s._get_html5_duration()); + s._onload(true); + } + + }), + + durationchange: html5_event(function() { + + // durationchange may fire at various times, probably the safest way to capture accurate/final duration. + + var s = this._s, + duration; + + duration = s._get_html5_duration(); + + if (!isNaN(duration) && duration !== s.duration) { + + sm2._wD(this._s.id + ': durationchange (' + duration + ')' + (s.duration ? ', previously ' + s.duration : '')); + + s.durationEstimate = s.duration = duration; + + } + + }), + + // TODO: Reserved for potential use + /* + emptied: html5_event(function() { + + sm2._wD(this._s.id + ': emptied'); + + }), + */ + + ended: html5_event(function() { + + var s = this._s; + + sm2._wD(s.id + ': ended'); + + s._onfinish(); + + }), + + error: html5_event(function() { + + var description = (html5ErrorCodes[this.error.code] || null); + sm2._wD(this._s.id + ': HTML5 error, code ' + this.error.code + (description ? ' (' + description + ')' : '')); + this._s._onload(false); + this._s._onerror(this.error.code, description); + + }), + + loadeddata: html5_event(function() { + + var s = this._s; + + sm2._wD(s.id + ': loadeddata'); + + // safari seems to nicely report progress events, eventually totalling 100% + if (!s._loaded && !isSafari) { + s.duration = s._get_html5_duration(); + } + + }), + + loadedmetadata: html5_event(function() { + + sm2._wD(this._s.id + ': loadedmetadata'); + + }), + + loadstart: html5_event(function() { + + sm2._wD(this._s.id + ': loadstart'); + // assume buffering at first + this._s._onbufferchange(1); + + }), + + play: html5_event(function() { + + // sm2._wD(this._s.id + ': play()'); + // once play starts, no buffering + this._s._onbufferchange(0); + + }), + + playing: html5_event(function() { + + sm2._wD(this._s.id + ': playing ' + String.fromCharCode(9835)); + // once play starts, no buffering + this._s._onbufferchange(0); + + }), + + progress: html5_event(function(e) { + + // note: can fire repeatedly after "loaded" event, due to use of HTTP range/partials + + var s = this._s, + i, j, progStr, buffered = 0, + isProgress = (e.type === 'progress'), + ranges = e.target.buffered, + // firefox 3.6 implements e.loaded/total (bytes) + loaded = (e.loaded || 0), + total = (e.total || 1); + + // reset the "buffered" (loaded byte ranges) array + s.buffered = []; + + if (ranges && ranges.length) { + + // if loaded is 0, try TimeRanges implementation as % of load + // https://developer.mozilla.org/en/DOM/TimeRanges + + // 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++) { + s.buffered.push({ + start: ranges.start(i) * msecScale, + end: ranges.end(i) * msecScale + }); + } + + // use the last value locally + 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)); + + // + 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)); + } + sm2._wD(this._s.id + ': progress, timeRanges: ' + progStr.join(', ')); + } + + if (isProgress && !isNaN(loaded)) { + sm2._wD(this._s.id + ': progress, ' + Math.floor(loaded * 100) + '% loaded'); + } + // + + } + + if (!isNaN(loaded)) { + + // TODO: prevent calls with duplicate values. + s._whileloading(loaded, total, s._get_html5_duration()); + if (loaded && total && loaded === total) { + // in case "onload" doesn't fire (eg. gecko 1.9.2) + html5_events.canplaythrough.call(this, e); + } + + } + + }), + + ratechange: html5_event(function() { + + sm2._wD(this._s.id + ': ratechange'); + + }), + + suspend: html5_event(function(e) { + + // download paused/stopped, may have finished (eg. onload) + var s = this._s; + + sm2._wD(this._s.id + ': suspend'); + html5_events.progress.call(this, e); + s._onsuspend(); + + }), + + stalled: html5_event(function() { + + sm2._wD(this._s.id + ': stalled'); + + }), + + timeupdate: html5_event(function() { + + this._s._onTimer(); + + }), + + waiting: html5_event(function() { + + var s = this._s; + + // see also: seeking + sm2._wD(this._s.id + ': waiting'); + + // playback faster than download rate, etc. + s._onbufferchange(1); + + }) + + }; + + html5OK = function(iO) { + + // playability test based on URL or MIME type + + var result; + + if (!iO || (!iO.type && !iO.url && !iO.serverURL)) { + + // nothing to check + result = false; + + } else if (iO.serverURL || (iO.type && preferFlashCheck(iO.type))) { + + // RTMP, or preferring flash + result = false; + + } else { + + // Use type, if specified. Pass data: URIs to HTML5. If HTML5-only mode, no other options, so just give 'er + result = ((iO.type ? html5CanPlay({ type: iO.type }) : html5CanPlay({ url: iO.url }) || sm2.html5Only || iO.url.match(/data:/i))); + + } + + return result; + + }; + + html5Unload = function(oAudio) { + + /** + * Internal method: Unload media, and cancel any current/pending network requests. + * Firefox can load an empty URL, which allegedly destroys the decoder and stops the download. + * https://developer.mozilla.org/En/Using_audio_and_video_in_Firefox#Stopping_the_download_of_media + * However, Firefox has been seen loading a relative URL from '' and thus requesting the hosting page on unload. + * Other UA behaviour is unclear, so everyone else gets an about:blank-style URL. + */ + + var url; + + if (oAudio) { + + // Firefox and Chrome accept short WAVe data: URIs. Chome dislikes audio/wav, but accepts audio/wav for data: MIME. + // Desktop Safari complains / fails on data: URI, so it gets about:blank. + url = (isSafari ? emptyURL : (sm2.html5.canPlayType('audio/wav') ? emptyWAV : emptyURL)); + + oAudio.src = url; + + // reset some state, too + if (oAudio._called_unload !== _undefined) { + oAudio._called_load = false; + } + + } + + if (useGlobalHTML5Audio) { + + // ensure URL state is trashed, also + lastGlobalHTML5URL = null; + + } + + return url; + + }; + + html5CanPlay = function(o) { + + /** + * Try to find MIME, test and return truthiness + * o = { + * url: '/path/to/an.mp3', + * type: 'audio/mp3' + * } + */ + + if (!sm2.useHTML5Audio || !sm2.hasHTML5) return false; + + var url = (o.url || null), + mime = (o.type || null), + aF = sm2.audioFormats, + result, + offset, + fileExt, + item; + + // account for known cases like audio/mp3 + + if (mime && sm2.html5[mime] !== _undefined) return (sm2.html5[mime] && !preferFlashCheck(mime)); + + 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); + + } + + } 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; + result = sm2.html5.canPlayType({ type: mime }); + + sm2.html5[fileExt] = result; + + // sm2._wD('canPlayType, found result: ' + result); + result = (result && sm2.html5[mime] && !preferFlashCheck(mime)); + } + + return result; + + }; + + testHTML5 = function() { + + /** + * Internal: Iterates over audioFormats, determining support eg. audio/mp3, audio/mpeg and so on + * assigns results to html5[] and flash[]. + */ + + 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. :/ + var a = (Audio !== _undefined ? (isOpera && opera.version() < 10 ? new Audio(null) : new Audio()) : null), + item, lookup, support = {}, aF, i; + + function cp(m) { + + var canPlay, j, + result = false, + isOK = false; + + if (!a || typeof a.canPlayType !== 'function') return result; + + if (m instanceof Array) { + + // iterate through all mime types, return any successes + + 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; + + } + + // test all registered formats + codecs + + aF = sm2.audioFormats; + + for (item in aF) { + + if (aF.hasOwnProperty(item)) { + + lookup = 'audio/' + item; + + support[item] = cp(aF[item].type); + + // write back generic type too, eg. audio/mp3 + support[lookup] = support[item]; + + // assign flash + if (item.match(flashMIME)) { + + sm2.flash[item] = true; + sm2.flash[lookup] = true; + + } else { + + sm2.flash[item] = false; + sm2.flash[lookup] = false; + + } + + // assign result to related formats, too + + if (aF[item] && aF[item].related) { + + for (i = aF[item].related.length - 1; i >= 0; i--) { + + // eg. audio/m4a + support['audio/' + aF[item].related[i]] = support[item]; + sm2.html5[aF[item].related[i]] = support[item]; + sm2.flash[aF[item].related[i]] = support[item]; + + } + + } + + } + + } + + support.canPlayType = (a ? cp : null); + sm2.html5 = mixin(sm2.html5, support); + + sm2.html5.usingFlash = featureCheck(); + needsFlash = sm2.html5.usingFlash; + + return true; + + }; + + strings = { + + // + notReady: 'Unavailable - wait until onready() has fired.', + notOK: 'Audio support is not available.', + domError: sm + 'exception caught while appending SWF to DOM.', + spcWmode: 'Removing wmode, preventing known SWF loading issue(s)', + swf404: smc + 'Verify that %s is a valid path.', + tryDebug: 'Try ' + sm + '.debugFlash = true for more security details (output goes to SWF.)', + checkSWF: 'See SWF output for more debug info.', + localFail: smc + 'Non-HTTP page (' + doc.location.protocol + ' URL?) Review Flash player security settings for this special case:\nhttp://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html\nMay need to add/allow path, eg. c:/sm2/ or /users/me/sm2/', + waitFocus: smc + 'Special case: Waiting for SWF to load with window focus...', + waitForever: smc + 'Waiting indefinitely for Flash (will recover if unblocked)...', + waitSWF: smc + 'Waiting for 100% SWF load...', + needFunction: smc + 'Function object expected for %s', + badID: 'Sound ID "%s" should be a string, starting with a non-numeric character', + currentObj: smc + '_debug(): Current sound objects', + waitOnload: smc + 'Waiting for window.onload()', + docLoaded: smc + 'Document already loaded', + onload: smc + 'initComplete(): calling soundManager.onload()', + onloadOK: sm + '.onload() complete', + didInit: smc + 'init(): Already called?', + secNote: 'Flash security note: Network/internet URLs will not load due to security restrictions. Access can be configured via Flash Player Global Security Settings Page: http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html', + badRemove: smc + 'Failed to remove Flash node.', + 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...', + fbLoaded: 'Flash loaded', + fbHandler: smc + 'flashBlockHandler()', + manURL: 'SMSound.load(): Using manually-assigned URL', + onURL: sm + '.load(): current URL already assigned.', + badFV: sm + '.flashVersion must be 8 or 9. "%s" is invalid. Reverting to %s.', + as2loop: 'Note: Setting stream:false so looping can work (flash 8 limitation)', + noNSLoop: 'Note: Looping not implemented for MovieStar formats', + needfl9: 'Note: Switching to flash 9, required for MP4 formats.', + mfTimeout: 'Setting flashLoadTimeout = 0 (infinite) for off-screen, mobile flash case', + needFlash: smc + 'Fatal error: Flash is needed to play some required formats, but is not available.', + gotFocus: smc + 'Got window focus.', + policy: 'Enabling usePolicyFile for data access', + setup: sm + '.setup(): allowed parameters: %s', + setupError: sm + '.setup(): "%s" cannot be assigned with this method.', + setupUndef: sm + '.setup(): Could not find option "%s"', + setupLate: sm + '.setup(): url, flashVersion and html5Test property changes will not take effect until reboot().', + noURL: smc + 'Flash URL required. Call soundManager.setup({url:...}) to get started.', + 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.', + ignoreMobile: 'Ignoring mobile restrictions for this device.' + // + + }; + + str = function() { + + // internal string replace helper. + // arguments: o [,items to replace] + // + + var args, + i, j, o, + sstr; + + // real array, please + args = slice.call(arguments); + + // first argument + o = args.shift(); + + sstr = (strings && strings[o] ? strings[o] : ''); + + if (sstr && args && args.length) { + for (i = 0, j = args.length; i < j; i++) { + sstr = sstr.replace('%s', args[i]); + } + } + + return sstr; + // + + }; + + loopFix = function(sOpt) { + + // flash 8 requires stream = false for looping to work + if (fV === 8 && sOpt.loops > 1 && sOpt.stream) { + _wDS('as2loop'); + sOpt.stream = false; + } + + return sOpt; + + }; + + policyFix = function(sOpt, sPre) { + + if (sOpt && !sOpt.usePolicyFile && (sOpt.onid3 || sOpt.usePeakData || sOpt.useWaveformData || sOpt.useEQData)) { + sm2._wD((sPre || '') + str('policy')); + sOpt.usePolicyFile = true; + } + + return sOpt; + + }; + + complain = function(sMsg) { + + // + if (hasConsole && console.warn !== _undefined) { + console.warn(sMsg); + } else { + sm2._wD(sMsg); + } + // + + }; + + doNothing = function() { + + return false; + + }; + + disableObject = function(o) { + + var oProp; + + for (oProp in o) { + if (o.hasOwnProperty(oProp) && typeof o[oProp] === 'function') { + o[oProp] = doNothing; + } + } + + oProp = null; + + }; + + failSafely = function(bNoDisable) { + + // general failure exception handler + + if (bNoDisable === _undefined) { + bNoDisable = false; + } + + if (disabled || bNoDisable) { + sm2.disable(bNoDisable); + } + + }; + + normalizeMovieURL = function(movieURL) { + + var urlParams = null, url; + + if (movieURL) { + + if (movieURL.match(/\.swf(\?.*)?$/i)) { + + urlParams = movieURL.substr(movieURL.toLowerCase().lastIndexOf('.swf?') + 4); + + // assume user knows what they're doing + if (urlParams) return movieURL; + + } else if (movieURL.lastIndexOf('/') !== movieURL.length - 1) { + + // append trailing slash, if needed + movieURL += '/'; + + } + + } + + url = (movieURL && movieURL.lastIndexOf('/') !== -1 ? movieURL.substr(0, movieURL.lastIndexOf('/') + 1) : './') + sm2.movieURL; + + if (sm2.noSWFCache) { + url += ('?ts=' + new Date().getTime()); + } + + return url; + + }; + + setVersionInfo = function() { + + // short-hand for internal use + + fV = parseInt(sm2.flashVersion, 10); + + if (fV !== 8 && fV !== 9) { + sm2._wD(str('badFV', fV, defaultFlashVersion)); + sm2.flashVersion = fV = defaultFlashVersion; + } + + // debug flash movie, if applicable + + 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)')); + + // 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')]; + + // if applicable, use _debug versions of SWFs + sm2.movieURL = (fV === 8 ? 'soundmanager2.swf' : 'soundmanager2_flash9.swf').replace('.swf', isDebug); + + sm2.features.peakData = sm2.features.waveformData = sm2.features.eqData = (fV > 8); + + }; + + setPolling = function(bPolling, bHighPerformance) { + + if (!flash) { + return; + } + + flash._setPolling(bPolling, bHighPerformance); + + }; + + initDebug = function() { + + // starts debug mode, creating output
for UAs without console object + + // allow force of debug mode via URL + // + if (sm2.debugURLParam.test(wl)) { + sm2.setupOptions.debugMode = sm2.debugMode = true; + } + + if (id(sm2.debugID)) { + return; + } + + var oD, oDebug, oTarget, oToggle, tmp; + + if (sm2.debugMode && !id(sm2.debugID) && (!hasConsole || !sm2.useConsole || !sm2.consoleOnly)) { + + oD = doc.createElement('div'); + oD.id = sm2.debugID + '-toggle'; + + oToggle = { + position: 'fixed', + bottom: '0px', + right: '0px', + width: '1.2em', + height: '1.2em', + lineHeight: '1.2em', + margin: '2px', + textAlign: 'center', + border: '1px solid #999', + cursor: 'pointer', + background: '#fff', + color: '#333', + zIndex: 10001 + }; + + oD.appendChild(doc.createTextNode('-')); + oD.onclick = toggleDebug; + oD.title = 'Toggle SM2 debug console'; + + if (ua.match(/msie 6/i)) { + oD.style.position = 'absolute'; + oD.style.cursor = 'hand'; + } + + for (tmp in oToggle) { + if (oToggle.hasOwnProperty(tmp)) { + oD.style[tmp] = oToggle[tmp]; + } + } + + oDebug = doc.createElement('div'); + oDebug.id = sm2.debugID; + 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()); + } + oTarget.appendChild(oDebug); + } + + } + + oTarget = null; + // + + }; + + idCheck = this.getSoundById; + + // + _wDS = function(o, errorLevel) { + + return (!o ? '' : sm2._wD(str(o), errorLevel)); + + }; + + toggleDebug = function() { + + var o = id(sm2.debugID), + oT = id(sm2.debugID + '-toggle'); + + if (!o) { + return; + } + + if (debugOpen) { + // minimize + oT.innerHTML = '+'; + o.style.display = 'none'; + } else { + oT.innerHTML = '-'; + o.style.display = 'block'; + } + + debugOpen = !debugOpen; + + }; + + debugTS = function(sEventType, bSuccess, sMessage) { + + // troubleshooter debug hooks + + if (window.sm2Debugger !== _undefined) { + try { + sm2Debugger.handleEvent(sEventType, bSuccess, sMessage); + } catch(e) { + // oh well + return false; + } + } + + return true; + + }; + // + + getSWFCSS = function() { + + var css = []; + + if (sm2.debugMode) { + css.push(swfCSS.sm2Debug); + } + + if (sm2.debugFlash) { + css.push(swfCSS.flashDebug); + } + + if (sm2.useHighPerformance) { + css.push(swfCSS.highPerf); + } + + return css.join(' '); + + }; + + flashBlockHandler = function() { + + // *possible* flash block situation. + + var name = str('fbHandler'), + p = sm2.getMoviePercent(), + css = swfCSS, + error = { + type: 'FLASHBLOCK' + }; + + if (sm2.html5Only) { + // no flash, or unused + return; + } + + if (!sm2.ok()) { + + if (needsFlash) { + // make the movie more visible, so user can fix + 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 + }); + + catchError(error); + + } else { + + // SM2 loaded OK (or recovered) + + // + if (sm2.didFlashBlock) { + sm2._wD(name + ': Unblocked'); + } + // + + if (sm2.oMC) { + sm2.oMC.className = [getSWFCSS(), css.swfDefault, css.swfLoaded + (sm2.didFlashBlock ? ' ' + css.swfUnblocked : '')].join(' '); + } + + } + + }; + + addOnEvent = function(sType, oMethod, oScope) { + + if (on_queue[sType] === _undefined) { + on_queue[sType] = []; + } + + on_queue[sType].push({ + method: oMethod, + scope: (oScope || null), + fired: false + }); + + }; + + processOnEvents = function(oOptions) { + + // if unspecified, assume OK/error + + if (!oOptions) { + oOptions = { + type: (sm2.ok() ? 'onready' : 'ontimeout') + }; + } + + // not ready yet. + if (!didInit && oOptions && !oOptions.ignoreInit) return false; + + // invalid case + if (oOptions.type === 'ontimeout' && (sm2.ok() || (disabled && !oOptions.ignoreInit))) return false; + + var status = { + success: (oOptions && oOptions.ignoreInit ? sm2.ok() : !disabled) + }, + + // queue specified by type, or none + srcQueue = (oOptions && oOptions.type ? on_queue[oOptions.type] || [] : []), + + queue = [], i, j, + args = [status], + canRetry = (needsFlash && !sm2.ok()); + + if (oOptions.error) { + args[0].error = oOptions.error; + } + + for (i = 0, j = srcQueue.length; i < j; i++) { + if (srcQueue[i].fired !== true) { + queue.push(srcQueue[i]); + } + } + + if (queue.length) { + + // 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; + + }; + + initUserOnload = function() { + + window.setTimeout(function() { + + if (sm2.useFlashBlock) { + flashBlockHandler(); + } + + processOnEvents(); + + // call user-defined "onload", scoped to window + + if (typeof sm2.onload === 'function') { + _wDS('onload', 1); + sm2.onload.apply(window); + _wDS('onloadOK', 1); + } + + if (sm2.waitForWindowLoad) { + event.add(window, 'load', initUserOnload); + } + + }, 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 + */ + + // this work has already been done. + if (hasFlash !== _undefined) return hasFlash; + + var hasPlugin = false, n = navigator, obj, type, types, AX = window.ActiveXObject; + + // MS Edge 14 throws an "Unspecified Error" because n.plugins is inaccessible due to permissions + var nP; + + try { + nP = n.plugins; + } catch(e) { + nP = undefined; + } + + 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'); + } catch(e) { + // oh well + obj = null; + } + + hasPlugin = (!!obj); + + // cleanup, because it is ActiveX after all + obj = null; + + } + + hasFlash = hasPlugin; + + return hasPlugin; + + }; + + featureCheck = function() { + + var flashNeeded, + item, + formats = sm2.audioFormats, + // iPhone <= 3.1 has broken HTML5 audio(), but firmware 3.2 (original iPad) + iOS4 works. + isSpecial = (is_iDevice && !!(ua.match(/os (1|2|3_0|3_1)\s/i))); + + if (isSpecial) { + + // has Audio(), but is broken; let it load links directly. + sm2.hasHTML5 = false; + + // ignore flash case, however + sm2.html5Only = true; + + // hide the SWF, if present + if (sm2.oMC) { + sm2.oMC.style.display = 'none'; + } + + } else if (sm2.useHTML5Audio) { + + if (!sm2.html5 || !sm2.html5.canPlayType) { + sm2._wD('SoundManager: No HTML5 Audio() support detected.'); + sm2.hasHTML5 = false; + } + + // + 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); + } + // + + } + + if (sm2.useHTML5Audio && sm2.hasHTML5) { + + // sort out whether flash is optional, required or can be ignored. + + // innocent until proven guilty. + 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; + + } + + } + + } + + } + + } + + // sanity check... + if (sm2.ignoreFlash) { + flashNeeded = false; + canIgnoreFlash = true; + } + + sm2.html5Only = (sm2.hasHTML5 && sm2.useHTML5Audio && !flashNeeded); + + return (!sm2.html5Only); + + }; + + parseURL = function(url) { + + /** + * Internal: Finds and returns the first playable URL (or failing that, the first URL.) + * @param {string or array} url A single URL string, OR, an array of URL strings or {url:'/path/to/resource', type:'audio/mp3'} objects. + */ + + var i, j, urlResult = 0, result; + + if (url instanceof Array) { + + // find the first good one + for (i = 0, j = url.length; i < j; i++) { + + if (url[i] instanceof Object) { + + // MIME check + if (sm2.canPlayMIME(url[i].type)) { + urlResult = i; + break; + } + + } else if (sm2.canPlayURL(url[i])) { + + // URL string check + urlResult = i; + break; + + } + + } + + // normalize to string + if (url[urlResult].url) { + url[urlResult] = url[urlResult].url; + } + + result = url[urlResult]; + + } else { + + // single URL case + result = url; + + } + + return result; + + }; + + + startTimer = function(oSound) { + + /** + * attach a timer to this sound, and start an interval if needed + */ + + if (!oSound._hasTimer) { + + oSound._hasTimer = true; + + if (!mobileHTML5 && sm2.html5PollingInterval) { + + if (h5IntervalTimer === null && h5TimerCount === 0) { + + h5IntervalTimer = setInterval(timerExecute, sm2.html5PollingInterval); + + } + + h5TimerCount++; + + } + + } + + }; + + stopTimer = function(oSound) { + + /** + * detach a timer + */ + + if (oSound._hasTimer) { + + oSound._hasTimer = false; + + if (!mobileHTML5 && sm2.html5PollingInterval) { + + // interval will stop itself at next execution. + + h5TimerCount--; + + } + + } + + }; + + timerExecute = function() { + + /** + * manual polling for HTML5 progress events, ie., whileplaying() + * (can achieve greater precision than conservative default HTML5 interval) + */ + + var i; + + if (h5IntervalTimer !== null && !h5TimerCount) { + + // no active timers, stop polling interval. + + clearInterval(h5IntervalTimer); + + h5IntervalTimer = null; + + return; + + } + + // check all HTML5 sounds with timers + + 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(); + } + + } + + }; + + catchError = function(options) { + + options = (options !== _undefined ? options : {}); + + if (typeof sm2.onerror === 'function') { + sm2.onerror.apply(window, [{ + type: (options.type !== _undefined ? options.type : null) + }]); + } + + if (options.fatal !== _undefined && options.fatal) { + sm2.disable(); + } + + }; + + badSafariFix = function() { + + // special case: "bad" Safari (OS X 10.3 - 10.7) must fall back to flash for MP3/MP4 + if (!isBadSafari || !detectFlash()) { + // doesn't apply + return; + } + + 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--) { + sm2.html5[aF[item].related[i]] = false; + } + } + + } + + } + + } + + }; + + /** + * Pseudo-private flash/ExternalInterface methods + * ---------------------------------------------- + */ + + this._setSandboxType = function(sandboxType) { + + // + // Security sandbox according to Flash plugin + var sb = sm2.sandbox; + + sb.type = sandboxType; + sb.description = sb.types[(sb.types[sandboxType] !== _undefined ? sandboxType : 'unknown')]; + + if (sb.type === 'localWithFile') { + + sb.noRemote = true; + sb.noLocal = false; + _wDS('secNote', 2); + + } else if (sb.type === 'localWithNetwork') { + + sb.noRemote = false; + sb.noLocal = true; + + } else if (sb.type === 'localTrusted') { + + sb.noRemote = false; + sb.noLocal = false; + + } + // + + }; + + this._externalInterfaceOK = function(swfVersion) { + + // flash callback confirming flash loaded, EI working etc. + // swfVersion: SWF build string + + if (sm2.swfLoaded) { + return; + } + + var e; + + debugTS('swf', true); + debugTS('flashtojs', true); + sm2.swfLoaded = true; + tryInitOnFocus = false; + + if (isBadSafari) { + badSafariFix(); + } + + // complain if JS + SWF build/version strings don't match, excluding +DEV builds + // + if (!swfVersion || swfVersion.replace(/\+dev/i, '') !== sm2.versionNumber.replace(/\+dev/i, '')) { + + e = sm + ': Fatal: JavaScript file build "' + sm2.versionNumber + '" does not match Flash SWF build "' + swfVersion + '" at ' + sm2.url + '. Ensure both are up-to-date.'; + + // escape flash -> JS stack so this error fires in window. + setTimeout(function() { + throw new Error(e); + }, 0); + + // exit, init will fail with timeout + return; + + } + // + + // IE needs a larger timeout + setTimeout(init, isIE ? 100 : 1); + + }; + + /** + * Private initialization helpers + * ------------------------------ + */ + + createMovie = function(movieID, movieURL) { + + // ignore if already connected + if (didAppend && appendSuccess) return false; + + function initMsg() { + + // + + var options = [], + title, + msg = [], + delimiter = ' + '; + + title = 'SoundManager ' + sm2.version + (!sm2.html5Only && sm2.useHTML5Audio ? (sm2.hasHTML5 ? ' + HTML5 audio' : ', no HTML5 audio support') : ''); + + if (!sm2.html5Only) { + + if (sm2.preferFlash) { + options.push('preferFlash'); + } + + if (sm2.useHighPerformance) { + options.push('useHighPerformance'); + } + + if (sm2.flashPollingInterval) { + options.push('flashPollingInterval (' + sm2.flashPollingInterval + 'ms)'); + } + + if (sm2.html5PollingInterval) { + options.push('html5PollingInterval (' + sm2.html5PollingInterval + 'ms)'); + } + + if (sm2.wmode) { + options.push('wmode (' + sm2.wmode + ')'); + } + + if (sm2.debugFlash) { + options.push('debugFlash'); + } + + if (sm2.useFlashBlock) { + options.push('flashBlock'); + } + + } else if (sm2.html5PollingInterval) { + options.push('html5PollingInterval (' + sm2.html5PollingInterval + 'ms)'); + } + + if (options.length) { + msg = msg.concat([options.join(delimiter)]); + } + + sm2._wD(title + (msg.length ? delimiter + msg.join(', ') : ''), 1); + + showSupport(); + + // + + } + + if (sm2.html5Only) { + + // 100% HTML5 mode + setVersionInfo(); + + initMsg(); + sm2.oMC = id(sm2.movieID); + init(); + + // prevent multiple init attempts + didAppend = true; + + appendSuccess = true; + + return false; + + } + + // flash path + var remoteURL = (movieURL || sm2.url), + localURL = (sm2.altURL || remoteURL), + swfTitle = 'JS/Flash audio component (SoundManager 2)', + oTarget = getDocument(), + extraClass = getSWFCSS(), + isRTL = null, + html = doc.getElementsByTagName('html')[0], + oEmbed, oMovie, tmp, movieHTML, oEl, s, x, sClass; + + isRTL = (html && html.dir && html.dir.match(/rtl/i)); + movieID = (movieID === _undefined ? sm2.id : movieID); + + function param(name, value) { + return ''; + } + + // safety check for legacy (change to Flash 9 URL) + setVersionInfo(); + sm2.url = normalizeMovieURL(overHTTP ? remoteURL : localURL); + movieURL = sm2.url; + + sm2.wmode = (!sm2.wmode && sm2.useHighPerformance ? 'transparent' : sm2.wmode); + + if (sm2.wmode !== null && (ua.match(/msie 8/i) || (!isIE && !sm2.useHighPerformance)) && navigator.platform.match(/win32|win64/i)) { + /** + * extra-special case: movie doesn't load until scrolled into view when using wmode = anything but 'window' here + * does not apply when using high performance (position:fixed means on-screen), OR infinite flash load timeout + * wmode breaks IE 8 on Vista + Win7 too in some cases, as of January 2011 (?) + */ + messages.push(strings.spcWmode); + sm2.wmode = null; + } + + oEmbed = { + name: movieID, + id: movieID, + src: movieURL, + quality: 'high', + allowScriptAccess: sm2.allowScriptAccess, + bgcolor: sm2.bgColor, + pluginspage: http + 'www.macromedia.com/go/getflashplayer', + title: swfTitle, + type: 'application/x-shockwave-flash', + wmode: sm2.wmode, + // http://help.adobe.com/en_US/as3/mobile/WS4bebcd66a74275c36cfb8137124318eebc6-7ffd.html + hasPriority: 'true' + }; + + if (sm2.debugFlash) { + oEmbed.FlashVars = 'debug=1'; + } + + if (!sm2.wmode) { + // don't write empty attribute + delete oEmbed.wmode; + } + + if (isIE) { + + // IE is "special". + oMovie = doc.createElement('div'); + movieHTML = [ + '', + param('movie', movieURL), + param('AllowScriptAccess', sm2.allowScriptAccess), + param('quality', oEmbed.quality), + (sm2.wmode ? param('wmode', sm2.wmode) : ''), + param('bgcolor', sm2.bgColor), + param('hasPriority', 'true'), + (sm2.debugFlash ? param('FlashVars', oEmbed.FlashVars) : ''), + '' + ].join(''); + + } else { + + oMovie = doc.createElement('embed'); + for (tmp in oEmbed) { + if (oEmbed.hasOwnProperty(tmp)) { + oMovie.setAttribute(tmp, oEmbed[tmp]); + } + } + + } + + initDebug(); + extraClass = getSWFCSS(); + oTarget = getDocument(); + + if (oTarget) { + + sm2.oMC = (id(sm2.movieID) || doc.createElement('div')); + + if (!sm2.oMC.id) { + + sm2.oMC.id = sm2.movieID; + sm2.oMC.className = swfCSS.swfDefault + ' ' + extraClass; + s = null; + oEl = null; + + if (!sm2.useFlashBlock) { + if (sm2.useHighPerformance) { + // on-screen at all times + s = { + position: 'fixed', + width: '8px', + height: '8px', + // >= 6px for flash to run fast, >= 8px to start up under Firefox/win32 in some cases. odd? yes. + bottom: '0px', + left: '0px', + overflow: 'hidden' + }; + } else { + // hide off-screen, lower priority + s = { + position: 'absolute', + width: '6px', + height: '6px', + top: '-9999px', + left: '-9999px' + }; + if (isRTL) { + s.left = Math.abs(parseInt(s.left, 10)) + 'px'; + } + } + } + + if (isWebkit) { + // soundcloud-reported render/crash fix, safari 5 + sm2.oMC.style.zIndex = 10000; + } + + if (!sm2.debugFlash) { + for (x in s) { + if (s.hasOwnProperty(x)) { + sm2.oMC.style[x] = s[x]; + } + } + } + + 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()); + + } + + } 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.appendChild(oMovie); + + if (isIE) { + oEl = sm2.oMC.appendChild(doc.createElement('div')); + oEl.className = swfCSS.swfBox; + oEl.innerHTML = movieHTML; + } + + appendSuccess = true; + + } + + } + + didAppend = true; + + initMsg(); + + // sm2._wD(sm + ': Trying to load ' + movieURL + (!overHTTP && sm2.altURL ? ' (alternate URL)' : ''), 1); + + return true; + + }; + + initMovie = function() { + + if (sm2.html5Only) { + createMovie(); + return false; + } + + // attempt to get, or create, movie (may already exist) + if (flash) return false; + + if (!sm2.url) { + + /** + * Something isn't right - we've reached init, but the soundManager url property has not been set. + * User has not called setup({url: ...}), or has not set soundManager.url (legacy use case) directly before init time. + * Notify and exit. If user calls setup() with a url: property, init will be restarted as in the deferred loading case. + */ + + _wDS('noURL'); + return false; + + } + + // inline markup case + 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') { + setTimeout(sm2.oninitmovie, 1); + } + + // + flushMessages(); + // + + return true; + + }; + + delayWaitForEI = function() { + + setTimeout(waitForEI, 1000); + + }; + + rebootIntoHTML5 = function() { + + // special case: try for a reboot with preferFlash: false, if 100% HTML5 mode is possible and useFlashBlock is not enabled. + + window.setTimeout(function() { + + complain(smc + 'useFlashBlock is false, 100% HTML5 mode is possible. Rebooting with preferFlash: false...'); + + sm2.setup({ + preferFlash: false + }).reboot(); + + // if for some reason you want to detect this case, use an ontimeout() callback and look for html5Only and didFlashBlock == true. + sm2.didFlashBlock = true; + + sm2.beginDelayedInit(); + + }, 1); + + }; + + waitForEI = function() { + + var p, + loadIncomplete = false; + + if (!sm2.url) { + // No SWF url to load (noURL case) - exit for now. Will be retried when url is set. + return; + } + + if (waitingForEI) { + return; + } + + waitingForEI = true; + event.remove(window, 'load', delayWaitForEI); + + if (hasFlash && tryInitOnFocus && !isFocused) { + // Safari won't load flash in background tabs, only when focused. + _wDS('waitFocus'); + return; + } + + if (!didInit) { + p = sm2.getMoviePercent(); + if (p > 0 && p < 100) { + loadIncomplete = true; + } + } + + setTimeout(function() { + + p = sm2.getMoviePercent(); + + if (loadIncomplete) { + // special case: if movie *partially* loaded, retry until it's 100% before assuming failure. + waitingForEI = false; + sm2._wD(str('waitSWF')); + window.setTimeout(delayWaitForEI, 1); + return; + } + + // + 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); + + if (!overHTTP && p) { + + _wDS('localFail', 2); + + if (!sm2.debugFlash) { + _wDS('tryDebug', 2); + } + + } + + if (p === 0) { + + // if 0 (not null), probably a 404. + sm2._wD(str('swf404', sm2.url), 1); + + } + + debugTS('flashtojs', false, ': Timed out' + (overHTTP ? ' (Check flash security or flash blockers)' : ' (No plugin/missing SWF?)')); + + } + // + + // give up / time-out, depending + + if (!didInit && okToDisable) { + + if (p === null) { + + // SWF failed to report load progress. Possibly blocked. + + if (sm2.useFlashBlock || sm2.flashLoadTimeout === 0) { + + if (sm2.useFlashBlock) { + + flashBlockHandler(); + + } + + _wDS('waitForever'); + + } else if (!sm2.useFlashBlock && canIgnoreFlash) { + + // no custom flash block handling, but SWF has timed out. Will recover if user unblocks / allows SWF load. + rebootIntoHTML5(); + + } else { + + _wDS('waitForever'); + + // fire any regular registered ontimeout() listeners. + processOnEvents({ + type: 'ontimeout', + ignoreInit: true, + error: { + type: 'INIT_FLASHBLOCK' + } + }); + + } + + } else if (sm2.flashLoadTimeout === 0) { + + // SWF loaded? Shouldn't be a blocking issue, then. + + _wDS('waitForever'); + + } else if (!sm2.useFlashBlock && canIgnoreFlash) { + + rebootIntoHTML5(); + + } else { + + failSafely(true); + + } + + } + + }, sm2.flashLoadTimeout); + + }; + + handleFocus = function() { + + function cleanup() { + event.remove(window, 'focus', handleFocus); + } + + if (isFocused || !tryInitOnFocus) { + // already focused, or not special Safari background tab case + cleanup(); + return true; + } + + okToDisable = true; + isFocused = true; + _wDS('gotFocus'); + + // allow init to restart + waitingForEI = false; + + // kick off ExternalInterface timeout, now that the SWF has started + delayWaitForEI(); + + cleanup(); + return true; + + }; + + flushMessages = function() { + + // + + // SM2 pre-init debug messages + if (messages.length) { + sm2._wD('SoundManager 2: ' + messages.join(' '), 1); + messages = []; + } + + // + + }; + + showSupport = function() { + + // + + flushMessages(); + + var item, tests = []; + + 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)' : '')))); + } + } + sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); + } + + // + + }; + + initComplete = function(bNoDisable) { + + if (didInit) return false; + + if (sm2.html5Only) { + // all good. + _wDS('sm2Loaded', 1); + didInit = true; + initUserOnload(); + debugTS('onload', true); + return true; + } + + var wasTimeout = (sm2.useFlashBlock && sm2.flashLoadTimeout && !sm2.getMoviePercent()), + result = true, + error; + + if (!wasTimeout) { + didInit = true; + } + + 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); + } + + 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 { + + // + if (sm2.waitForWindowLoad && windowLoaded) { + _wDS('docLoaded'); + } + // + + initUserOnload(); + + } + + } + + return result; + + }; + + /** + * apply top-level setupOptions object as local properties, eg., this.setupOptions.flashVersion -> this.flashVersion (soundManager.flashVersion) + * this maintains backward compatibility, and allows properties to be defined separately for use by soundManager.setup(). + */ + + setProperties = function() { + + var i, + o = sm2.setupOptions; + + for (i in o) { + + if (o.hasOwnProperty(i)) { + + // assign local property if not already defined + + if (sm2[i] === _undefined) { + + sm2[i] = o[i]; + + } else if (sm2[i] !== o[i]) { + + // legacy support: write manually-assigned property (eg., soundManager.url) back to setupOptions to keep things in sync + sm2.setupOptions[i] = sm2[i]; + + } + + } + + } + + }; + + + init = function() { + + // called after onload() + + if (didInit) { + _wDS('didInit'); + return false; + } + + function cleanup() { + event.remove(window, 'load', sm2.beginDelayedInit); + } + + if (sm2.html5Only) { + + if (!didInit) { + // we don't need no steenking flash! + cleanup(); + sm2.enabled = true; + initComplete(); + } + + return true; + + } + + // flash path + initMovie(); + + try { + + // 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) + */ + setPolling(true, (sm2.flashPollingInterval || (sm2.useHighPerformance ? 10 : 50))); + + if (!sm2.debugMode) { + // stop the SWF from making debug output calls to JS + flash._disableDebug(); + } + + sm2.enabled = true; + debugTS('jstoflash', true); + + if (!sm2.html5Only) { + // prevent browser from showing cached page state (or rather, restoring "suspended" page state) via back button, because flash may be dead + // http://www.webkit.org/blog/516/webkit-page-cache-ii-the-unload-event/ + event.add(window, 'unload', doNothing); + } + + } catch(e) { + + sm2._wD('js/flash exception: ' + e.toString()); + + debugTS('jstoflash', false); + + catchError({ + type: 'JS_TO_FLASH_EXCEPTION', + fatal: true + }); + + // don't disable, for reboot() + failSafely(true); + + initComplete(); + + return false; + + } + + initComplete(); + + // disconnect events + cleanup(); + + return true; + + }; + + domContentLoaded = function() { + + if (didDCLoaded) return false; + + didDCLoaded = true; + + // assign top-level soundManager properties eg. soundManager.url + setProperties(); + + initDebug(); + + 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) { + doc.removeEventListener('DOMContentLoaded', domContentLoaded, false); + } + + initMovie(); + + return true; + + }; + + domContentLoadedIE = function() { + + if (doc.readyState === 'complete') { + domContentLoaded(); + doc.detachEvent('onreadystatechange', domContentLoadedIE); + } + + return true; + + }; + + winOnLoad = function() { + + // catch edge case of initComplete() firing after window.load() + windowLoaded = true; + + // catch case where DOMContentLoaded has been sent, but we're still in doc.readyState = 'interactive' + domContentLoaded(); + + event.remove(window, 'load', winOnLoad); + + }; + + // sniff up-front + detectFlash(); + + // focus and window load, init (primarily flash-driven) + event.add(window, 'focus', handleFocus); + event.add(window, 'load', delayWaitForEI); + event.add(window, 'load', winOnLoad); + + if (doc.addEventListener) { + + doc.addEventListener('DOMContentLoaded', domContentLoaded, false); + + } else if (doc.attachEvent) { + + doc.attachEvent('onreadystatechange', domContentLoadedIE); + + } else { + + // no add/attachevent support - safe to assume no JS -> Flash either + debugTS('onload', false); + catchError({ + type: 'NO_DOM2_EVENTS', + fatal: true + }); + + } + +} // SoundManager() + +// SM2_DEFER details: http://www.schillmania.com/projects/soundmanager2/doc/getstarted/#lazy-loading + +if (window.SM2_DEFER === _undefined || !SM2_DEFER) { + soundManager = new SoundManager(); +} + +/** + * SoundManager public interfaces + * ------------------------------ + */ + +if (typeof module === 'object' && module && typeof module.exports === 'object') { + + /** + * commonJS module + */ + + module.exports.SoundManager = SoundManager; + module.exports.soundManager = soundManager; + +} else if (typeof define === 'function' && define.amd) { + + /** + * 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(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 { + constructor: SoundManager, + getInstance: getInstance + }; + }); + +} + +// standard browser case + +// 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)); From b7742cb77798adb21bb3e375bd7819d1b7da1533 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 9 Jul 2017 11:32:56 -0700 Subject: [PATCH 02/59] First whack at HTML5-only SoundManager 2 core, removing all the Flash-specific bits; 64 KB shaved off, down to 100 KB (incl. debug bits, comments, formatting.) --- script/soundmanager2-html5.js | 2842 ++++----------------------------- 1 file changed, 318 insertions(+), 2524 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index d38b38d5..2a5b2dcf 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -1,14 +1,14 @@ /** @license * - * SoundManager 2: JavaScript Sound for the Web - * ---------------------------------------------- + * SoundManager 2: JavaScript Sound for the Web (HTML5-only version) + * ----------------------------------------------------------------- * http://schillmania.com/projects/soundmanager2/ * * Copyright (c) 2007, Scott Schiller. All rights reserved. * Code provided under the BSD License: * http://schillmania.com/projects/soundmanager2/license.txt * - * V2.97a.20170601 + * V2.97a.20170601-HTML5+DEV */ /** @@ -17,7 +17,7 @@ * This is the fully-commented source version of the SoundManager 2 API, * recommended for use during development and testing. * - * See soundmanager2-nodebug-jsmin.js for an optimized build (~11KB with gzip.) + * See soundmanager2-html5-nodebug-jsmin.js for an optimized build (~11KB with gzip.) * http://schillmania.com/projects/soundmanager2/doc/getstarted/#basic-inclusion * Alternately, serve this file with gzip for 75% compression savings (~30KB over HTTP.) * @@ -29,7 +29,7 @@ (function SM2(window, _undefined) { -/* global Audio, document, window, navigator, define, module, SM2_DEFER, opera, setTimeout, setInterval, clearTimeout, sm2Debugger */ +/* global Audio, document, window, navigator, define, module, opera, setTimeout, setInterval, clearTimeout, sm2Debugger */ 'use strict'; @@ -48,43 +48,26 @@ var soundManager = null; * The SoundManager constructor. * * @constructor - * @param {string} smURL Optional: Path to SWF files - * @param {string} smID Optional: The ID to use for the SWF container element * @this {SoundManager} * @return {SoundManager} The new SoundManager instance */ -function SoundManager(smURL, smID) { +function SoundManager() { /** * soundManager configuration options list - * defines top-level configuration properties to be applied to the soundManager instance (eg. soundManager.flashVersion) - * to set these properties, use the setup() method - eg., soundManager.setup({url: '/swf/', flashVersion: 9}) + * defines top-level configuration properties to be applied to the soundManager instance (eg. soundManager.debugMode) + * to set these properties, use the setup() method - eg., soundManager.setup({debugMode: true, ignoreMobileRestrictions: true}); */ this.setupOptions = { - url: (smURL || null), // path (directory) where SoundManager 2 SWFs exist, eg., /path/to/swfs/ - flashVersion: 8, // flash build to use (8 or 9.) Some API features require 9. debugMode: true, // enable debugging output (console.log() with HTML fallback) - debugFlash: false, // enable debugging output inside SWF, troubleshoot Flash/browser issues - useConsole: true, // use console.log() if available (otherwise, writes to #soundmanager-debug element) - consoleOnly: true, // if console is being used, do not create/write to #soundmanager-debug waitForWindowLoad: false, // force SM2 to wait for window.onload() before trying to call soundManager.onload() - bgColor: '#ffffff', // SWF background color. N/A when wmode = 'transparent' - useHighPerformance: false, // position:fixed flash movie can help increase js/flash speed, minimize lag - flashPollingInterval: null, // msec affecting whileplaying/loading callback frequency. If null, default of 50 msec is used. html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. - flashLoadTimeout: 1000, // msec to wait for flash movie to load before failing (0 = infinity) - 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 (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. idPrefix: 'sound' // if an id is not provided to createSound(), this prefix is used for generated IDs - 'sound0', 'sound1' etc. }; @@ -114,53 +97,19 @@ function SoundManager(smURL, smID) { multiShot: true, // let sounds "restart" or layer on top of each other when played multiple times, rather than one-shot/one at a time multiShotEvents: false, // fire multiple sound events (currently onfinish() only) when multiShot is enabled position: null, // offset (milliseconds) to seek to within loaded sound data. - pan: 0, // "pan" settings, left-to-right, -100 to 100 playbackRate: 1, // rate at which to play the sound (HTML5-only) stream: true, // allows playing before entire file has loaded (recommended) to: null, // position to end playback within a sound (msec), default = end type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 - usePolicyFile: false, // enable crossdomain.xml request for audio on remote domains (for ID3/waveform access) volume: 100 // self-explanatory. 0-100, the latter being the max. }; - this.flash9Options = { - - /** - * flash 9-only options, - * merged into defaultOptions if flash 9 is being used - */ - - onfailure: null, // callback function for when playing fails (Flash 9, MovieStar + RTMP-only) - isMovieStar: null, // "MovieStar" MPEG4 audio mode. Null (default) = auto detect MP4, AAC etc. based on URL. true = force on, ignore URL - usePeakData: false, // enable left/right channel peak (level) data - useWaveformData: false, // enable sound spectrum (raw waveform data) - NOTE: May increase CPU load. - useEQData: false, // enable sound EQ (frequency spectrum data) - NOTE: May increase CPU load. - onbufferchange: null, // callback for "isBuffering" property change - ondataerror: null // callback for waveform/eq data access error (flash playing audio in other tabs/domains) - - }; - - this.movieStarOptions = { - - /** - * flash 9.0r115+ MPEG4 audio options, - * merged into defaultOptions if flash 9+movieStar mode is enabled - */ - - bufferTime: 3, // seconds of data to buffer before playback begins (null = flash default of 0.1 seconds - if AAC playback is gappy, try increasing.) - serverURL: null, // rtmp: FMS or FMIS server to connect to, required when requesting media via RTMP or one of its variants - onconnect: null, // rtmp: callback for connection to flash media server - duration: null // rtmp: song duration (msec) - - }; - this.audioFormats = { /** - * determines HTML5 support + flash requirements. - * if no support (via flash and/or HTML5) for a "required" format, SM2 will fail to start. - * flash fallback is used for MP3 or MP4 if HTML5 can't play it (or if preferFlash = true) + * determines HTML5 support. + * if no support for a "required" format, SM2 will fail to start. */ mp3: { @@ -196,35 +145,20 @@ function SoundManager(smURL, smID) { }; - // HTML attributes (id + class names) for the SWF container - - this.movieID = 'sm2-container'; - this.id = (smID || 'sm2movie'); - - this.debugID = 'soundmanager-debug'; this.debugURLParam = /([#?&])debug=1/i; // dynamic attributes - this.versionNumber = 'V2.97a.20170601'; + this.versionNumber = 'V2.97a.20170601-HTML5+DEV'; this.version = null; - this.movieURL = null; - this.altURL = null; - this.swfLoaded = false; this.enabled = false; - this.oMC = null; this.sounds = {}; this.soundIDs = []; this.muted = false; - this.didFlashBlock = false; - this.filePattern = null; + this.didFlashBlock = false; // legacy + this.filePattern = new RegExp(''); // legacy - this.filePatterns = { - flash8: /\.mp3(\?.*)?$/i, - flash9: /\.mp3(\?.*)?$/i - }; - - // support indicators, set at init + // support indicators, set at init (mostly legacy flash backcompat stuff) this.features = { buffering: false, @@ -234,88 +168,33 @@ function SoundManager(smURL, smID) { movieStar: false }; - // flash sandbox info, used primarily in troubleshooting - - this.sandbox = { - // - type: null, - types: { - remote: 'remote (domain-based) rules', - localWithFile: 'local with file access (no internet access)', - localWithNetwork: 'local with network (internet access only, no local access)', - localTrusted: 'local, trusted (local+internet access)' - }, - description: null, - noRemote: null, - noLocal: null - // - }; - /** - * format support (html5/flash) + * format support * stores canPlayType() results based on audioFormats. * eg. { mp3: boolean, mp4: boolean } * treat as read-only. */ this.html5 = { - usingFlash: null // set if/when flash fallback is needed + usingFlash: false // legacy: set if/when flash fallback is needed }; - // file type support hash - this.flash = {}; - - // determined at init time - this.html5Only = false; - - // used for special cases (eg. iPad/iPhone/palm OS?) - this.ignoreFlash = false; - /** * a few private internals (OK, a lot. :D) */ 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, 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, html5ErrorCodes, 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|trident/i), - isWebkit = ua.match(/webkit/i), + sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, initUserOnload, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], + html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, + is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/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\sX\s10_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, - 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), - http = (!overHTTP ? '//' : ''), - // mp3, mp4, aac etc. - netStreamMimeTypes = /^\s*audio\/(?:x-)?(?:mpeg4|aac|flv|mov|mp4|m4v|m4a|m4b|mp4v|3gp|3g2)\s*(?:$|;)/i, - // Flash v9.0r115+ "moviestar" formats - netStreamTypes = ['mpeg4', 'aac', 'flv', 'mov', 'mp4', 'm4v', 'f4v', 'm4a', 'm4b', 'mp4v', '3gp', '3g2'], - netStreamPattern = new RegExp('\\.(' + netStreamTypes.join('|') + ')(\\?.*)?$', 'i'); - + emptyURL = 'about:blank', // safe URL to unload, or load nothing from (most HTML5 UAs) + emptyWAV = 'data:audio/wave;base64,/UklGRiYAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQIAAAD//w=='; // tiny WAV for HTML5 unloading this.mimePattern = /^\s*audio\/(?:x-)?(?:mp(?:eg|3))\s*(?:$|;)/i; // default mp3 set - // use altURL if not "online" - this.useAltURL = !overHTTP; - - swfCSS = { - swfBox: 'sm2-object-box', - swfDefault: 'movieContainer', - swfError: 'swf_error', // SWF loaded, but SM2 couldn't start (other error) - swfTimedout: 'swf_timedout', - swfLoaded: 'swf_loaded', - swfUnblocked: 'swf_unblocked', // or loaded OK - sm2Debug: 'sm2_debug', - highPerf: 'high_performance', - flashDebug: 'flash_debug' - }; - /** * HTML5 error codes, per W3C * Error code 1, MEDIA_ERR_ABORTED: Client aborted download at user's request. @@ -355,22 +234,12 @@ function SoundManager(smURL, smID) { /** * Configures top-level soundManager properties. * - * @param {object} options Option parameters, eg. { flashVersion: 9, url: '/path/to/swfs/' } + * @param {object} options Option parameters, eg. soundManager.setup({debugMode: true, ignoreMobileRestrictions: true}); * onready and ontimeout are also accepted parameters. call soundManager.setup() to see the full list. */ this.setup = function(options) { - var noURL = (!sm2.url); - - // warn if flash options have already been applied - - if (options !== _undefined && didInit && needsFlash && sm2.ok() && (options.flashVersion !== _undefined || options.url !== _undefined || options.html5Test !== _undefined)) { - complain(str('setupLate')); - } - - // TODO: defer: true? - assign(options); if (!useGlobalHTML5Audio) { @@ -399,57 +268,20 @@ function SoundManager(smURL, smID) { messages.push(strings.ignoreMobile); - } else { + } else if ((isAndroid && !ua.match(/android\s2\.3/i)) || !isAndroid) { - // prefer HTML5 for mobile + tablet-like devices, probably more reliable vs. flash at this point. + /** + * 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. + */ // - if (!sm2.setupOptions.useHTML5Audio || sm2.setupOptions.preferFlash) { - // notify that defaults are being changed. - sm2._wD(strings.mobileUA); - } + sm2._wD(strings.globalHTML5); // - 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. - */ - - // - sm2._wD(strings.globalHTML5); - // - - 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) { - - if (noURL && didDCLoaded && options.url !== _undefined) { - sm2.beginDelayedInit(); - } - - // special case 2: If lazy-loading SM2 (DOMContentLoaded has already happened) and user calls setup() with url: parameter, try to init ASAP. + useGlobalHTML5Audio = true; - if (!didDCLoaded && options.url !== _undefined && doc.readyState === 'complete') { - setTimeout(domContentLoaded, 1); } } @@ -462,19 +294,12 @@ function SoundManager(smURL, smID) { this.ok = function() { - return (needsFlash ? (didInit && !disabled) : (sm2.useHTML5Audio && sm2.hasHTML5)); + return sm2.hasHTML5; }; this.supported = this.ok; // legacy - this.getMovie = function(movie_id) { - - // safety net: some old browsers differ on SWF references, possibly related to ExternalInterface / flash version - return id(movie_id) || doc[movie_id] || window[movie_id]; - - }; - /** * Creates a SMSound sound object instance. Can also be overloaded, e.g., createSound('mySound', '/some.mp3'); * @@ -529,7 +354,6 @@ function SoundManager(smURL, smID) { function make() { - options = loopFix(options); sm2.sounds[options.id] = new SMSound(options); sm2.soundIDs.push(options.id); return sm2.sounds[options.id]; @@ -539,69 +363,13 @@ function SoundManager(smURL, smID) { if (html5OK(options)) { oSound = make(); - // - if (!sm2.html5Only) { - sm2._wD(options.id + ': Using HTML5'); - } - // oSound._setup_html5(options); } else { - if (sm2.html5Only) { - sm2._wD(options.id + ': No HTML5 support for this sound, and no Flash. Exiting.'); - return make(); - } - - // TODO: Move HTML5/flash checks into generic URL parsing/handling function. - - if (sm2.html5.usingFlash && options.url && options.url.match(/data:/i)) { - // data: URIs not supported by Flash, either. - sm2._wD(options.id + ': data: URIs not supported via Flash. Exiting.'); - return make(); - } - - if (fV > 8) { - if (options.isMovieStar === null) { - // attempt to detect MPEG-4 formats - options.isMovieStar = !!(options.serverURL || (options.type ? options.type.match(netStreamMimeTypes) : false) || (options.url && options.url.match(netStreamPattern))); - } - // - if (options.isMovieStar) { - sm2._wD(cs + 'using MovieStar handling'); - if (options.loops > 1) { - _wDS('noNSLoop'); - } - } - // - } - - options = policyFix(options, cs); - oSound = make(); - - if (fV === 8) { - 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); - if (!options.serverURL) { - // We are connected immediately - oSound.connected = true; - if (options.onconnect) { - options.onconnect.apply(oSound); - } - } - } - - if (!options.serverURL && (options.autoLoad || options.autoPlay)) { - // call load for non-rtmp streams - oSound.load(options); - } - - } + sm2._wD(options.id + ': No HTML5 support for this sound. Exiting.'); + return make(); - // rtmp will play in onconnect - if (!options.serverURL && options.autoPlay) { - oSound.play(); } return oSound; @@ -1062,38 +830,15 @@ function SoundManager(smURL, smID) { }; - /** - * Retrieves the memory used by the flash plugin. - * - * @return {number} The amount of memory in use - */ - - this.getMemoryUse = function() { - - // flash-only - var ram = 0; - - if (flash && fV !== 8) { - ram = parseInt(flash._getMemoryUse(), 10); - } - - return ram; - - }; - /** * Undocumented: NOPs soundManager and all SMSound objects. */ - this.disable = function(bNoDisable) { + this.disable = function() { // destroy all functions var i; - if (bNoDisable === _undefined) { - bNoDisable = false; - } - // already disabled? if (disabled) return false; @@ -1108,7 +853,7 @@ function SoundManager(smURL, smID) { disableObject(sm2); // fire "complete", despite fail - initComplete(bNoDisable); + initComplete(); event.remove(window, 'load', initUserOnload); @@ -1130,11 +875,6 @@ function SoundManager(smURL, smID) { }); } - if (!result && needsFlash) { - // if flash 9, test netStream (movieStar) types as well. - result = (sMIME && sm2.ok() ? !!((fV > 8 ? sMIME.match(netStreamMimeTypes) : null) || sMIME.match(sm2.mimePattern)) : null); // TODO: make less "weird" (per JSLint) - } - return result; }; @@ -1156,10 +896,6 @@ function SoundManager(smURL, smID) { }); } - if (!result && needsFlash) { - result = (sURL && sm2.ok() ? !!(sURL.match(sm2.filePattern)) : null); - } - return result; }; @@ -1291,73 +1027,22 @@ function SoundManager(smURL, smID) { this._writeDebug = function(sText, sTypeOrObject) { // pseudo-private console.log()-style output - // - - var sDID = 'soundmanager-debug', o, oItem; - - if (!sm2.setupOptions.debugMode) return false; - - if (hasConsole && sm2.useConsole) { - if (sTypeOrObject && typeof sTypeOrObject === 'object') { - // object passed; dump to console. - console.log(sText, sTypeOrObject); - } else if (debugLevels[sTypeOrObject] !== _undefined) { - console[debugLevels[sTypeOrObject]](sText); - } else { - console.log(sText); - } - if (sm2.consoleOnly) return true; - } - - o = id(sDID); - - if (!o) return false; - oItem = doc.createElement('div'); - - if (++wdCount % 2 === 0) { - oItem.className = 'sm2-alt'; - } + // + if (!sm2.setupOptions.debugMode || !hasConsole) return; - if (sTypeOrObject === _undefined) { - sTypeOrObject = 0; + if (sTypeOrObject && typeof sTypeOrObject === 'object') { + // object passed; dump to console. + console.log(sText, sTypeOrObject); + } else if (debugLevels[sTypeOrObject] !== _undefined) { + console[debugLevels[sTypeOrObject]](sText); } else { - sTypeOrObject = parseInt(sTypeOrObject, 10); - } - - oItem.appendChild(doc.createTextNode(sText)); - - if (sTypeOrObject) { - if (sTypeOrObject >= 2) { - oItem.style.fontWeight = 'bold'; - } - if (sTypeOrObject === 3) { - oItem.style.color = '#ff3333'; - } + console.log(sText); } - - // top-to-bottom - // o.appendChild(oItem); - - // bottom-to-top - o.insertBefore(oItem, o.firstChild); - - o = null; // - return true; - }; - // - // last-resort debugging option - if (wl.indexOf('sm2-debug=alert') !== -1) { - this._writeDebug = function(sText) { - window.alert(sText); - }; - } - // - // alias this._wD = this._writeDebug; @@ -1402,33 +1087,7 @@ function SoundManager(smURL, smID) { sm2.sounds[sm2.soundIDs[i]].destruct(); } - // trash ze flash (remove from the DOM) - - if (flash) { - - try { - - if (isIE) { - oRemovedHTML = flash.innerHTML; - } - - oRemoved = flash.parentNode.removeChild(flash); - - } catch(e) { - - // Remove failed? May be due to flash blockers silently removing the SWF object/embed node from the DOM. Warn and continue. - - _wDS('badRemove', 2); - - } - - } - - // actually, force recreate of movie. - - oRemovedHTML = oRemoved = needsFlash = flash = null; - - sm2.enabled = didDCLoaded = didInit = waitingForEI = initPending = didAppend = appendSuccess = disabled = useGlobalHTML5Audio = sm2.swfLoaded = false; + sm2.enabled = didDCLoaded = didInit = disabled = useGlobalHTML5Audio = false; sm2.soundIDs = []; sm2.sounds = {}; @@ -1456,29 +1115,6 @@ function SoundManager(smURL, smID) { } // - // reset HTML5 and flash canPlay test results - - sm2.html5 = { - usingFlash: null - }; - - sm2.flash = {}; - - // reset device-specific HTML/flash mode switches - - sm2.html5Only = false; - sm2.ignoreFlash = false; - - window.setTimeout(function() { - - // by default, re-init - - if (!excludeInit) { - sm2.beginDelayedInit(); - } - - }, 20); - return sm2; }; @@ -1497,48 +1133,14 @@ function SoundManager(smURL, smID) { }; - /** - * Undocumented: Determines the SM2 flash movie's load progress. - * - * @return {number or null} Percent loaded, or if invalid/unsupported, null. - */ - - this.getMoviePercent = function() { - - /** - * Interesting syntax notes... - * Flash/ExternalInterface (ActiveX/NPAPI) bridge methods are not typeof "function" nor instanceof Function, but are still valid. - * Furthermore, using (flash && flash.PercentLoaded) causes IE to throw "object doesn't support this property or method". - * Thus, 'in' syntax must be used. - */ - - return (flash && 'PercentLoaded' in flash ? flash.PercentLoaded() : null); - - }; - /** * Additional helper for manually invoking SM2's init process after DOM Ready / window.onload(). */ this.beginDelayedInit = function() { - windowLoaded = true; domContentLoaded(); - setTimeout(function() { - - if (initPending) return false; - - createMovie(); - initMovie(); - initPending = true; - - return true; - - }, 20); - - delayWaitForEI(); - }; /** @@ -1562,7 +1164,7 @@ function SoundManager(smURL, smID) { SMSound = function(oOptions) { - var s = this, resetProperties, add_html5_events, remove_html5_events, stop_html5_timer, start_html5_timer, attachOnPosition, onplay_called = false, onPositionItems = [], onPositionFired = 0, detachOnPosition, applyFromTo, lastURL = null, lastHTML5State, urlOmitted; + var s = this, resetProperties, add_html5_events, remove_html5_events, stop_html5_timer, start_html5_timer, attachOnPosition, onplay_called = false, onPositionItems = [], onPositionFired = 0, detachOnPosition, applyFromTo, lastURL = null, lastHTML5State; lastHTML5State = { // tracks duration + position (time) @@ -1585,7 +1187,6 @@ function SoundManager(smURL, smID) { this._iO = this.instanceOptions; // assign property defaults - this.pan = this.options.pan; this.volume = this.options.volume; // whether or not this object is using HTML5 @@ -1594,15 +1195,12 @@ function SoundManager(smURL, smID) { // internal HTML5 Audio() object reference this._a = null; - // for flash 8 special-case createSound() without url, followed by load/play with url case - urlOmitted = (!this.url); - /** * SMSound() public methods * ------------------------ */ - this.id3 = {}; + this.id3 = {}; // legacy /** * Writes SMSound object parameters to debug console @@ -1658,21 +1256,12 @@ function SoundManager(smURL, smID) { return s; } - // - if (!s.isHTML5 && fV === 8 && !s.url && !instanceOptions.autoPlay) { - // flash 8 load() -> play() won't work before onload has fired. - sm2._wD(s.id + ': Flash 8 load() limitation: Wait for onload() before calling play().', 1); - } - // - if (instanceOptions.url === s.url && s.readyState !== 0 && s.readyState !== 2) { _wDS('onURL', 1); // if loaded and an onload() exists, fire immediately. if (s.readyState === 3 && instanceOptions.onload) { // assume success based on truthy duration. - wrapCallback(s, function() { - instanceOptions.onload.apply(s, [(!!s.duration)]); - }); + instanceOptions.onload.apply(s, [(!!s.duration)]); } return s; } @@ -1682,7 +1271,6 @@ function SoundManager(smURL, smID) { s.loaded = false; s.readyState = 1; s.playState = 0; - s.id3 = {}; // TODO: If switching from HTML5 -> flash (or vice versa), stop currently-playing audio. @@ -1712,10 +1300,6 @@ function SoundManager(smURL, smID) { } // given explicit load call, try to preload. - - // early HTML5 implementation (non-standard) - s._a.autobuffer = 'auto'; - // standard property, values: none / metadata / auto // reference: http://msdn.microsoft.com/en-us/library/ie/ff974759%28v=vs.85%29.aspx s._a.preload = 'auto'; @@ -1730,40 +1314,8 @@ function SoundManager(smURL, smID) { } else { - if (sm2.html5Only) { - sm2._wD(s.id + ': No flash support. Exiting.'); - return s; - } - - if (s._iO.url && s._iO.url.match(/data:/i)) { - // data: URIs not supported by Flash, either. - sm2._wD(s.id + ': data: URIs not supported via Flash. Exiting.'); - return s; - } - - try { - s.isHTML5 = false; - s._iO = policyFix(loopFix(instanceOptions)); - // if we have "position", disable auto-play as we'll be seeking to that position at onload(). - if (s._iO.autoPlay && (s._iO.position || s._iO.from)) { - sm2._wD(s.id + ': Disabling autoPlay because of non-zero offset case'); - s._iO.autoPlay = false; - } - // re-assign local shortcut - instanceOptions = s._iO; - 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); - } - } catch(e) { - _wDS('smError', 2); - debugTS('onload', false); - catchError({ - type: 'SMSOUND_LOAD_JS_EXCEPTION', - fatal: true - }); - } + sm2._wD(s.id + ': No support for this format. Exiting.'); + return s; } @@ -1782,42 +1334,27 @@ function SoundManager(smURL, smID) { this.unload = function() { - // Flash 8/AS2 can't "close" a stream - fake it by loading an empty URL - // Flash 9/AS3: Close stream, preventing further load - // HTML5: Most UAs will use empty URL - - if (s.readyState !== 0) { - - sm2._wD(s.id + ': unload()'); - - if (!s.isHTML5) { - - if (fV === 8) { - flash._unload(s.id, emptyURL); - } else { - flash._unload(s.id); - } - - } else { - - stop_html5_timer(); + // Most UAs will use an empty URL to unload. - if (s._a) { + // already done? + if (s.readyState === 0) return s; - s._a.pause(); + sm2._wD(s.id + ': unload()'); - // update empty URL, too - lastURL = html5Unload(s._a); + stop_html5_timer(); - } + if (s._a) { - } + s._a.pause(); - // reset load/status flags - resetProperties(); + // update empty URL, too + lastURL = html5Unload(s._a); } + // reset load/status flags + resetProperties(); + return s; }; @@ -1830,28 +1367,17 @@ function SoundManager(smURL, smID) { sm2._wD(s.id + ': Destruct'); - if (!s.isHTML5) { + stop_html5_timer(); - // kill sound within Flash - // Disable the onfailure handler - s._iO.onfailure = null; - flash._destroySound(s.id); - - } else { - - stop_html5_timer(); - - if (s._a) { - s._a.pause(); - html5Unload(s._a); - if (!useGlobalHTML5Audio) { - remove_html5_events(); - } - // break obvious circular reference - s._a._s = null; - s._a = null; + if (s._a) { + s._a.pause(); + html5Unload(s._a); + if (!useGlobalHTML5Audio) { + remove_html5_events(); } - + // break obvious circular reference + s._a._s = null; + s._a = null; } if (!_bFromSM) { @@ -1871,8 +1397,7 @@ function SoundManager(smURL, smID) { this.play = function(options, _updatePlayState) { var fN, allowMulti, a, onready, - audioClone, onended, oncanplay, - startOK = true; + audioClone, onended, oncanplay; // fN = s.id + ': play(): '; @@ -1900,16 +1425,6 @@ function SoundManager(smURL, smID) { s.instanceOptions = s._iO; - // RTMP-only - if (!s.isHTML5 && s._iO.serverURL && !s.connected) { - if (!s.getAutoPlay()) { - sm2._wD(fN + ' Netstream not connected yet - setting autoPlay'); - s.setAutoPlay(true); - } - // play will be called in onconnect() - return s; - } - if (html5OK(s._iO)) { s._setup_html5(s._iO); start_html5_timer(); @@ -1923,10 +1438,8 @@ function SoundManager(smURL, smID) { sm2._wD(fN + 'Already playing (one-shot)', 1); - if (s.isHTML5) { - // go back to original position. - s.setPosition(s._iO.position); - } + // go back to original position. + s.setPosition(s._iO.position); return s; @@ -1939,17 +1452,8 @@ function SoundManager(smURL, smID) { // edge case: play() with explicit URL parameter if (options.url && options.url !== s.url) { - // special case for createSound() followed by load() / play() with url; avoid double-load case. - if (!s.readyState && !s.isHTML5 && fV === 8 && urlOmitted) { - - urlOmitted = false; - - } else { - - // load using merged options - s.load(s._iO); - - } + // load using merged options + s.load(s._iO); } @@ -1959,25 +1463,8 @@ function SoundManager(smURL, smID) { sm2._wD(fN + 'Attempting to load'); - // try to get this sound playing ASAP - if (!s.isHTML5 && !sm2.html5Only) { - - // flash: assign directly because setAutoPlay() increments the instanceCount - s._iO.autoPlay = true; - s.load(s._iO); - - } else if (s.isHTML5) { - - // iOS needs this when recycling sounds, loading a new URL on an existing object. - s.load(s._iO); - - } else { - - sm2._wD(fN + 'Unsupported type. Exiting.'); - - return s; - - } + // iOS needs this when recycling sounds, loading a new URL on an existing object. + s.load(s._iO); // HTML5 hack - re-set instanceOptions? s.instanceOptions = s._iO; @@ -2001,12 +1488,6 @@ 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'); - options.position = 0; - } - /** * Streams will pause when their buffer is full if they are being loaded. * In this case paused is true, but the song hasn't started playing yet. @@ -2022,160 +1503,126 @@ function SoundManager(smURL, smID) { sm2._wD(fN + 'Resuming from paused state', 1); s.resume(); - } else { + return s; - s._iO = mixin(options, s._iO); + } - /** - * Preload in the event of play() with position under Flash, - * or from/to parameters and non-RTMP case - */ - if (((!s.isHTML5 && s._iO.position !== null && s._iO.position > 0) || (s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0 && !s._iO.serverURL) { + s._iO = mixin(options, s._iO); - onready = function() { - // sound "canplay" or onload() - // re-apply position/from/to to instance options, and start playback - s._iO = mixin(options, s._iO); - s.play(s._iO); - }; + /** + * Preload in the event of play() with position under Flash, + * or from/to parameters and non-RTMP case + */ + if (((s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0) { - // HTML5 needs to at least have "canplay" fired before seeking. - if (s.isHTML5 && !s._html5_canplay) { - - // this hasn't been loaded yet. load it first, and then do this again. - sm2._wD(fN + 'Beginning load for non-zero offset case'); - - s.load({ - // note: custom HTML5-only event added for from/to implementation. - _oncanplay: onready - }); - - } else if (!s.isHTML5 && !s.loaded && (!s.readyState || s.readyState !== 2)) { - - // to be safe, preload the whole thing in Flash. - - sm2._wD(fN + 'Preloading for non-zero offset case'); - - s.load({ - onload: onready - }); - - } - - // otherwise, we're ready to go. re-apply local options, and continue - - s._iO = applyFromTo(); - - } - - // sm2._wD(fN + 'Starting to play'); - - // increment instance counter, where enabled + supported - if (!s.instanceCount || s._iO.multiShotEvents || (s.isHTML5 && s._iO.multiShot && !useGlobalHTML5Audio) || (!s.isHTML5 && fV > 8 && !s.getAutoPlay())) { - s.instanceCount++; - } + onready = function() { + // sound "canplay" or onload() + // re-apply position/from/to to instance options, and start playback + s._iO = mixin(options, s._iO); + s.play(s._iO); + }; - // if first play and onposition parameters exist, apply them now - if (s._iO.onposition && s.playState === 0) { - attachOnPosition(s); - } + // HTML5 needs to at least have "canplay" fired before seeking. + if (s.isHTML5 && !s._html5_canplay) { - s.playState = 1; - s.paused = false; + // this hasn't been loaded yet. load it first, and then do this again. + sm2._wD(fN + 'Beginning load for non-zero offset case'); - s.position = (s._iO.position !== _undefined && !isNaN(s._iO.position) ? s._iO.position : 0); + s.load({ + // note: custom HTML5-only event added for from/to implementation. + _oncanplay: onready + }); - if (!s.isHTML5) { - s._iO = policyFix(loopFix(s._iO)); } - if (s._iO.onplay && _updatePlayState) { - s._iO.onplay.apply(s); - onplay_called = true; - } + // otherwise, we're ready to go. re-apply local options, and continue + s._iO = applyFromTo(); - s.setVolume(s._iO.volume, true); - s.setPan(s._iO.pan, true); + } - if (s._iO.playbackRate !== 1) { - s.setPlaybackRate(s._iO.playbackRate); - } + // increment instance counter, where enabled + supported + if (!s.instanceCount || s._iO.multiShotEvents || (s._iO.multiShot && !useGlobalHTML5Audio)) { + s.instanceCount++; + } - if (!s.isHTML5) { + // if first play and onposition parameters exist, apply them now + if (s._iO.onposition && s.playState === 0) { + attachOnPosition(s); + } - startOK = flash._start(s.id, s._iO.loops || 1, (fV === 9 ? s.position : s.position / msecScale), s._iO.multiShot || false); + s.playState = 1; + s.paused = false; + s.position = (s._iO.position !== _undefined && !isNaN(s._iO.position) ? s._iO.position : 0); - if (fV === 9 && !startOK) { - // edge case: no sound hardware, or 32-channel flash ceiling hit. - // applies only to Flash 9, non-NetStream/MovieStar sounds. - // http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html#play%28%29 - sm2._wD(fN + 'No sound hardware, or 32-sound ceiling hit', 2); - if (s._iO.onplayerror) { - s._iO.onplayerror.apply(s); - } + if (s._iO.onplay && _updatePlayState) { + s._iO.onplay.apply(s); + onplay_called = true; + } - } + s.setVolume(s._iO.volume, true); - } else if (s.instanceCount < 2) { + if (s._iO.playbackRate !== 1) { + s.setPlaybackRate(s._iO.playbackRate); + } - // HTML5 single-instance case + if (s.instanceCount < 2) { - start_html5_timer(); + // HTML5 single-instance case - a = s._setup_html5(); + start_html5_timer(); - s.setPosition(s._iO.position); + a = s._setup_html5(); - a.play(); + s.setPosition(s._iO.position); - } else { + a.play(); - // HTML5 multi-shot case + } else { - sm2._wD(s.id + ': Cloning Audio() for instance #' + s.instanceCount + '...'); + // HTML5 multi-shot case - audioClone = new Audio(s._iO.url); + sm2._wD(s.id + ': Cloning Audio() for instance #' + s.instanceCount + '...'); - onended = function() { - event.remove(audioClone, 'ended', onended); - s._onfinish(s); - // cleanup - html5Unload(audioClone); - audioClone = null; - }; + audioClone = new Audio(s._iO.url); - oncanplay = function() { - event.remove(audioClone, 'canplay', oncanplay); - try { - audioClone.currentTime = s._iO.position / msecScale; - } catch(err) { - complain(s.id + ': multiShot play() failed to apply position of ' + (s._iO.position / msecScale)); - } - audioClone.play(); - }; + onended = function() { + event.remove(audioClone, 'ended', onended); + s._onfinish(s); + // cleanup + html5Unload(audioClone); + audioClone = null; + }; - event.add(audioClone, 'ended', onended); + oncanplay = function() { + event.remove(audioClone, 'canplay', oncanplay); + try { + audioClone.currentTime = s._iO.position / msecScale; + } catch(err) { + complain(s.id + ': multiShot play() failed to apply position of ' + (s._iO.position / msecScale)); + } + audioClone.play(); + }; - // apply volume to clones, too - if (s._iO.volume !== _undefined) { - audioClone.volume = Math.max(0, Math.min(1, s._iO.volume / 100)); - } + event.add(audioClone, 'ended', onended); - // playing multiple muted sounds? if you do this, you're weird ;) - but let's cover it. - if (s.muted) { - audioClone.muted = true; - } + // apply volume to clones, too + if (s._iO.volume !== _undefined) { + audioClone.volume = Math.max(0, Math.min(1, s._iO.volume / 100)); + } - if (s._iO.position) { - // HTML5 audio can't seek before onplay() event has fired. - // wait for canplay, then seek to position and start playback. - event.add(audioClone, 'canplay', oncanplay); - } else { - // begin playback at currentTime: 0 - audioClone.play(); - } + // playing multiple muted sounds? if you do this, you're weird ;) - but let's cover it. + if (s.muted) { + audioClone.muted = true; + } - } + if (s._iO.position) { + // HTML5 audio can't seek before onplay() event has fired. + // wait for canplay, then seek to position and start playback. + event.add(audioClone, 'canplay', oncanplay); + } else { + // begin playback at currentTime: 0 + audioClone.play(); + } } @@ -2187,13 +1634,12 @@ function SoundManager(smURL, smID) { this.start = this.play; /** - * Stops playing a sound (and optionally, all sounds) + * Stops playing a sound * - * @param {boolean} bAll Optional: Whether to stop all sounds * @return {SMSound} The SMSound object */ - this.stop = function(bAll) { + this.stop = function() { var instanceOptions = s._iO, originalPosition; @@ -2206,10 +1652,6 @@ function SoundManager(smURL, smID) { s._resetOnPosition(0); s.paused = false; - if (!s.isHTML5) { - s.playState = 0; - } - // remove onPosition listeners, if any detachOnPosition(); @@ -2218,37 +1660,28 @@ function SoundManager(smURL, smID) { s.clearOnPosition(instanceOptions.to); } - if (!s.isHTML5) { - - flash._stop(s.id, bAll); - - // hack for netStream: just unload - if (instanceOptions.serverURL) { - s.unload(); - } - - } else if (s._a) { + if (s._a) { - originalPosition = s.position; + originalPosition = s.position; - // act like Flash, though - s.setPosition(0); + // act like Flash, though + s.setPosition(0); - // hack: reflect old position for onstop() (also like Flash) - s.position = originalPosition; + // hack: reflect old position for onstop() (also like Flash) + s.position = originalPosition; - // html5 has no stop() - // NOTE: pausing means iOS requires interaction to resume. - s._a.pause(); + // html5 has no stop() + // NOTE: pausing means iOS requires interaction to resume. + s._a.pause(); - s.playState = 0; + s.playState = 0; - // and update UI - s._onTimer(); + // and update UI + s._onTimer(); - stop_html5_timer(); + stop_html5_timer(); - } + } s.instanceCount = 0; s._iO = {}; @@ -2263,42 +1696,6 @@ function SoundManager(smURL, smID) { }; - /** - * Undocumented/internal: Sets autoPlay for RTMP. - * - * @param {boolean} autoPlay state - */ - - this.setAutoPlay = function(autoPlay) { - - sm2._wD(s.id + ': Autoplay turned ' + (autoPlay ? 'on' : 'off')); - s._iO.autoPlay = autoPlay; - - if (!s.isHTML5) { - flash._setAutoPlay(s.id, autoPlay); - if (autoPlay) { - // only increment the instanceCount if the sound isn't loaded (TODO: verify RTMP) - if (!s.instanceCount && s.readyState === 1) { - s.instanceCount++; - sm2._wD(s.id + ': Incremented instance count to ' + s.instanceCount); - } - } - } - - }; - - /** - * Undocumented/internal: Returns the autoPlay boolean. - * - * @return {boolean} The current autoPlay value - */ - - this.getAutoPlay = function() { - - return s._iO.autoPlay; - - }; - /** * Sets the playback rate of a sound (HTML5-only.) * @@ -2318,13 +1715,11 @@ function SoundManager(smURL, smID) { } // - if (s.isHTML5) { - try { - s._iO.playbackRate = normalizedRate; - s._a.playbackRate = normalizedRate; - } catch(e) { - sm2._wD(s.id + ': setPlaybackRate(' + normalizedRate + ') failed: ' + e.message, 2); - } + try { + s._iO.playbackRate = normalizedRate; + s._a.playbackRate = normalizedRate; + } catch(e) { + sm2._wD(s.id + ': setPlaybackRate(' + normalizedRate + ') failed: ' + e.message, 2); } return s; @@ -2344,65 +1739,54 @@ function SoundManager(smURL, smID) { nMsecOffset = 0; } - var position, position1K, + var position1K, // Use the duration from the instance options, if we don't have a track duration yet. // position >= 0 and <= current available (loaded) duration - offset = (s.isHTML5 ? Math.max(nMsecOffset, 0) : Math.min(s.duration || s._iO.duration, Math.max(nMsecOffset, 0))); + offset = Math.max(nMsecOffset, 0); s.position = offset; position1K = s.position / msecScale; s._resetOnPosition(s.position); s._iO.position = offset; - if (!s.isHTML5) { - - position = (fV === 9 ? s.position : position1K); + if (!s._a) return s; - if (s.readyState && s.readyState !== 2) { - // if paused or not playing, will not resume (by playing) - flash._setPosition(s.id, position, (s.paused || !s.playState), s._iO.multiShot); - } - - } else if (s._a) { + // Set the position in the canplay handler if the sound is not ready yet + if (s._html5_canplay) { - // Set the position in the canplay handler if the sound is not ready yet - if (s._html5_canplay) { + if (s._a.currentTime.toFixed(3) !== position1K.toFixed(3)) { - if (s._a.currentTime.toFixed(3) !== position1K.toFixed(3)) { + /** + * DOM/JS errors/exceptions to watch out for: + * if seek is beyond (loaded?) position, "DOM exception 11" + * "INDEX_SIZE_ERR": DOM exception 1 + */ + sm2._wD(s.id + ': setPosition(' + position1K + ')'); - /** - * DOM/JS errors/exceptions to watch out for: - * if seek is beyond (loaded?) position, "DOM exception 11" - * "INDEX_SIZE_ERR": DOM exception 1 - */ - sm2._wD(s.id + ': setPosition(' + position1K + ')'); - - try { - s._a.currentTime = position1K; - if (s.playState === 0 || s.paused) { - // allow seek without auto-play/resume - s._a.pause(); - } - } catch(e) { - sm2._wD(s.id + ': setPosition(' + position1K + ') failed: ' + e.message, 2); + try { + s._a.currentTime = position1K; + if (s.playState === 0 || s.paused) { + // allow seek without auto-play/resume + s._a.pause(); } - + } catch(e) { + sm2._wD(s.id + ': setPosition(' + position1K + ') failed: ' + e.message, 2); } - } else if (position1K) { + } - // warn on non-zero seek attempts - sm2._wD(s.id + ': setPosition(' + position1K + '): Cannot seek yet, sound not ready', 2); - return s; + } else if (position1K) { - } + // warn on non-zero seek attempts + sm2._wD(s.id + ': setPosition(' + position1K + '): Cannot seek yet, sound not ready', 2); + return s; - if (s.paused) { + } - // if paused, refresh UI right away by forcing update - s._onTimer(true); + if (s.paused) { - } + // if paused, refresh UI right away by forcing update + s._onTimer(true); } @@ -2416,21 +1800,15 @@ function SoundManager(smURL, smID) { * @return {SMSound} The SMSound object */ - this.pause = function(_bCallFlash) { + this.pause = function() { if (s.paused || (s.playState === 0 && s.readyState !== 1)) return s; sm2._wD(s.id + ': pause()'); s.paused = true; - if (!s.isHTML5) { - if (_bCallFlash || _bCallFlash === _undefined) { - flash._pause(s.id, s._iO.multiShot); - } - } else { - s._setup_html5().pause(); - stop_html5_timer(); - } + s._setup_html5().pause(); + stop_html5_timer(); if (s._iO.onpause) { s._iO.onpause.apply(s); @@ -2464,22 +1842,8 @@ function SoundManager(smURL, smID) { s.paused = false; 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(); - - } + s._setup_html5().play(); + start_html5_timer(); if (!onplay_called && instanceOptions.onplay) { @@ -2508,7 +1872,7 @@ function SoundManager(smURL, smID) { if (s.playState === 0) { s.play({ - position: (fV === 9 && !s.isHTML5 ? s.position : s.position / msecScale) + position: (s.position / msecScale) }); return s; } @@ -2525,6 +1889,7 @@ function SoundManager(smURL, smID) { /** * Sets the panning (L-R) effect. + * Note: Not supported via HTML5. * * @param {number} nPan The pan value (-100 to 100) * @return {SMSound} The SMSound object @@ -2540,10 +1905,6 @@ function SoundManager(smURL, smID) { bInstanceOnly = false; } - if (!s.isHTML5) { - flash._setPan(s.id, nPan); - } // else { no HTML5 pan? } - s._iO.pan = nPan; if (!bInstanceOnly) { @@ -2579,11 +1940,7 @@ function SoundManager(smURL, smID) { _bInstanceOnly = false; } - if (!s.isHTML5) { - - flash._setVolume(s.id, (sm2.muted && !s.muted) || s.muted ? 0 : nVol); - - } else if (s._a) { + if (s._a) { if (sm2.muted && !s.muted) { s.muted = true; @@ -2616,9 +1973,7 @@ function SoundManager(smURL, smID) { s.muted = true; - if (!s.isHTML5) { - flash._setVolume(s.id, 0); - } else if (s._a) { + if (s._a) { s._a.muted = true; } @@ -2635,11 +1990,8 @@ function SoundManager(smURL, smID) { this.unmute = function() { s.muted = false; - var hasIO = (s._iO.volume !== _undefined); - if (!s.isHTML5) { - flash._setVolume(s.id, hasIO ? s._iO.volume : s.options.volume); - } else if (s._a) { + if (s._a) { s._a.muted = false; } @@ -2869,17 +2221,13 @@ function SoundManager(smURL, smID) { start_html5_timer = function() { - if (s.isHTML5) { - startTimer(s); - } + startTimer(s); }; stop_html5_timer = function() { - if (s.isHTML5) { - stopTimer(s); - } + stopTimer(s); }; @@ -2901,12 +2249,6 @@ function SoundManager(smURL, smID) { s.durationEstimate = null; s.buffered = []; - // legacy: 1D array - s.eqData = []; - - s.eqData.left = []; - s.eqData.right = []; - s.failures = 0; s.isBuffering = false; s.instanceOptions = {}; @@ -2920,6 +2262,11 @@ function SoundManager(smURL, smID) { s.muted = false; s.paused = false; + // legacy Flash bits: eqData, peakData, waveformData, id3 + s.eqData = []; + s.eqData.left = []; + s.eqData.right = []; + s.peakData = { left: 0, right: 0 @@ -2988,13 +2335,7 @@ function SoundManager(smURL, smID) { } - }/* else { - - // sm2._wD('_onTimer: Warn for "'+s.id+'": '+(!s._a?'Could not find element. ':'')+(s.playState === 0?'playState bad, 0?':'playState = '+s.playState+', OK')); - - return false; - - }*/ + } } @@ -3212,35 +2553,19 @@ function SoundManager(smURL, smID) { var fN, // check for duration to prevent false positives from flash 8 when loading from cache. - loadOK = !!nSuccess || (!s.isHTML5 && fV === 8 && s.duration); + loadOK = !!nSuccess; // 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); - } - if (sm2.sandbox.noLocal === true) { - sm2._wD(fN + str('noLocal'), 1); - } - } // s.loaded = loadOK; s.readyState = (loadOK ? 3 : 2); s._onbufferchange(0); - if (!loadOK && !s.isHTML5) { - // note: no error code from Flash. - s._onerror(); - } - if (s._iO.onload) { - wrapCallback(s, function() { - s._iO.onload.apply(s, [loadOK]); - }); + s._iO.onload.apply(s, [loadOK]); } return true; @@ -3251,9 +2576,7 @@ function SoundManager(smURL, smID) { // https://html.spec.whatwg.org/multipage/embedded-content.html#error-codes if (s._iO.onerror) { - wrapCallback(s, function() { - s._iO.onerror.apply(s, [errorCode, description]); - }); + s._iO.onerror.apply(s, [errorCode, description]); } }; @@ -3310,19 +2633,6 @@ function SoundManager(smURL, smID) { }; - /** - * flash 9/movieStar + RTMP-only method for unhandled warnings/exceptions from Flash - * e.g., RTMP "method missing" warning (non-fatal) for getStreamLength on server - */ - - this._onwarning = function(msg, level, code) { - - if (s._iO.onwarning) { - s._iO.onwarning(msg, level, code); - } - - }; - this._onfinish = function() { // store local copy before it gets trashed... @@ -3350,9 +2660,7 @@ function SoundManager(smURL, smID) { stop_html5_timer(); // reset position, too - if (s.isHTML5) { - s.position = 0; - } + s.position = 0; } @@ -3360,9 +2668,7 @@ function SoundManager(smURL, smID) { // fire onfinish for last, or every instance if (io_onfinish) { sm2._wD(s.id + ': onfinish()'); - wrapCallback(s, function() { - io_onfinish.apply(s); - }); + io_onfinish.apply(s); } } @@ -3378,86 +2684,26 @@ function SoundManager(smURL, smID) { s.bytesTotal = nBytesTotal; s.duration = Math.floor(nDuration); s.bufferLength = nBufferLength; - - if (!s.isHTML5 && !instanceOptions.isMovieStar) { - - if (instanceOptions.duration) { - // use duration from options, if specified and larger. nobody should be specifying duration in options, actually, and it should be retired. - s.durationEstimate = (s.duration > instanceOptions.duration) ? s.duration : instanceOptions.duration; - } else { - s.durationEstimate = parseInt((s.bytesTotal / s.bytesLoaded) * s.duration, 10); - } - - } else { - - s.durationEstimate = s.duration; - - } - - // for flash, reflect sequential-load-style buffering - if (!s.isHTML5) { - s.buffered = [{ - start: 0, - end: s.duration - }]; - } + s.durationEstimate = s.duration; // allow whileloading to fire even if "load" fired under HTML5, due to HTTP range/partials - if ((s.readyState !== 3 || s.isHTML5) && instanceOptions.whileloading) { + if (instanceOptions.whileloading) { instanceOptions.whileloading.apply(s); } }; - this._whileplaying = function(nPosition, oPeakData, oWaveformDataLeft, oWaveformDataRight, oEQData) { - - var instanceOptions = s._iO, - eqLeft; + this._whileplaying = function(nPosition) { - // flash safety net - if (isNaN(nPosition) || nPosition === null) return false; + var instanceOptions = s._iO; // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. Unexpected/invalid per W3, I think. Normalize to 0. s.position = Math.max(0, nPosition); s._processOnPosition(); - if (!s.isHTML5 && fV > 8) { - - if (instanceOptions.usePeakData && oPeakData !== _undefined && oPeakData) { - s.peakData = { - left: oPeakData.leftPeak, - right: oPeakData.rightPeak - }; - } - - if (instanceOptions.useWaveformData && oWaveformDataLeft !== _undefined && oWaveformDataLeft) { - s.waveformData = { - left: oWaveformDataLeft.split(','), - right: oWaveformDataRight.split(',') - }; - } - - if (instanceOptions.useEQData) { - if (oEQData !== _undefined && oEQData && oEQData.leftEQ) { - eqLeft = oEQData.leftEQ.split(','); - s.eqData = eqLeft; - s.eqData.left = eqLeft; - if (oEQData.rightEQ !== _undefined && oEQData.rightEQ) { - s.eqData.right = oEQData.rightEQ.split(','); - } - } - } - - } - if (s.playState === 1) { - // special case/hack: ensure buffering is false if loading from cache (and not yet started) - if (!s.isHTML5 && fV === 8 && !s.position && s.isBuffering) { - s._onbufferchange(0); - } - if (instanceOptions.whileplaying) { // flash may call after actual finish instanceOptions.whileplaying.apply(s); @@ -3469,118 +2715,6 @@ function SoundManager(smURL, smID) { }; - this._oncaptiondata = function(oData) { - - /** - * internal: flash 9 + NetStream (MovieStar/RTMP-only) feature - * - * @param {object} oData - */ - - sm2._wD(s.id + ': Caption data received.'); - - s.captiondata = oData; - - if (s._iO.oncaptiondata) { - s._iO.oncaptiondata.apply(s, [oData]); - } - - }; - - this._onmetadata = function(oMDProps, oMDData) { - - /** - * internal: flash 9 + NetStream (MovieStar/RTMP-only) feature - * RTMP may include song title, MovieStar content may include encoding info - * - * @param {array} oMDProps (names) - * @param {array} oMDData (values) - */ - - sm2._wD(s.id + ': Metadata received.'); - - var oData = {}, i, j; - - for (i = 0, j = oMDProps.length; i < j; i++) { - oData[oMDProps[i]] = oMDData[i]; - } - - s.metadata = oData; - - if (s._iO.onmetadata) { - s._iO.onmetadata.call(s, s.metadata); - } - - }; - - this._onid3 = function(oID3Props, oID3Data) { - - /** - * internal: flash 8 + flash 9 ID3 feature - * may include artist, song title etc. - * - * @param {array} oID3Props (names) - * @param {array} oID3Data (values) - */ - - sm2._wD(s.id + ': ID3 data received.'); - - var oData = [], i, j; - - for (i = 0, j = oID3Props.length; i < j; i++) { - oData[oID3Props[i]] = oID3Data[i]; - } - - s.id3 = mixin(s.id3, oData); - - if (s._iO.onid3) { - s._iO.onid3.apply(s); - } - - }; - - // flash/RTMP-only - - this._onconnect = function(bSuccess) { - - bSuccess = (bSuccess === 1); - sm2._wD(s.id + ': ' + (bSuccess ? 'Connected.' : 'Failed to connect? - ' + s.url), (bSuccess ? 1 : 2)); - s.connected = bSuccess; - - if (bSuccess) { - - s.failures = 0; - - if (idCheck(s.id)) { - if (s.getAutoPlay()) { - // only update the play state if auto playing - s.play(_undefined, s.getAutoPlay()); - } else if (s._iO.autoLoad) { - s.load(); - } - } - - if (s._iO.onconnect) { - s._iO.onconnect.apply(s, [bSuccess]); - } - - } - - }; - - this._ondataerror = function(sError) { - - // flash 9 wave/eq data handler - // hack: called at start, and end from flash at/after onfinish() - if (s.playState > 0) { - sm2._wD(s.id + ': Data error: ' + sError); - if (s._iO.ondataerror) { - s._iO.ondataerror.apply(s); - } - } - - }; - // this._debug(); // @@ -3592,18 +2726,6 @@ function SoundManager(smURL, smID) { * ------------------------------ */ - getDocument = function() { - - return (doc.body || doc.getElementsByTagName('div')[0]); - - }; - - id = function(sID) { - - return doc.getElementById(sID); - - }; - mixin = function(oMain, oAdd) { // non-destructive merge @@ -3636,31 +2758,12 @@ function SoundManager(smURL, smID) { }; - wrapCallback = function(oSound, callback) { - - /** - * 03/03/2013: Fix for Flash Player 11.6.602.171 + Flash 8 (flashVersion = 8) SWF issue - * setTimeout() fix for certain SMSound callbacks like onload() and onfinish(), where subsequent calls like play() and load() fail when Flash Player 11.6.602.171 is installed, and using soundManager with flashVersion = 8 (which is the default). - * Not sure of exact cause. Suspect race condition and/or invalid (NaN-style) position argument trickling down to the next JS -> Flash _start() call, in the play() case. - * Fix: setTimeout() to yield, plus safer null / NaN checking on position argument provided to Flash. - * https://getsatisfaction.com/schillmania/topics/recent_chrome_update_seems_to_have_broken_my_sm2_audio_player - */ - if (!oSound.isHTML5 && fV === 8) { - window.setTimeout(callback, 0); - } else { - callback(); - } - - }; - // additional soundManager properties that soundManager.setup() will accept extraOptions = { onready: 1, ontimeout: 1, - defaultOptions: 1, - flash9Options: 1, - movieStarOptions: 1 + defaultOptions: 1 }; assign = function(o, oParent) { @@ -3786,13 +2889,6 @@ function SoundManager(smURL, smID) { }; - function preferFlashCheck(kind) { - - // whether flash should play a given type - return (sm2.preferFlash && hasFlash && !sm2.ignoreFlash && (sm2.flash[kind] !== _undefined && sm2.flash[kind])); - - } - /** * Internal DOM2-level event helpers * --------------------------------- @@ -3897,6 +2993,7 @@ function SoundManager(smURL, smID) { abort: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': abort'); }), @@ -3908,6 +3005,8 @@ function SoundManager(smURL, smID) { var s = this._s, position1K; + if (!s) return; + if (s._html5_canplay) { // this event has already fired. ignore. return; @@ -3941,6 +3040,7 @@ function SoundManager(smURL, smID) { var s = this._s; + if (!s) return; if (!s.loaded) { s._onbufferchange(0); s._whileloading(s.bytesLoaded, s.bytesTotal, s._get_html5_duration()); @@ -3956,6 +3056,8 @@ function SoundManager(smURL, smID) { var s = this._s, duration; + if (!s) return; + duration = s._get_html5_duration(); if (!isNaN(duration) && duration !== s.duration) { @@ -3968,19 +3070,11 @@ function SoundManager(smURL, smID) { }), - // TODO: Reserved for potential use - /* - emptied: html5_event(function() { - - sm2._wD(this._s.id + ': emptied'); - - }), - */ - ended: html5_event(function() { var s = this._s; + if (!s) return; sm2._wD(s.id + ': ended'); s._onfinish(); @@ -3989,6 +3083,7 @@ function SoundManager(smURL, smID) { error: html5_event(function() { + if (!this._s) return; var description = (html5ErrorCodes[this.error.code] || null); sm2._wD(this._s.id + ': HTML5 error, code ' + this.error.code + (description ? ' (' + description + ')' : '')); this._s._onload(false); @@ -4000,6 +3095,8 @@ function SoundManager(smURL, smID) { var s = this._s; + if (!s) return; + sm2._wD(s.id + ': loadeddata'); // safari seems to nicely report progress events, eventually totalling 100% @@ -4011,12 +3108,14 @@ function SoundManager(smURL, smID) { loadedmetadata: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': loadedmetadata'); }), loadstart: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': loadstart'); // assume buffering at first this._s._onbufferchange(1); @@ -4025,7 +3124,7 @@ function SoundManager(smURL, smID) { play: html5_event(function() { - // sm2._wD(this._s.id + ': play()'); + if (!this._s) return; // once play starts, no buffering this._s._onbufferchange(0); @@ -4033,6 +3132,7 @@ function SoundManager(smURL, smID) { playing: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': playing ' + String.fromCharCode(9835)); // once play starts, no buffering this._s._onbufferchange(0); @@ -4043,6 +3143,8 @@ function SoundManager(smURL, smID) { // note: can fire repeatedly after "loaded" event, due to use of HTTP range/partials + if (!this._s) return; + var s = this._s, i, j, progStr, buffered = 0, isProgress = (e.type === 'progress'), @@ -4060,7 +3162,7 @@ function SoundManager(smURL, smID) { // https://developer.mozilla.org/en/DOM/TimeRanges // re-build "buffered" array - // HTML5 returns seconds. SM2 API uses msec for setPosition() etc., whether Flash or HTML5. + // HTML5 returns seconds. SM2 API uses msec for setPosition() etc. for (i = 0, j = ranges.length; i < j; i++) { s.buffered.push({ start: ranges.start(i) * msecScale, @@ -4106,6 +3208,7 @@ function SoundManager(smURL, smID) { ratechange: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': ratechange'); }), @@ -4115,6 +3218,8 @@ function SoundManager(smURL, smID) { // download paused/stopped, may have finished (eg. onload) var s = this._s; + if (!s) return; + sm2._wD(this._s.id + ': suspend'); html5_events.progress.call(this, e); s._onsuspend(); @@ -4123,12 +3228,14 @@ function SoundManager(smURL, smID) { stalled: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': stalled'); }), timeupdate: html5_event(function() { + if (!this._s) return; this._s._onTimer(); }), @@ -4137,6 +3244,8 @@ function SoundManager(smURL, smID) { var s = this._s; + if (!s) return; + // see also: seeking sm2._wD(this._s.id + ': waiting'); @@ -4153,20 +3262,15 @@ function SoundManager(smURL, smID) { var result; - if (!iO || (!iO.type && !iO.url && !iO.serverURL)) { + if (!iO || (!iO.type && !iO.url)) { // nothing to check result = false; - } else if (iO.serverURL || (iO.type && preferFlashCheck(iO.type))) { - - // RTMP, or preferring flash - result = false; - } else { // Use type, if specified. Pass data: URIs to HTML5. If HTML5-only mode, no other options, so just give 'er - result = ((iO.type ? html5CanPlay({ type: iO.type }) : html5CanPlay({ url: iO.url }) || sm2.html5Only || iO.url.match(/data:/i))); + result = ((iO.type ? html5CanPlay({ type: iO.type }) : html5CanPlay({ url: iO.url }) || iO.url.match(/data:/i))); } @@ -4222,7 +3326,7 @@ function SoundManager(smURL, smID) { * } */ - if (!sm2.useHTML5Audio || !sm2.hasHTML5) return false; + if (!sm2.hasHTML5) return false; var url = (o.url || null), mime = (o.type || null), @@ -4234,7 +3338,7 @@ function SoundManager(smURL, smID) { // account for known cases like audio/mp3 - if (mime && sm2.html5[mime] !== _undefined) return (sm2.html5[mime] && !preferFlashCheck(mime)); + if (mime && sm2.html5[mime] !== _undefined) return (sm2.html5[mime]); if (!html5Ext) { @@ -4287,7 +3391,7 @@ function SoundManager(smURL, smID) { if (fileExt && sm2.html5[fileExt] !== _undefined) { // result known - result = (sm2.html5[fileExt] && !preferFlashCheck(fileExt)); + result = (sm2.html5[fileExt]); } else { @@ -4297,7 +3401,7 @@ function SoundManager(smURL, smID) { sm2.html5[fileExt] = result; // sm2._wD('canPlayType, found result: ' + result); - result = (result && sm2.html5[mime] && !preferFlashCheck(mime)); + result = (result && sm2.html5[mime]); } return result; @@ -4311,16 +3415,6 @@ function SoundManager(smURL, smID) { * assigns results to html5[] and flash[]. */ - 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. :/ var a = (Audio !== _undefined ? (isOpera && opera.version() < 10 ? new Audio(null) : new Audio()) : null), item, lookup, support = {}, aF, i; @@ -4344,9 +3438,6 @@ function SoundManager(smURL, smID) { isOK = true; sm2.html5[m[i]] = true; - // note flash support, too - sm2.flash[m[i]] = !!(m[i].match(flashMIME)); - } } @@ -4379,19 +3470,6 @@ function SoundManager(smURL, smID) { // write back generic type too, eg. audio/mp3 support[lookup] = support[item]; - // assign flash - if (item.match(flashMIME)) { - - sm2.flash[item] = true; - sm2.flash[lookup] = true; - - } else { - - sm2.flash[item] = false; - sm2.flash[lookup] = false; - - } - // assign result to related formats, too if (aF[item] && aF[item].related) { @@ -4401,7 +3479,6 @@ function SoundManager(smURL, smID) { // eg. audio/m4a support['audio/' + aF[item].related[i]] = support[item]; sm2.html5[aF[item].related[i]] = support[item]; - sm2.flash[aF[item].related[i]] = support[item]; } @@ -4414,9 +3491,6 @@ function SoundManager(smURL, smID) { support.canPlayType = (a ? cp : null); sm2.html5 = mixin(sm2.html5, support); - sm2.html5.usingFlash = featureCheck(); - needsFlash = sm2.html5.usingFlash; - return true; }; @@ -4426,15 +3500,6 @@ function SoundManager(smURL, smID) { // notReady: 'Unavailable - wait until onready() has fired.', notOK: 'Audio support is not available.', - domError: sm + 'exception caught while appending SWF to DOM.', - spcWmode: 'Removing wmode, preventing known SWF loading issue(s)', - swf404: smc + 'Verify that %s is a valid path.', - tryDebug: 'Try ' + sm + '.debugFlash = true for more security details (output goes to SWF.)', - checkSWF: 'See SWF output for more debug info.', - localFail: smc + 'Non-HTTP page (' + doc.location.protocol + ' URL?) Review Flash player security settings for this special case:\nhttp://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html\nMay need to add/allow path, eg. c:/sm2/ or /users/me/sm2/', - waitFocus: smc + 'Special case: Waiting for SWF to load with window focus...', - waitForever: smc + 'Waiting indefinitely for Flash (will recover if unblocked)...', - waitSWF: smc + 'Waiting for 100% SWF load...', needFunction: smc + 'Function object expected for %s', badID: 'Sound ID "%s" should be a string, starting with a non-numeric character', currentObj: smc + '_debug(): Current sound objects', @@ -4443,29 +3508,15 @@ function SoundManager(smURL, smID) { onload: smc + 'initComplete(): calling soundManager.onload()', onloadOK: sm + '.onload() complete', didInit: smc + 'init(): Already called?', - secNote: 'Flash security note: Network/internet URLs will not load due to security restrictions. Access can be configured via Flash Player Global Security Settings Page: http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html', - badRemove: smc + 'Failed to remove Flash node.', 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...', - fbLoaded: 'Flash loaded', - fbHandler: smc + 'flashBlockHandler()', manURL: 'SMSound.load(): Using manually-assigned URL', onURL: sm + '.load(): current URL already assigned.', - badFV: sm + '.flashVersion must be 8 or 9. "%s" is invalid. Reverting to %s.', - as2loop: 'Note: Setting stream:false so looping can work (flash 8 limitation)', - noNSLoop: 'Note: Looping not implemented for MovieStar formats', - needfl9: 'Note: Switching to flash 9, required for MP4 formats.', - mfTimeout: 'Setting flashLoadTimeout = 0 (infinite) for off-screen, mobile flash case', - needFlash: smc + 'Fatal error: Flash is needed to play some required formats, but is not available.', gotFocus: smc + 'Got window focus.', - policy: 'Enabling usePolicyFile for data access', setup: sm + '.setup(): allowed parameters: %s', setupError: sm + '.setup(): "%s" cannot be assigned with this method.', setupUndef: sm + '.setup(): Could not find option "%s"', - setupLate: sm + '.setup(): url, flashVersion and html5Test property changes will not take effect until reboot().', - noURL: smc + 'Flash URL required. Call soundManager.setup({url:...}) to get started.', + setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003), reset: sm + '.reset(): Removing event callbacks', mobileUA: 'Mobile UA detected, preferring HTML5 by default.', @@ -4504,29 +3555,6 @@ function SoundManager(smURL, smID) { }; - loopFix = function(sOpt) { - - // flash 8 requires stream = false for looping to work - if (fV === 8 && sOpt.loops > 1 && sOpt.stream) { - _wDS('as2loop'); - sOpt.stream = false; - } - - return sOpt; - - }; - - policyFix = function(sOpt, sPre) { - - if (sOpt && !sOpt.usePolicyFile && (sOpt.onid3 || sOpt.usePeakData || sOpt.useWaveformData || sOpt.useEQData)) { - sm2._wD((sPre || '') + str('policy')); - sOpt.usePolicyFile = true; - } - - return sOpt; - - }; - complain = function(sMsg) { // @@ -4559,182 +3587,10 @@ function SoundManager(smURL, smID) { }; - failSafely = function(bNoDisable) { - - // general failure exception handler - - if (bNoDisable === _undefined) { - bNoDisable = false; - } - - if (disabled || bNoDisable) { - sm2.disable(bNoDisable); - } - - }; - - normalizeMovieURL = function(movieURL) { - - var urlParams = null, url; - - if (movieURL) { - - if (movieURL.match(/\.swf(\?.*)?$/i)) { - - urlParams = movieURL.substr(movieURL.toLowerCase().lastIndexOf('.swf?') + 4); - - // assume user knows what they're doing - if (urlParams) return movieURL; - - } else if (movieURL.lastIndexOf('/') !== movieURL.length - 1) { - - // append trailing slash, if needed - movieURL += '/'; - - } - - } - - url = (movieURL && movieURL.lastIndexOf('/') !== -1 ? movieURL.substr(0, movieURL.lastIndexOf('/') + 1) : './') + sm2.movieURL; - - if (sm2.noSWFCache) { - url += ('?ts=' + new Date().getTime()); - } - - return url; - - }; - setVersionInfo = function() { // short-hand for internal use - - fV = parseInt(sm2.flashVersion, 10); - - if (fV !== 8 && fV !== 9) { - sm2._wD(str('badFV', fV, defaultFlashVersion)); - sm2.flashVersion = fV = defaultFlashVersion; - } - - // debug flash movie, if applicable - - 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)')); - - // 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')]; - - // if applicable, use _debug versions of SWFs - sm2.movieURL = (fV === 8 ? 'soundmanager2.swf' : 'soundmanager2_flash9.swf').replace('.swf', isDebug); - - sm2.features.peakData = sm2.features.waveformData = sm2.features.eqData = (fV > 8); - - }; - - setPolling = function(bPolling, bHighPerformance) { - - if (!flash) { - return; - } - - flash._setPolling(bPolling, bHighPerformance); - - }; - - initDebug = function() { - - // starts debug mode, creating output
for UAs without console object - - // allow force of debug mode via URL - // - if (sm2.debugURLParam.test(wl)) { - sm2.setupOptions.debugMode = sm2.debugMode = true; - } - - if (id(sm2.debugID)) { - return; - } - - var oD, oDebug, oTarget, oToggle, tmp; - - if (sm2.debugMode && !id(sm2.debugID) && (!hasConsole || !sm2.useConsole || !sm2.consoleOnly)) { - - oD = doc.createElement('div'); - oD.id = sm2.debugID + '-toggle'; - - oToggle = { - position: 'fixed', - bottom: '0px', - right: '0px', - width: '1.2em', - height: '1.2em', - lineHeight: '1.2em', - margin: '2px', - textAlign: 'center', - border: '1px solid #999', - cursor: 'pointer', - background: '#fff', - color: '#333', - zIndex: 10001 - }; - - oD.appendChild(doc.createTextNode('-')); - oD.onclick = toggleDebug; - oD.title = 'Toggle SM2 debug console'; - - if (ua.match(/msie 6/i)) { - oD.style.position = 'absolute'; - oD.style.cursor = 'hand'; - } - - for (tmp in oToggle) { - if (oToggle.hasOwnProperty(tmp)) { - oD.style[tmp] = oToggle[tmp]; - } - } - - oDebug = doc.createElement('div'); - oDebug.id = sm2.debugID; - 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()); - } - oTarget.appendChild(oDebug); - } - - } - - oTarget = null; - // + sm2.version = sm2.versionNumber + ' (HTML5-only mode)'; }; @@ -4747,28 +3603,6 @@ function SoundManager(smURL, smID) { }; - toggleDebug = function() { - - var o = id(sm2.debugID), - oT = id(sm2.debugID + '-toggle'); - - if (!o) { - return; - } - - if (debugOpen) { - // minimize - oT.innerHTML = '+'; - o.style.display = 'none'; - } else { - oT.innerHTML = '-'; - o.style.display = 'block'; - } - - debugOpen = !debugOpen; - - }; - debugTS = function(sEventType, bSuccess, sMessage) { // troubleshooter debug hooks @@ -4787,79 +3621,6 @@ function SoundManager(smURL, smID) { }; // - getSWFCSS = function() { - - var css = []; - - if (sm2.debugMode) { - css.push(swfCSS.sm2Debug); - } - - if (sm2.debugFlash) { - css.push(swfCSS.flashDebug); - } - - if (sm2.useHighPerformance) { - css.push(swfCSS.highPerf); - } - - return css.join(' '); - - }; - - flashBlockHandler = function() { - - // *possible* flash block situation. - - var name = str('fbHandler'), - p = sm2.getMoviePercent(), - css = swfCSS, - error = { - type: 'FLASHBLOCK' - }; - - if (sm2.html5Only) { - // no flash, or unused - return; - } - - if (!sm2.ok()) { - - if (needsFlash) { - // make the movie more visible, so user can fix - 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 - }); - - catchError(error); - - } else { - - // SM2 loaded OK (or recovered) - - // - if (sm2.didFlashBlock) { - sm2._wD(name + ': Unblocked'); - } - // - - if (sm2.oMC) { - sm2.oMC.className = [getSWFCSS(), css.swfDefault, css.swfLoaded + (sm2.didFlashBlock ? ' ' + css.swfUnblocked : '')].join(' '); - } - - } - - }; - addOnEvent = function(sType, oMethod, oScope) { if (on_queue[sType] === _undefined) { @@ -4899,7 +3660,7 @@ function SoundManager(smURL, smID) { queue = [], i, j, args = [status], - canRetry = (needsFlash && !sm2.ok()); + canRetry = !sm2.ok(); if (oOptions.error) { args[0].error = oOptions.error; @@ -4923,9 +3684,7 @@ function SoundManager(smURL, smID) { } if (!canRetry) { - // useFlashBlock and SWF timeout case doesn't count here. queue[i].fired = true; - } } @@ -4940,10 +3699,6 @@ function SoundManager(smURL, smID) { window.setTimeout(function() { - if (sm2.useFlashBlock) { - flashBlockHandler(); - } - processOnEvents(); // call user-defined "onload", scoped to window @@ -4962,141 +3717,6 @@ function SoundManager(smURL, smID) { }; - 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 - */ - - // this work has already been done. - if (hasFlash !== _undefined) return hasFlash; - - var hasPlugin = false, n = navigator, obj, type, types, AX = window.ActiveXObject; - - // MS Edge 14 throws an "Unspecified Error" because n.plugins is inaccessible due to permissions - var nP; - - try { - nP = n.plugins; - } catch(e) { - nP = undefined; - } - - 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'); - } catch(e) { - // oh well - obj = null; - } - - hasPlugin = (!!obj); - - // cleanup, because it is ActiveX after all - obj = null; - - } - - hasFlash = hasPlugin; - - return hasPlugin; - - }; - - featureCheck = function() { - - var flashNeeded, - item, - formats = sm2.audioFormats, - // iPhone <= 3.1 has broken HTML5 audio(), but firmware 3.2 (original iPad) + iOS4 works. - isSpecial = (is_iDevice && !!(ua.match(/os (1|2|3_0|3_1)\s/i))); - - if (isSpecial) { - - // has Audio(), but is broken; let it load links directly. - sm2.hasHTML5 = false; - - // ignore flash case, however - sm2.html5Only = true; - - // hide the SWF, if present - if (sm2.oMC) { - sm2.oMC.style.display = 'none'; - } - - } else if (sm2.useHTML5Audio) { - - if (!sm2.html5 || !sm2.html5.canPlayType) { - sm2._wD('SoundManager: No HTML5 Audio() support detected.'); - sm2.hasHTML5 = false; - } - - // - 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); - } - // - - } - - if (sm2.useHTML5Audio && sm2.hasHTML5) { - - // sort out whether flash is optional, required or can be ignored. - - // innocent until proven guilty. - 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; - - } - - } - - } - - } - - } - - // sanity check... - if (sm2.ignoreFlash) { - flashNeeded = false; - canIgnoreFlash = true; - } - - sm2.html5Only = (sm2.hasHTML5 && sm2.useHTML5Audio && !flashNeeded); - - return (!sm2.html5Only); - - }; - parseURL = function(url) { /** @@ -5245,755 +3865,30 @@ function SoundManager(smURL, smID) { }; - badSafariFix = function() { + /** + * Private initialization helpers + * ------------------------------ + */ - // special case: "bad" Safari (OS X 10.3 - 10.7) must fall back to flash for MP3/MP4 - if (!isBadSafari || !detectFlash()) { - // doesn't apply - return; - } + initComplete = function() { - var aF = sm2.audioFormats, i, item; + if (didInit) return false; - for (item in aF) { + // all good. + _wDS('sm2Loaded', 1); + didInit = true; + initUserOnload(); + debugTS('onload', true); + return true; - if (aF.hasOwnProperty(item)) { + }; - if (item === 'mp3' || item === 'mp4') { + /** + * apply top-level setupOptions object as local properties, eg., this.setupOptions.debugMode -> this.debugMode (soundManager.debugMode) + * this maintains backward compatibility, and allows properties to be defined separately for use by soundManager.setup(). + */ - 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--) { - sm2.html5[aF[item].related[i]] = false; - } - } - - } - - } - - } - - }; - - /** - * Pseudo-private flash/ExternalInterface methods - * ---------------------------------------------- - */ - - this._setSandboxType = function(sandboxType) { - - // - // Security sandbox according to Flash plugin - var sb = sm2.sandbox; - - sb.type = sandboxType; - sb.description = sb.types[(sb.types[sandboxType] !== _undefined ? sandboxType : 'unknown')]; - - if (sb.type === 'localWithFile') { - - sb.noRemote = true; - sb.noLocal = false; - _wDS('secNote', 2); - - } else if (sb.type === 'localWithNetwork') { - - sb.noRemote = false; - sb.noLocal = true; - - } else if (sb.type === 'localTrusted') { - - sb.noRemote = false; - sb.noLocal = false; - - } - // - - }; - - this._externalInterfaceOK = function(swfVersion) { - - // flash callback confirming flash loaded, EI working etc. - // swfVersion: SWF build string - - if (sm2.swfLoaded) { - return; - } - - var e; - - debugTS('swf', true); - debugTS('flashtojs', true); - sm2.swfLoaded = true; - tryInitOnFocus = false; - - if (isBadSafari) { - badSafariFix(); - } - - // complain if JS + SWF build/version strings don't match, excluding +DEV builds - // - if (!swfVersion || swfVersion.replace(/\+dev/i, '') !== sm2.versionNumber.replace(/\+dev/i, '')) { - - e = sm + ': Fatal: JavaScript file build "' + sm2.versionNumber + '" does not match Flash SWF build "' + swfVersion + '" at ' + sm2.url + '. Ensure both are up-to-date.'; - - // escape flash -> JS stack so this error fires in window. - setTimeout(function() { - throw new Error(e); - }, 0); - - // exit, init will fail with timeout - return; - - } - // - - // IE needs a larger timeout - setTimeout(init, isIE ? 100 : 1); - - }; - - /** - * Private initialization helpers - * ------------------------------ - */ - - createMovie = function(movieID, movieURL) { - - // ignore if already connected - if (didAppend && appendSuccess) return false; - - function initMsg() { - - // - - var options = [], - title, - msg = [], - delimiter = ' + '; - - title = 'SoundManager ' + sm2.version + (!sm2.html5Only && sm2.useHTML5Audio ? (sm2.hasHTML5 ? ' + HTML5 audio' : ', no HTML5 audio support') : ''); - - if (!sm2.html5Only) { - - if (sm2.preferFlash) { - options.push('preferFlash'); - } - - if (sm2.useHighPerformance) { - options.push('useHighPerformance'); - } - - if (sm2.flashPollingInterval) { - options.push('flashPollingInterval (' + sm2.flashPollingInterval + 'ms)'); - } - - if (sm2.html5PollingInterval) { - options.push('html5PollingInterval (' + sm2.html5PollingInterval + 'ms)'); - } - - if (sm2.wmode) { - options.push('wmode (' + sm2.wmode + ')'); - } - - if (sm2.debugFlash) { - options.push('debugFlash'); - } - - if (sm2.useFlashBlock) { - options.push('flashBlock'); - } - - } else if (sm2.html5PollingInterval) { - options.push('html5PollingInterval (' + sm2.html5PollingInterval + 'ms)'); - } - - if (options.length) { - msg = msg.concat([options.join(delimiter)]); - } - - sm2._wD(title + (msg.length ? delimiter + msg.join(', ') : ''), 1); - - showSupport(); - - // - - } - - if (sm2.html5Only) { - - // 100% HTML5 mode - setVersionInfo(); - - initMsg(); - sm2.oMC = id(sm2.movieID); - init(); - - // prevent multiple init attempts - didAppend = true; - - appendSuccess = true; - - return false; - - } - - // flash path - var remoteURL = (movieURL || sm2.url), - localURL = (sm2.altURL || remoteURL), - swfTitle = 'JS/Flash audio component (SoundManager 2)', - oTarget = getDocument(), - extraClass = getSWFCSS(), - isRTL = null, - html = doc.getElementsByTagName('html')[0], - oEmbed, oMovie, tmp, movieHTML, oEl, s, x, sClass; - - isRTL = (html && html.dir && html.dir.match(/rtl/i)); - movieID = (movieID === _undefined ? sm2.id : movieID); - - function param(name, value) { - return ''; - } - - // safety check for legacy (change to Flash 9 URL) - setVersionInfo(); - sm2.url = normalizeMovieURL(overHTTP ? remoteURL : localURL); - movieURL = sm2.url; - - sm2.wmode = (!sm2.wmode && sm2.useHighPerformance ? 'transparent' : sm2.wmode); - - if (sm2.wmode !== null && (ua.match(/msie 8/i) || (!isIE && !sm2.useHighPerformance)) && navigator.platform.match(/win32|win64/i)) { - /** - * extra-special case: movie doesn't load until scrolled into view when using wmode = anything but 'window' here - * does not apply when using high performance (position:fixed means on-screen), OR infinite flash load timeout - * wmode breaks IE 8 on Vista + Win7 too in some cases, as of January 2011 (?) - */ - messages.push(strings.spcWmode); - sm2.wmode = null; - } - - oEmbed = { - name: movieID, - id: movieID, - src: movieURL, - quality: 'high', - allowScriptAccess: sm2.allowScriptAccess, - bgcolor: sm2.bgColor, - pluginspage: http + 'www.macromedia.com/go/getflashplayer', - title: swfTitle, - type: 'application/x-shockwave-flash', - wmode: sm2.wmode, - // http://help.adobe.com/en_US/as3/mobile/WS4bebcd66a74275c36cfb8137124318eebc6-7ffd.html - hasPriority: 'true' - }; - - if (sm2.debugFlash) { - oEmbed.FlashVars = 'debug=1'; - } - - if (!sm2.wmode) { - // don't write empty attribute - delete oEmbed.wmode; - } - - if (isIE) { - - // IE is "special". - oMovie = doc.createElement('div'); - movieHTML = [ - '', - param('movie', movieURL), - param('AllowScriptAccess', sm2.allowScriptAccess), - param('quality', oEmbed.quality), - (sm2.wmode ? param('wmode', sm2.wmode) : ''), - param('bgcolor', sm2.bgColor), - param('hasPriority', 'true'), - (sm2.debugFlash ? param('FlashVars', oEmbed.FlashVars) : ''), - '' - ].join(''); - - } else { - - oMovie = doc.createElement('embed'); - for (tmp in oEmbed) { - if (oEmbed.hasOwnProperty(tmp)) { - oMovie.setAttribute(tmp, oEmbed[tmp]); - } - } - - } - - initDebug(); - extraClass = getSWFCSS(); - oTarget = getDocument(); - - if (oTarget) { - - sm2.oMC = (id(sm2.movieID) || doc.createElement('div')); - - if (!sm2.oMC.id) { - - sm2.oMC.id = sm2.movieID; - sm2.oMC.className = swfCSS.swfDefault + ' ' + extraClass; - s = null; - oEl = null; - - if (!sm2.useFlashBlock) { - if (sm2.useHighPerformance) { - // on-screen at all times - s = { - position: 'fixed', - width: '8px', - height: '8px', - // >= 6px for flash to run fast, >= 8px to start up under Firefox/win32 in some cases. odd? yes. - bottom: '0px', - left: '0px', - overflow: 'hidden' - }; - } else { - // hide off-screen, lower priority - s = { - position: 'absolute', - width: '6px', - height: '6px', - top: '-9999px', - left: '-9999px' - }; - if (isRTL) { - s.left = Math.abs(parseInt(s.left, 10)) + 'px'; - } - } - } - - if (isWebkit) { - // soundcloud-reported render/crash fix, safari 5 - sm2.oMC.style.zIndex = 10000; - } - - if (!sm2.debugFlash) { - for (x in s) { - if (s.hasOwnProperty(x)) { - sm2.oMC.style[x] = s[x]; - } - } - } - - 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()); - - } - - } 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.appendChild(oMovie); - - if (isIE) { - oEl = sm2.oMC.appendChild(doc.createElement('div')); - oEl.className = swfCSS.swfBox; - oEl.innerHTML = movieHTML; - } - - appendSuccess = true; - - } - - } - - didAppend = true; - - initMsg(); - - // sm2._wD(sm + ': Trying to load ' + movieURL + (!overHTTP && sm2.altURL ? ' (alternate URL)' : ''), 1); - - return true; - - }; - - initMovie = function() { - - if (sm2.html5Only) { - createMovie(); - return false; - } - - // attempt to get, or create, movie (may already exist) - if (flash) return false; - - if (!sm2.url) { - - /** - * Something isn't right - we've reached init, but the soundManager url property has not been set. - * User has not called setup({url: ...}), or has not set soundManager.url (legacy use case) directly before init time. - * Notify and exit. If user calls setup() with a url: property, init will be restarted as in the deferred loading case. - */ - - _wDS('noURL'); - return false; - - } - - // inline markup case - 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') { - setTimeout(sm2.oninitmovie, 1); - } - - // - flushMessages(); - // - - return true; - - }; - - delayWaitForEI = function() { - - setTimeout(waitForEI, 1000); - - }; - - rebootIntoHTML5 = function() { - - // special case: try for a reboot with preferFlash: false, if 100% HTML5 mode is possible and useFlashBlock is not enabled. - - window.setTimeout(function() { - - complain(smc + 'useFlashBlock is false, 100% HTML5 mode is possible. Rebooting with preferFlash: false...'); - - sm2.setup({ - preferFlash: false - }).reboot(); - - // if for some reason you want to detect this case, use an ontimeout() callback and look for html5Only and didFlashBlock == true. - sm2.didFlashBlock = true; - - sm2.beginDelayedInit(); - - }, 1); - - }; - - waitForEI = function() { - - var p, - loadIncomplete = false; - - if (!sm2.url) { - // No SWF url to load (noURL case) - exit for now. Will be retried when url is set. - return; - } - - if (waitingForEI) { - return; - } - - waitingForEI = true; - event.remove(window, 'load', delayWaitForEI); - - if (hasFlash && tryInitOnFocus && !isFocused) { - // Safari won't load flash in background tabs, only when focused. - _wDS('waitFocus'); - return; - } - - if (!didInit) { - p = sm2.getMoviePercent(); - if (p > 0 && p < 100) { - loadIncomplete = true; - } - } - - setTimeout(function() { - - p = sm2.getMoviePercent(); - - if (loadIncomplete) { - // special case: if movie *partially* loaded, retry until it's 100% before assuming failure. - waitingForEI = false; - sm2._wD(str('waitSWF')); - window.setTimeout(delayWaitForEI, 1); - return; - } - - // - 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); - - if (!overHTTP && p) { - - _wDS('localFail', 2); - - if (!sm2.debugFlash) { - _wDS('tryDebug', 2); - } - - } - - if (p === 0) { - - // if 0 (not null), probably a 404. - sm2._wD(str('swf404', sm2.url), 1); - - } - - debugTS('flashtojs', false, ': Timed out' + (overHTTP ? ' (Check flash security or flash blockers)' : ' (No plugin/missing SWF?)')); - - } - // - - // give up / time-out, depending - - if (!didInit && okToDisable) { - - if (p === null) { - - // SWF failed to report load progress. Possibly blocked. - - if (sm2.useFlashBlock || sm2.flashLoadTimeout === 0) { - - if (sm2.useFlashBlock) { - - flashBlockHandler(); - - } - - _wDS('waitForever'); - - } else if (!sm2.useFlashBlock && canIgnoreFlash) { - - // no custom flash block handling, but SWF has timed out. Will recover if user unblocks / allows SWF load. - rebootIntoHTML5(); - - } else { - - _wDS('waitForever'); - - // fire any regular registered ontimeout() listeners. - processOnEvents({ - type: 'ontimeout', - ignoreInit: true, - error: { - type: 'INIT_FLASHBLOCK' - } - }); - - } - - } else if (sm2.flashLoadTimeout === 0) { - - // SWF loaded? Shouldn't be a blocking issue, then. - - _wDS('waitForever'); - - } else if (!sm2.useFlashBlock && canIgnoreFlash) { - - rebootIntoHTML5(); - - } else { - - failSafely(true); - - } - - } - - }, sm2.flashLoadTimeout); - - }; - - handleFocus = function() { - - function cleanup() { - event.remove(window, 'focus', handleFocus); - } - - if (isFocused || !tryInitOnFocus) { - // already focused, or not special Safari background tab case - cleanup(); - return true; - } - - okToDisable = true; - isFocused = true; - _wDS('gotFocus'); - - // allow init to restart - waitingForEI = false; - - // kick off ExternalInterface timeout, now that the SWF has started - delayWaitForEI(); - - cleanup(); - return true; - - }; - - flushMessages = function() { - - // - - // SM2 pre-init debug messages - if (messages.length) { - sm2._wD('SoundManager 2: ' + messages.join(' '), 1); - messages = []; - } - - // - - }; - - showSupport = function() { - - // - - flushMessages(); - - var item, tests = []; - - 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)' : '')))); - } - } - sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); - } - - // - - }; - - initComplete = function(bNoDisable) { - - if (didInit) return false; - - if (sm2.html5Only) { - // all good. - _wDS('sm2Loaded', 1); - didInit = true; - initUserOnload(); - debugTS('onload', true); - return true; - } - - var wasTimeout = (sm2.useFlashBlock && sm2.flashLoadTimeout && !sm2.getMoviePercent()), - result = true, - error; - - if (!wasTimeout) { - didInit = true; - } - - 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); - } - - 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 { - - // - if (sm2.waitForWindowLoad && windowLoaded) { - _wDS('docLoaded'); - } - // - - initUserOnload(); - - } - - } - - return result; - - }; - - /** - * apply top-level setupOptions object as local properties, eg., this.setupOptions.flashVersion -> this.flashVersion (soundManager.flashVersion) - * this maintains backward compatibility, and allows properties to be defined separately for use by soundManager.setup(). - */ - - setProperties = function() { + setProperties = function() { var i, o = sm2.setupOptions; @@ -6031,125 +3926,58 @@ function SoundManager(smURL, smID) { return false; } - function cleanup() { - event.remove(window, 'load', sm2.beginDelayedInit); - } - - if (sm2.html5Only) { + // - if (!didInit) { - // we don't need no steenking flash! - cleanup(); - sm2.enabled = true; - initComplete(); - } + var item, tests = []; - return true; + if (!sm2.hasHTML5) return false; + for (item in sm2.audioFormats) { + if (sm2.audioFormats.hasOwnProperty(item)) { + tests.push(item + ' = ' + sm2.html5[item] + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); + } } - // flash path - initMovie(); - - try { - - // 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) - */ - setPolling(true, (sm2.flashPollingInterval || (sm2.useHighPerformance ? 10 : 50))); + sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); - if (!sm2.debugMode) { - // stop the SWF from making debug output calls to JS - flash._disableDebug(); - } + // + if (!didInit) { + // we don't need no steenking flash! + event.remove(window, 'load', sm2.beginDelayedInit); sm2.enabled = true; - debugTS('jstoflash', true); - - if (!sm2.html5Only) { - // prevent browser from showing cached page state (or rather, restoring "suspended" page state) via back button, because flash may be dead - // http://www.webkit.org/blog/516/webkit-page-cache-ii-the-unload-event/ - event.add(window, 'unload', doNothing); - } - - } catch(e) { - - sm2._wD('js/flash exception: ' + e.toString()); - - debugTS('jstoflash', false); - - catchError({ - type: 'JS_TO_FLASH_EXCEPTION', - fatal: true - }); - - // don't disable, for reboot() - failSafely(true); - initComplete(); - - return false; - } - initComplete(); - - // disconnect events - cleanup(); - return true; }; domContentLoaded = function() { - if (didDCLoaded) return false; + if (didDCLoaded) return; didDCLoaded = true; + // allow force of debug mode via URL + // + if (sm2.debugURLParam.test(wl)) { + sm2.setupOptions.debugMode = sm2.debugMode = true; + } + // + // assign top-level soundManager properties eg. soundManager.url setProperties(); - initDebug(); - - 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) { doc.removeEventListener('DOMContentLoaded', domContentLoaded, false); } - initMovie(); - - return true; + // 100% HTML5 mode + setVersionInfo(); + init(); }; @@ -6166,9 +3994,6 @@ function SoundManager(smURL, smID) { winOnLoad = function() { - // catch edge case of initComplete() firing after window.load() - windowLoaded = true; - // catch case where DOMContentLoaded has been sent, but we're still in doc.readyState = 'interactive' domContentLoaded(); @@ -6176,12 +4001,6 @@ function SoundManager(smURL, smID) { }; - // sniff up-front - detectFlash(); - - // focus and window load, init (primarily flash-driven) - event.add(window, 'focus', handleFocus); - event.add(window, 'load', delayWaitForEI); event.add(window, 'load', winOnLoad); if (doc.addEventListener) { @@ -6194,7 +4013,7 @@ function SoundManager(smURL, smID) { } else { - // no add/attachevent support - safe to assume no JS -> Flash either + // no add/attachevent support; perhaps a browser from the stone age (IE 5, Netscape 4.7 etc.) debugTS('onload', false); catchError({ type: 'NO_DOM2_EVENTS', @@ -6205,11 +4024,7 @@ function SoundManager(smURL, smID) { } // SoundManager() -// SM2_DEFER details: http://www.schillmania.com/projects/soundmanager2/doc/getstarted/#lazy-loading - -if (window.SM2_DEFER === _undefined || !SM2_DEFER) { - soundManager = new SoundManager(); -} +soundManager = new SoundManager(); /** * SoundManager public interfaces @@ -6232,25 +4047,9 @@ if (typeof module === 'object' && module && typeof module.exports === 'object') * 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(function() { @@ -6283,12 +4082,7 @@ if (typeof module === 'object' && module && typeof module.exports === 'object') // 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. +// public API window.soundManager = soundManager; }(window)); From 9ad1202ea479b94301a5c7b00eca1bb55624830c Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 09:57:54 -0700 Subject: [PATCH 03/59] Remove / update legacy flash comments. --- script/soundmanager2-html5.js | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 2a5b2dcf..7ad9f3cb 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -1272,8 +1272,6 @@ function SoundManager() { s.readyState = 1; s.playState = 0; - // TODO: If switching from HTML5 -> flash (or vice versa), stop currently-playing audio. - if (html5OK(instanceOptions)) { oSound = s._setup_html5(instanceOptions); @@ -1510,8 +1508,7 @@ function SoundManager() { s._iO = mixin(options, s._iO); /** - * Preload in the event of play() with position under Flash, - * or from/to parameters and non-RTMP case + * Attempt to preload in the event of from/to parameters */ if (((s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0) { From 4749da20328f462312d3c5bcdadb532629c6b1e0 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 09:58:28 -0700 Subject: [PATCH 04/59] "Could not find" -> "unknown" SM2 setup options. --- script/soundmanager2-html5.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 7ad9f3cb..17a4d194 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -3512,7 +3512,7 @@ function SoundManager() { gotFocus: smc + 'Got window focus.', setup: sm + '.setup(): allowed parameters: %s', setupError: sm + '.setup(): "%s" cannot be assigned with this method.', - setupUndef: sm + '.setup(): Could not find option "%s"', + setupUndef: sm + '.setup(): Unknown option "%s"', setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003), reset: sm + '.reset(): Removing event callbacks', From dba0f83fecd8452b8b137be9631b23750e4d250e Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 09:59:07 -0700 Subject: [PATCH 05/59] =?UTF-8?q?ASCII=20=E2=9C=93=20/=20=E2=9C=97=20for?= =?UTF-8?q?=20format=20support=20tests,=20more=20concise=20vs.=20true=20/?= =?UTF-8?q?=20false.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- script/soundmanager2-html5.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 17a4d194..d96860ae 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -3931,11 +3931,11 @@ function SoundManager() { for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { - tests.push(item + ' = ' + sm2.html5[item] + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); + tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); } } - sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); + sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(' '), 1); // From b71f2207f72a82ad023c0fa0f2524ecc42e422d7 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:48:07 -0700 Subject: [PATCH 06/59] `waitForWindowLoad` option can be dropped, since no longer waiting for Flash or other things. `initUserOnload()` can be inlined and called immediately, no `setTimeout()` shenanigans. --- script/soundmanager2-html5.js | 38 ++++++++++------------------------- 1 file changed, 11 insertions(+), 27 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index d96860ae..41fb58ed 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -63,7 +63,6 @@ function SoundManager() { this.setupOptions = { debugMode: true, // enable debugging output (console.log() with HTML fallback) - waitForWindowLoad: false, // force SM2 to wait for window.onload() before trying to call soundManager.onload() html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. 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. @@ -184,7 +183,7 @@ function SoundManager() { */ var SMSound, - sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, initUserOnload, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], + sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/i), isSafari = (ua.match(/safari/i) && !ua.match(/chrome/i)), @@ -855,8 +854,6 @@ function SoundManager() { // fire "complete", despite fail initComplete(); - event.remove(window, 'load', initUserOnload); - return true; }; @@ -3692,28 +3689,6 @@ function SoundManager() { }; - initUserOnload = function() { - - window.setTimeout(function() { - - processOnEvents(); - - // call user-defined "onload", scoped to window - - if (typeof sm2.onload === 'function') { - _wDS('onload', 1); - sm2.onload.apply(window); - _wDS('onloadOK', 1); - } - - if (sm2.waitForWindowLoad) { - event.add(window, 'load', initUserOnload); - } - - }, 1); - - }; - parseURL = function(url) { /** @@ -3874,7 +3849,16 @@ function SoundManager() { // all good. _wDS('sm2Loaded', 1); didInit = true; - initUserOnload(); + + processOnEvents(); + + // call user-defined "onload", scoped to window + if (typeof sm2.onload === 'function') { + _wDS('onload', 1); + sm2.onload.apply(window); + _wDS('onloadOK', 1); + } + debugTS('onload', true); return true; From 9c7abd8b54b092c7f4dfa2c5ac006c36b1d4b541 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:48:52 -0700 Subject: [PATCH 07/59] Tidy up some comments. --- script/soundmanager2-html5.js | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 41fb58ed..2b4fd292 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -96,7 +96,7 @@ function SoundManager() { multiShot: true, // let sounds "restart" or layer on top of each other when played multiple times, rather than one-shot/one at a time multiShotEvents: false, // fire multiple sound events (currently onfinish() only) when multiShot is enabled position: null, // offset (milliseconds) to seek to within loaded sound data. - playbackRate: 1, // rate at which to play the sound (HTML5-only) + playbackRate: 1, // rate at which to play the sound stream: true, // allows playing before entire file has loaded (recommended) to: null, // position to end playback within a sound (msec), default = end type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 @@ -1658,10 +1658,10 @@ function SoundManager() { originalPosition = s.position; - // act like Flash, though + // reset position on stop s.setPosition(0); - // hack: reflect old position for onstop() (also like Flash) + // reflect old position for onstop() (also like Flash) s.position = originalPosition; // html5 has no stop() @@ -2519,8 +2519,6 @@ function SoundManager() { remove_html5_events = function() { - // Remove event listeners - var f; function remove(oEvt, oFn, bCapture) { @@ -2691,7 +2689,8 @@ function SoundManager() { var instanceOptions = s._iO; - // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. Unexpected/invalid per W3, I think. Normalize to 0. + // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. + // Unexpected/invalid per W3, I think. Normalize to 0. s.position = Math.max(0, nPosition); s._processOnPosition(); @@ -3405,8 +3404,8 @@ function SoundManager() { testHTML5 = function() { /** - * Internal: Iterates over audioFormats, determining support eg. audio/mp3, audio/mpeg and so on - * assigns results to html5[] and flash[]. + * Internal: Iterates over audioFormats, determining support eg. audio/mp3, audio/mpeg etc. + * results are assigned to `soundManager.html5` object. */ // 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. :/ From 412950162e04e1e4ed1b6e024ce2960a45c75862 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:50:33 -0700 Subject: [PATCH 08/59] SM2 can ignore HTML5 `loadedmetadata` event altogether; `durationchange` seems to fire ahead of this event as-is. --- script/soundmanager2-html5.js | 7 ------- 1 file changed, 7 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 2b4fd292..2a69df5e 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -3099,13 +3099,6 @@ function SoundManager() { }), - loadedmetadata: html5_event(function() { - - if (!this._s) return; - sm2._wD(this._s.id + ': loadedmetadata'); - - }), - loadstart: html5_event(function() { if (!this._s) return; From d19750deb40495c6c74dcef94c7b4a7b8d399c1f Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:51:48 -0700 Subject: [PATCH 09/59] `setup()` is going to complain when legacy Flash-era options are provided. Note as "unknown". Could retain the list of legacy labels, but that seems redundant. --- script/soundmanager2-html5.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 2a69df5e..31b36a52 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -2837,7 +2837,7 @@ function SoundManager() { } else if (bonusOptions[i] === _undefined) { - // invalid or disallowed parameter. complain. + // invalid, legacy (flash-era) or disallowed parameter. complain. complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); result = false; @@ -3501,7 +3501,7 @@ function SoundManager() { gotFocus: smc + 'Got window focus.', setup: sm + '.setup(): allowed parameters: %s', setupError: sm + '.setup(): "%s" cannot be assigned with this method.', - setupUndef: sm + '.setup(): Unknown option "%s"', + setupUndef: sm + '.setup(): Ignoring unknown option "%s"', setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003), reset: sm + '.reset(): Removing event callbacks', From eb96e0f75a0bd50829b504020158ca8fff98900a Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:52:29 -0700 Subject: [PATCH 10/59] Single `if`. Drop redundant `return`. --- script/soundmanager2-html5.js | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 31b36a52..fda88cf2 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -2695,17 +2695,10 @@ function SoundManager() { s._processOnPosition(); - if (s.playState === 1) { - - if (instanceOptions.whileplaying) { - // flash may call after actual finish - instanceOptions.whileplaying.apply(s); - } - + if (s.playState === 1 && instanceOptions.whileplaying) { + instanceOptions.whileplaying.apply(s); } - return true; - }; // From b3dfca7450d84306d724709cfef8f863657006dd Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:53:43 -0700 Subject: [PATCH 11/59] Flash 9/movieStar + RTMP-only `_onfailure` method. No longer used. --- script/soundmanager2-html5.js | 20 +------------------- 1 file changed, 1 insertion(+), 19 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index fda88cf2..5ec6e12d 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -2606,25 +2606,7 @@ function SoundManager() { return true; }; - - /** - * flash 9/movieStar + RTMP-only method, should fire only once at most - * at this point we just recreate failed sounds rather than trying to reconnect - */ - - this._onfailure = function(msg, level, code) { - - s.failures++; - sm2._wD(s.id + ': Failure (' + s.failures + '): ' + msg); - - if (s._iO.onfailure && s.failures === 1) { - s._iO.onfailure(msg, level, code); - } else { - sm2._wD(s.id + ': Ignoring failure'); - } - - }; - + this._onfinish = function() { // store local copy before it gets trashed... From 44a995ec46395d9cca7e2fe54c4ae5fce1cdd179 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:55:30 -0700 Subject: [PATCH 12/59] Combine legacy flash-only properties at end: `eqData`, `peakData`, `waveformData`, `id3`. --- script/soundmanager2-html5.js | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 5ec6e12d..c8bf8c7f 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -2256,7 +2256,11 @@ function SoundManager() { s.muted = false; s.paused = false; + s.playState = 0; + s.position = null; + // legacy Flash bits: eqData, peakData, waveformData, id3 + // these are not used in the HTML5-only version, but are retained for backward compatibility. s.eqData = []; s.eqData.left = []; s.eqData.right = []; @@ -2271,9 +2275,6 @@ function SoundManager() { right: [] }; - s.playState = 0; - s.position = null; - s.id3 = {}; }; From 908cc3b953846dc639aa411f4c6715b55ca43a9e Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 10:57:29 -0700 Subject: [PATCH 13/59] Internal `_onload()`: Flash 8 used to fire with 0/false-y duration when loading from cache. That is no longer a concern. ;) --- script/soundmanager2-html5.js | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index c8bf8c7f..5c2558a8 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -2542,11 +2542,10 @@ function SoundManager() { * ------------------------------ */ - this._onload = function(nSuccess) { + this._onload = function(ok) { var fN, - // check for duration to prevent false positives from flash 8 when loading from cache. - loadOK = !!nSuccess; + loadOK = !!ok; // fN = s.id + ': '; From 3560ed4117a6798bb3e88c09e61bcab55be17320 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 11:27:43 -0700 Subject: [PATCH 14/59] Complain, disable and exit if no HTML5 support. Silent param option for `soundManager.disable()` to prevent additional log. --- script/soundmanager2-html5.js | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 5c2558a8..c366b174 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -833,7 +833,7 @@ function SoundManager() { * Undocumented: NOPs soundManager and all SMSound objects. */ - this.disable = function() { + this.disable = function(silent) { // destroy all functions var i; @@ -843,7 +843,7 @@ function SoundManager() { disabled = true; - _wDS('shutdown', 1); + if (!silent) _wDS('shutdown', 1); for (i = sm2.soundIDs.length - 1; i >= 0; i--) { disableObject(sm2.sounds[sm2.soundIDs[i]]); @@ -1147,7 +1147,7 @@ function SoundManager() { this.destruct = function() { sm2._wD(sm + '.destruct()'); - sm2.disable(true); + sm2.disable(); }; @@ -3878,7 +3878,11 @@ function SoundManager() { var item, tests = []; - if (!sm2.hasHTML5) return false; + if (!sm2.hasHTML5) { + complain('SoundManager 2: No HTML5 audio support detected. :( Disabling API.'); + sm2.disable(true); + return false; + } for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { From fc0a2e2b820af1f783e18013dae9ae46861f243b Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 11:40:10 -0700 Subject: [PATCH 15/59] More comment tweaks. --- script/soundmanager2-html5.js | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index c366b174..803ecaa3 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -144,6 +144,8 @@ function SoundManager() { }; + // a quick way to enable SM2's debug mode, more logging. + this.debugURLParam = /([#?&])debug=1/i; // dynamic attributes @@ -175,7 +177,7 @@ function SoundManager() { */ this.html5 = { - usingFlash: false // legacy: set if/when flash fallback is needed + usingFlash: false // legacy: indicated if/when flash fallback was active, e.g., for MP3 support. }; /** @@ -234,7 +236,7 @@ function SoundManager() { * Configures top-level soundManager properties. * * @param {object} options Option parameters, eg. soundManager.setup({debugMode: true, ignoreMobileRestrictions: true}); - * onready and ontimeout are also accepted parameters. call soundManager.setup() to see the full list. + * `onready` and `ontimeout` are also accepted parameters. call soundManager.setup() to see the full list. */ this.setup = function(options) { @@ -679,6 +681,8 @@ function SoundManager() { /** * Calls the setPan() method of a SMSound object by ID. + * Note: This was originally a flash-only method. Native HTML5 Audio() does not implement panning. + * Web Audio API supports panning, but is not implemented in SM2 (that's another whole can of worms.) * * @param {string} sID The ID of the sound * @param {number} nPan The pan value (-100 to 100) @@ -704,10 +708,10 @@ function SoundManager() { this.setVolume = function(sID, nVol) { - // setVolume(50) function overloading case - apply to all sounds - var i, j; + // setVolume(50) function overloading case - apply to all sounds + if (sID !== _undefined && !isNaN(sID) && nVol === _undefined) { for (i = 0, j = sm2.soundIDs.length; i < j; i++) { sm2.sounds[sm2.soundIDs[i]].setVolume(sID); From 825dfb5ecd1cf594c50688500cd7f64d476176f2 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 11:41:12 -0700 Subject: [PATCH 16/59] `soundManager.mute()`: Drop invalid check. Should have been `typeof sID !== 'string'` - better: compare vs `undefined` and then mute all sounds. --- script/soundmanager2-html5.js | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 803ecaa3..383096ff 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -737,11 +737,7 @@ function SoundManager() { var i = 0; - if (sID instanceof String) { - sID = null; - } - - if (!sID) { + if (sID === _undefined) { sm2._wD(sm + '.mute(): Muting all sounds'); for (i = sm2.soundIDs.length - 1; i >= 0; i--) { From f54d89b40d51561d9259929d84000e83ae3e13eb Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sat, 7 Jul 2018 11:59:39 -0700 Subject: [PATCH 17/59] Fix up formatting for unsupported case. --- script/soundmanager2-html5.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 383096ff..8edd8b19 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -3886,7 +3886,7 @@ function SoundManager() { for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { - tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); + tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? (sm2.audioFormats[item].required ? ' (required) ' : '') : ''))); } } From d59451e0d641d0a0ddbe3f8a4fdfd8423280d0bf Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:35:25 -0700 Subject: [PATCH 18/59] Note about MIME type and `Audio().canPlayType()`. --- script/soundmanager2-html5.js | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 8edd8b19..28afbad7 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -66,7 +66,7 @@ function SoundManager() { html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. 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. + html5Test: /^(probably|maybe)$/i, // HTML5 Audio().canPlayType() format support test. Use /^probably$/i; if you want to be more conservative. idPrefix: 'sound' // if an id is not provided to createSound(), this prefix is used for generated IDs - 'sound0', 'sound1' etc. }; @@ -107,8 +107,10 @@ function SoundManager() { this.audioFormats = { /** - * determines HTML5 support. - * if no support for a "required" format, SM2 will fail to start. + * known popular file types, and associated MIME type strings for HTML5 support. + * the MIME is a form of file type and optional codec descriptor. + * variants are provided in the hope of a "probably" from `Audio().canPlayType()`. + * this is the API which checks the OS for codec support. "probably" is the best-case scenario. :D */ mp3: { From faf416ec4a67a598d1f211efc99327341ec9d1f5 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:36:22 -0700 Subject: [PATCH 19/59] Drop legacy definitions from `features`: `buffering`, `peakData`, `waveformData`, `eqData` and `movieStar`. Any legacy code will get undefined, false-y values. --- script/soundmanager2-html5.js | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 28afbad7..adfd7765 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -162,14 +162,9 @@ function SoundManager() { this.filePattern = new RegExp(''); // legacy // support indicators, set at init (mostly legacy flash backcompat stuff) - - this.features = { - buffering: false, - peakData: false, - waveformData: false, - eqData: false, - movieStar: false - }; + // previously: `buffering`, `peakData`, `waveformData`, `eqData`, `movieStar` + // any checks from legacy code will now return undefined, false-y. + this.features = {}; /** * format support From 177a548a451ee7b8f94d9934c682d53bd5c53c1d Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:36:47 -0700 Subject: [PATCH 20/59] Drop `usingFlash` from `html5`. No longer used, safe to return undefined / false-y. --- script/soundmanager2-html5.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index adfd7765..b73cdb99 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -174,7 +174,8 @@ function SoundManager() { */ this.html5 = { - usingFlash: false // legacy: indicated if/when flash fallback was active, e.g., for MP3 support. + // legacy: indicated if/when flash fallback was active, e.g., for MP3 support. + // usingFlash: false }; /** From b987b42ea7314277989909354fc7f79b49c21a72 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:38:16 -0700 Subject: [PATCH 21/59] Drop special -nodebug markers around the reboot bit. Call `beginDelayedInit()` to restart now. --- script/soundmanager2-html5.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index b73cdb99..ec3dd21e 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -1104,11 +1104,10 @@ function SoundManager() { on_queue = []; } - // if (!excludeInit) { sm2._wD(sm + ': Rebooting...'); + sm2.beginDelayedInit(); } - // return sm2; From 08a5d5558353dbb2cea90e1bfeb24de4cd408a21 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:42:07 -0700 Subject: [PATCH 22/59] Simplify init to one modern `onDOMContentLoaded` listener. Nicer HTML5 support output. --- script/soundmanager2-html5.js | 115 ++++++++++++---------------------- 1 file changed, 39 insertions(+), 76 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index ec3dd21e..bed96b54 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -183,8 +183,8 @@ function SoundManager() { */ var SMSound, - sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], - html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, + sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, setVersionInfo, strings, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], + html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/i), isSafari = (ua.match(/safari/i) && !ua.match(/chrome/i)), isOpera = (ua.match(/opera/i)), @@ -1082,7 +1082,7 @@ function SoundManager() { sm2.sounds[sm2.soundIDs[i]].destruct(); } - sm2.enabled = didDCLoaded = didInit = disabled = useGlobalHTML5Audio = false; + sm2.enabled = didInit = disabled = useGlobalHTML5Audio = false; sm2.soundIDs = []; sm2.sounds = {}; @@ -1133,7 +1133,7 @@ function SoundManager() { this.beginDelayedInit = function() { - domContentLoaded(); + init(); }; @@ -3480,6 +3480,8 @@ function SoundManager() { mobileUA: 'Mobile UA detected, preferring HTML5 by default.', globalHTML5: 'Using singleton HTML5 Audio() pattern for this device.', ignoreMobile: 'Ignoring mobile restrictions for this device.' + support: '🔊SoundManager 2 HTML5 support:', + noSupport: 'SoundManager 2: No HTML5 audio support detected. :( Disabling API.' // }; @@ -3861,39 +3863,61 @@ function SoundManager() { }; - init = function() { // called after onload() + // do this work only once. if (didInit) { _wDS('didInit'); return false; } + // allow force of debug mode via URL // + if (sm2.debugURLParam.test(wl)) { + sm2.setupOptions.debugMode = sm2.debugMode = true; + } + // + + // assign top-level soundManager properties eg. soundManager.url + setProperties(); + + testHTML5(); - var item, tests = []; + // 100% HTML5 mode + setVersionInfo(); if (!sm2.hasHTML5) { - complain('SoundManager 2: No HTML5 audio support detected. :( Disabling API.'); + complain(strings.noSupport); sm2.disable(true); return false; } + // + + var item, formats = [], tests = [], allOK = true; + for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { - tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? (sm2.audioFormats[item].required ? ' (required) ' : '') : ''))); + if (!sm2.html5[item]) { + allOK = false; + } + formats.push(item); + tests.push(item + (sm2.html5[item] ? ' ✅' : ' ⛔️')); } } - sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(' '), 1); + if (allOK) { + sm2._wD(strings.support + ' ' + formats.join(', ') + ' 💯👌', 1); + } else { + complain(strings.support + ' ' + tests.join(' · ') + ' - likely browser/OS limitation. 😒', 1); + } // if (!didInit) { // we don't need no steenking flash! - event.remove(window, 'load', sm2.beginDelayedInit); sm2.enabled = true; initComplete(); } @@ -3902,75 +3926,14 @@ function SoundManager() { }; - domContentLoaded = function() { - - if (didDCLoaded) return; - - didDCLoaded = true; - - // allow force of debug mode via URL - // - if (sm2.debugURLParam.test(wl)) { - sm2.setupOptions.debugMode = sm2.debugMode = true; - } - // - - // assign top-level soundManager properties eg. soundManager.url - setProperties(); - - testHTML5(); - - if (doc.removeEventListener) { - doc.removeEventListener('DOMContentLoaded', domContentLoaded, false); - } - - // 100% HTML5 mode - setVersionInfo(); + function domContentLoaded() { + event.remove(document, 'DOMContentLoaded', init); init(); - - }; - - domContentLoadedIE = function() { - - if (doc.readyState === 'complete') { - domContentLoaded(); - doc.detachEvent('onreadystatechange', domContentLoadedIE); - } - - return true; - - }; - - winOnLoad = function() { - - // catch case where DOMContentLoaded has been sent, but we're still in doc.readyState = 'interactive' - domContentLoaded(); - - event.remove(window, 'load', winOnLoad); - - }; - - event.add(window, 'load', winOnLoad); - - if (doc.addEventListener) { - - doc.addEventListener('DOMContentLoaded', domContentLoaded, false); - - } else if (doc.attachEvent) { - - doc.attachEvent('onreadystatechange', domContentLoadedIE); - - } else { - - // no add/attachevent support; perhaps a browser from the stone age (IE 5, Netscape 4.7 etc.) - debugTS('onload', false); - catchError({ - type: 'NO_DOM2_EVENTS', - fatal: true - }); - } + // wait for DOMContentLoaded to start. + event.add(document, 'DOMContentLoaded', domContentLoaded); + } // SoundManager() soundManager = new SoundManager(); From bf47143e7b6949a9dfc4cbef9656329dc019cbc7 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:43:27 -0700 Subject: [PATCH 23/59] Drop `required` on HTML5 formats. SM2 no longer needs to "require" Flash (historically, for MP3 support.) --- script/soundmanager2-html5.js | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index bed96b54..273aaac8 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -114,34 +114,28 @@ function SoundManager() { */ mp3: { - type: ['audio/mpeg; codecs="mp3"', 'audio/mpeg', 'audio/mp3', 'audio/MPA', 'audio/mpa-robust'], - required: true + type: ['audio/mpeg; codecs="mp3"', 'audio/mpeg', 'audio/mp3', 'audio/MPA', 'audio/mpa-robust'] }, mp4: { related: ['aac', 'm4a', 'm4b'], // additional formats under the MP4 container - type: ['audio/mp4; codecs="mp4a.40.2"', 'audio/aac', 'audio/x-m4a', 'audio/MP4A-LATM', 'audio/mpeg4-generic'], - required: false + type: ['audio/mp4; codecs="mp4a.40.2"', 'audio/aac', 'audio/x-m4a', 'audio/MP4A-LATM', 'audio/mpeg4-generic'] }, ogg: { - type: ['audio/ogg; codecs=vorbis'], - required: false + type: ['audio/ogg; codecs=vorbis'] }, opus: { - type: ['audio/ogg; codecs=opus', 'audio/opus'], - required: false + type: ['audio/ogg; codecs=opus', 'audio/opus'] }, wav: { - type: ['audio/wav; codecs="1"', 'audio/wav', 'audio/wave', 'audio/x-wav'], - required: false + type: ['audio/wav; codecs="1"', 'audio/wav', 'audio/wave', 'audio/x-wav'] }, flac: { - type: ['audio/flac'], - required: false + type: ['audio/flac'] } }; From 3f42b28baedb95d2cdd4ccb01a20b23162c6b5f0 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:44:11 -0700 Subject: [PATCH 24/59] Sounds are now always HTML5, no need to check. --- script/soundmanager2-html5.js | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 273aaac8..dbe79706 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -1177,9 +1177,6 @@ function SoundManager() { // assign property defaults this.volume = this.options.volume; - // whether or not this object is using HTML5 - this.isHTML5 = false; - // internal HTML5 Audio() object reference this._a = null; @@ -1508,7 +1505,7 @@ function SoundManager() { }; // HTML5 needs to at least have "canplay" fired before seeking. - if (s.isHTML5 && !s._html5_canplay) { + if (!s._html5_canplay) { // this hasn't been loaded yet. load it first, and then do this again. sm2._wD(fN + 'Beginning load for non-zero offset case'); @@ -2457,8 +2454,6 @@ function SoundManager() { } - s.isHTML5 = true; - // store a ref on the track s._a = a; @@ -3773,7 +3768,7 @@ function SoundManager() { for (i = sm2.soundIDs.length - 1; i >= 0; i--) { - if (sm2.sounds[sm2.soundIDs[i]].isHTML5 && sm2.sounds[sm2.soundIDs[i]]._hasTimer) { + if (sm2.sounds[sm2.soundIDs[i]]._hasTimer) { sm2.sounds[sm2.soundIDs[i]]._onTimer(); } From c40dbfe15eeca77db4ee1355cfb2572786aa7890 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:46:07 -0700 Subject: [PATCH 25/59] Comment / spacing clean-up. Report undefined / disallowed `setup()` params in one line per call. --- script/soundmanager2-html5.js | 77 +++++++++++++++++++---------------- 1 file changed, 41 insertions(+), 36 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index dbe79706..7ba1a8a2 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -1194,7 +1194,7 @@ function SoundManager() { this._debug = function() { // - sm2._wD(s.id + ': Merged options:', s.options); + sm2._wD(s.id + ' options:', s.options); // }; @@ -2569,7 +2569,7 @@ function SoundManager() { s.isBuffering = (nIsBuffering === 1); if (s._iO.onbufferchange) { - sm2._wD(s.id + ': Buffer state change: ' + nIsBuffering); + sm2._wD(s.id + ': isBuffering = ' + !!nIsBuffering); s._iO.onbufferchange.apply(s, [nIsBuffering]); } @@ -2592,7 +2592,7 @@ function SoundManager() { return true; }; - + this._onfinish = function() { // store local copy before it gets trashed... @@ -2773,6 +2773,13 @@ function SoundManager() { // + var issues = { + setupUndef: [], + setupError: [] + }; + + var txt; + for (i in o) { if (o.hasOwnProperty(i)) { @@ -2798,8 +2805,8 @@ function SoundManager() { } else if (bonusOptions[i] === _undefined) { - // invalid, legacy (flash-era) or disallowed parameter. complain. - complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); + // invalid, legacy (flash-era) or disallowed parameter. note for later. + issues[(sm2[i] === _undefined ? 'setupUndef' : 'setupError')].push(i); result = false; @@ -2824,7 +2831,7 @@ function SoundManager() { // recursion case, eg., { defaultOptions: { ... } } // invalid or disallowed parameter. complain. - complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); + issues[(sm2[i] === _undefined ? 'setupUndef' : 'setupError')].push(i); result = false; @@ -2839,6 +2846,28 @@ function SoundManager() { } + // + + function maybePlural(string, arr) { + if (string === _undefined || arr.length < 2) return string; + var base = 'unknown option'; + return string.replace(base, base + 's'); + } + + if (issues.setupUndef.length) { + txt = str('setupUndef', issues.setupUndef.join(', ')); + txt = maybePlural(txt, issues.setupUndef); + complain(txt, 2); + } + + if (issues.setupError.length) { + txt = str('setupError', issues.setupError.join(', ')); + txt = maybePlural(txt, issues.setupError); + complain(txt, 2); + } + + // + return result; }; @@ -3029,7 +3058,7 @@ function SoundManager() { var s = this._s; if (!s) return; - sm2._wD(s.id + ': ended'); + sm2._wD(s.id + ': ended □'); s._onfinish(); @@ -3080,7 +3109,7 @@ function SoundManager() { playing: html5_event(function() { if (!this._s) return; - sm2._wD(this._s.id + ': playing ' + String.fromCharCode(9835)); + sm2._wD(this._s.id + ': playing ♫'); // once play starts, no buffering this._s._onbufferchange(0); @@ -3450,8 +3479,6 @@ function SoundManager() { needFunction: smc + 'Function object expected for %s', badID: 'Sound ID "%s" should be a string, starting with a non-numeric character', currentObj: smc + '_debug(): Current sound objects', - waitOnload: smc + 'Waiting for window.onload()', - docLoaded: smc + 'Document already loaded', onload: smc + 'initComplete(): calling soundManager.onload()', onloadOK: sm + '.onload() complete', didInit: smc + 'init(): Already called?', @@ -3459,16 +3486,12 @@ function SoundManager() { queue: smc + 'Queueing %s handler', manURL: 'SMSound.load(): Using manually-assigned URL', onURL: sm + '.load(): current URL already assigned.', - gotFocus: smc + 'Got window focus.', setup: sm + '.setup(): allowed parameters: %s', - setupError: sm + '.setup(): "%s" cannot be assigned with this method.', + setupError: sm + '.setup(): Option "%s" cannot be assigned with this method.', setupUndef: sm + '.setup(): Ignoring unknown option "%s"', - setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', - 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.', - ignoreMobile: 'Ignoring mobile restrictions for this device.' + ignoreMobile: 'Ignoring mobile restrictions for this device.', support: '🔊SoundManager 2 HTML5 support:', noSupport: 'SoundManager 2: No HTML5 audio support detected. :( Disabling API.' // @@ -3491,7 +3514,7 @@ function SoundManager() { // first argument o = args.shift(); - sstr = (strings && strings[o] ? strings[o] : ''); + sstr = ((strings && strings[o]) || ''); if (sstr && args && args.length) { for (i = 0, j = args.length; i < j; i++) { @@ -3694,7 +3717,6 @@ function SoundManager() { }; - startTimer = function(oSound) { /** @@ -3776,22 +3798,6 @@ function SoundManager() { }; - catchError = function(options) { - - options = (options !== _undefined ? options : {}); - - if (typeof sm2.onerror === 'function') { - sm2.onerror.apply(window, [{ - type: (options.type !== _undefined ? options.type : null) - }]); - } - - if (options.fatal !== _undefined && options.fatal) { - sm2.disable(); - } - - }; - /** * Private initialization helpers * ------------------------------ @@ -3802,12 +3808,11 @@ function SoundManager() { if (didInit) return false; // all good. - _wDS('sm2Loaded', 1); didInit = true; processOnEvents(); - // call user-defined "onload", scoped to window + // legacy, direct-assignment method: call user-defined "onload", scoped to window if (typeof sm2.onload === 'function') { _wDS('onload', 1); sm2.onload.apply(window); From 061e39294dec9ae2e785f8ff0be3951b8e8b1170 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:46:51 -0700 Subject: [PATCH 26/59] `_get_html5_duration()`: If no `Audio().duration`, use existing SM2 object `duration` if specified. --- script/soundmanager2-html5.js | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 7ba1a8a2..3426db87 100644 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -2328,9 +2328,8 @@ function SoundManager() { this._get_html5_duration = function() { - 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)), + // if audio object exists, use its duration - else, use current duration on object if known. + var d = (s._a && s._a.duration ? s._a.duration * msecScale : s.duration || null), result = (d && !isNaN(d) && d !== Infinity ? d : null); return result; From 1643e892a3e200d0686b672f5a703dfc4b7293bc Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:47:45 -0700 Subject: [PATCH 27/59] Allow `loadeddata` to trigger duration check for all, stop excluding Safari. --- script/soundmanager2-html5.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) mode change 100644 => 100755 script/soundmanager2-html5.js diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js old mode 100644 new mode 100755 index 3426db87..9d12dc07 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -3081,8 +3081,7 @@ function SoundManager() { sm2._wD(s.id + ': loadeddata'); - // safari seems to nicely report progress events, eventually totalling 100% - if (!s._loaded && !isSafari) { + if (!s._loaded) { s.duration = s._get_html5_duration(); } From 2ec654332c5e4cb211fed37fa12947587e333915 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Sun, 8 Jul 2018 20:54:31 -0700 Subject: [PATCH 28/59] `window.Audio`. IE 8 was complaining about `Audio()` being undefined. --- script/soundmanager2-html5.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2-html5.js b/script/soundmanager2-html5.js index 9d12dc07..499993bf 100755 --- a/script/soundmanager2-html5.js +++ b/script/soundmanager2-html5.js @@ -213,7 +213,7 @@ function SoundManager() { this.hasHTML5 = (function() { try { // new Audio(null) for stupid Opera 9.64 case, which throws not_enough_arguments exception otherwise. - return (Audio !== _undefined && (isOpera && opera !== _undefined && opera.version() < 10 ? new Audio(null) : new Audio()).canPlayType !== _undefined); + return (window.Audio !== _undefined && (isOpera && opera !== _undefined && opera.version() < 10 ? new Audio(null) : new Audio()).canPlayType !== _undefined); } catch(e) { return false; } @@ -3390,7 +3390,7 @@ function SoundManager() { */ // 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. :/ - var a = (Audio !== _undefined ? (isOpera && opera.version() < 10 ? new Audio(null) : new Audio()) : null), + var a = (window.Audio !== _undefined ? (isOpera && opera.version() < 10 ? new Audio(null) : new Audio()) : null), item, lookup, support = {}, aF, i; function cp(m) { From 78465f4492d56742930a12654207aada85fb2c52 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:23 -0800 Subject: [PATCH 29/59] First whack at HTML5-only SoundManager 2 core, removing all the Flash-specific bits; 64 KB shaved off, down to 100 KB (incl. debug bits, comments, formatting.) --- script/soundmanager2.js | 2842 +++++---------------------------------- 1 file changed, 318 insertions(+), 2524 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index d38b38d5..2a5b2dcf 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -1,14 +1,14 @@ /** @license * - * SoundManager 2: JavaScript Sound for the Web - * ---------------------------------------------- + * SoundManager 2: JavaScript Sound for the Web (HTML5-only version) + * ----------------------------------------------------------------- * http://schillmania.com/projects/soundmanager2/ * * Copyright (c) 2007, Scott Schiller. All rights reserved. * Code provided under the BSD License: * http://schillmania.com/projects/soundmanager2/license.txt * - * V2.97a.20170601 + * V2.97a.20170601-HTML5+DEV */ /** @@ -17,7 +17,7 @@ * This is the fully-commented source version of the SoundManager 2 API, * recommended for use during development and testing. * - * See soundmanager2-nodebug-jsmin.js for an optimized build (~11KB with gzip.) + * See soundmanager2-html5-nodebug-jsmin.js for an optimized build (~11KB with gzip.) * http://schillmania.com/projects/soundmanager2/doc/getstarted/#basic-inclusion * Alternately, serve this file with gzip for 75% compression savings (~30KB over HTTP.) * @@ -29,7 +29,7 @@ (function SM2(window, _undefined) { -/* global Audio, document, window, navigator, define, module, SM2_DEFER, opera, setTimeout, setInterval, clearTimeout, sm2Debugger */ +/* global Audio, document, window, navigator, define, module, opera, setTimeout, setInterval, clearTimeout, sm2Debugger */ 'use strict'; @@ -48,43 +48,26 @@ var soundManager = null; * The SoundManager constructor. * * @constructor - * @param {string} smURL Optional: Path to SWF files - * @param {string} smID Optional: The ID to use for the SWF container element * @this {SoundManager} * @return {SoundManager} The new SoundManager instance */ -function SoundManager(smURL, smID) { +function SoundManager() { /** * soundManager configuration options list - * defines top-level configuration properties to be applied to the soundManager instance (eg. soundManager.flashVersion) - * to set these properties, use the setup() method - eg., soundManager.setup({url: '/swf/', flashVersion: 9}) + * defines top-level configuration properties to be applied to the soundManager instance (eg. soundManager.debugMode) + * to set these properties, use the setup() method - eg., soundManager.setup({debugMode: true, ignoreMobileRestrictions: true}); */ this.setupOptions = { - url: (smURL || null), // path (directory) where SoundManager 2 SWFs exist, eg., /path/to/swfs/ - flashVersion: 8, // flash build to use (8 or 9.) Some API features require 9. debugMode: true, // enable debugging output (console.log() with HTML fallback) - debugFlash: false, // enable debugging output inside SWF, troubleshoot Flash/browser issues - useConsole: true, // use console.log() if available (otherwise, writes to #soundmanager-debug element) - consoleOnly: true, // if console is being used, do not create/write to #soundmanager-debug waitForWindowLoad: false, // force SM2 to wait for window.onload() before trying to call soundManager.onload() - bgColor: '#ffffff', // SWF background color. N/A when wmode = 'transparent' - useHighPerformance: false, // position:fixed flash movie can help increase js/flash speed, minimize lag - flashPollingInterval: null, // msec affecting whileplaying/loading callback frequency. If null, default of 50 msec is used. html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. - flashLoadTimeout: 1000, // msec to wait for flash movie to load before failing (0 = infinity) - 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 (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. idPrefix: 'sound' // if an id is not provided to createSound(), this prefix is used for generated IDs - 'sound0', 'sound1' etc. }; @@ -114,53 +97,19 @@ function SoundManager(smURL, smID) { multiShot: true, // let sounds "restart" or layer on top of each other when played multiple times, rather than one-shot/one at a time multiShotEvents: false, // fire multiple sound events (currently onfinish() only) when multiShot is enabled position: null, // offset (milliseconds) to seek to within loaded sound data. - pan: 0, // "pan" settings, left-to-right, -100 to 100 playbackRate: 1, // rate at which to play the sound (HTML5-only) stream: true, // allows playing before entire file has loaded (recommended) to: null, // position to end playback within a sound (msec), default = end type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 - usePolicyFile: false, // enable crossdomain.xml request for audio on remote domains (for ID3/waveform access) volume: 100 // self-explanatory. 0-100, the latter being the max. }; - this.flash9Options = { - - /** - * flash 9-only options, - * merged into defaultOptions if flash 9 is being used - */ - - onfailure: null, // callback function for when playing fails (Flash 9, MovieStar + RTMP-only) - isMovieStar: null, // "MovieStar" MPEG4 audio mode. Null (default) = auto detect MP4, AAC etc. based on URL. true = force on, ignore URL - usePeakData: false, // enable left/right channel peak (level) data - useWaveformData: false, // enable sound spectrum (raw waveform data) - NOTE: May increase CPU load. - useEQData: false, // enable sound EQ (frequency spectrum data) - NOTE: May increase CPU load. - onbufferchange: null, // callback for "isBuffering" property change - ondataerror: null // callback for waveform/eq data access error (flash playing audio in other tabs/domains) - - }; - - this.movieStarOptions = { - - /** - * flash 9.0r115+ MPEG4 audio options, - * merged into defaultOptions if flash 9+movieStar mode is enabled - */ - - bufferTime: 3, // seconds of data to buffer before playback begins (null = flash default of 0.1 seconds - if AAC playback is gappy, try increasing.) - serverURL: null, // rtmp: FMS or FMIS server to connect to, required when requesting media via RTMP or one of its variants - onconnect: null, // rtmp: callback for connection to flash media server - duration: null // rtmp: song duration (msec) - - }; - this.audioFormats = { /** - * determines HTML5 support + flash requirements. - * if no support (via flash and/or HTML5) for a "required" format, SM2 will fail to start. - * flash fallback is used for MP3 or MP4 if HTML5 can't play it (or if preferFlash = true) + * determines HTML5 support. + * if no support for a "required" format, SM2 will fail to start. */ mp3: { @@ -196,35 +145,20 @@ function SoundManager(smURL, smID) { }; - // HTML attributes (id + class names) for the SWF container - - this.movieID = 'sm2-container'; - this.id = (smID || 'sm2movie'); - - this.debugID = 'soundmanager-debug'; this.debugURLParam = /([#?&])debug=1/i; // dynamic attributes - this.versionNumber = 'V2.97a.20170601'; + this.versionNumber = 'V2.97a.20170601-HTML5+DEV'; this.version = null; - this.movieURL = null; - this.altURL = null; - this.swfLoaded = false; this.enabled = false; - this.oMC = null; this.sounds = {}; this.soundIDs = []; this.muted = false; - this.didFlashBlock = false; - this.filePattern = null; + this.didFlashBlock = false; // legacy + this.filePattern = new RegExp(''); // legacy - this.filePatterns = { - flash8: /\.mp3(\?.*)?$/i, - flash9: /\.mp3(\?.*)?$/i - }; - - // support indicators, set at init + // support indicators, set at init (mostly legacy flash backcompat stuff) this.features = { buffering: false, @@ -234,88 +168,33 @@ function SoundManager(smURL, smID) { movieStar: false }; - // flash sandbox info, used primarily in troubleshooting - - this.sandbox = { - // - type: null, - types: { - remote: 'remote (domain-based) rules', - localWithFile: 'local with file access (no internet access)', - localWithNetwork: 'local with network (internet access only, no local access)', - localTrusted: 'local, trusted (local+internet access)' - }, - description: null, - noRemote: null, - noLocal: null - // - }; - /** - * format support (html5/flash) + * format support * stores canPlayType() results based on audioFormats. * eg. { mp3: boolean, mp4: boolean } * treat as read-only. */ this.html5 = { - usingFlash: null // set if/when flash fallback is needed + usingFlash: false // legacy: set if/when flash fallback is needed }; - // file type support hash - this.flash = {}; - - // determined at init time - this.html5Only = false; - - // used for special cases (eg. iPad/iPhone/palm OS?) - this.ignoreFlash = false; - /** * a few private internals (OK, a lot. :D) */ 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, 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, html5ErrorCodes, 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|trident/i), - isWebkit = ua.match(/webkit/i), + sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, initUserOnload, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], + html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, + is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/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\sX\s10_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, - 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), - http = (!overHTTP ? '//' : ''), - // mp3, mp4, aac etc. - netStreamMimeTypes = /^\s*audio\/(?:x-)?(?:mpeg4|aac|flv|mov|mp4|m4v|m4a|m4b|mp4v|3gp|3g2)\s*(?:$|;)/i, - // Flash v9.0r115+ "moviestar" formats - netStreamTypes = ['mpeg4', 'aac', 'flv', 'mov', 'mp4', 'm4v', 'f4v', 'm4a', 'm4b', 'mp4v', '3gp', '3g2'], - netStreamPattern = new RegExp('\\.(' + netStreamTypes.join('|') + ')(\\?.*)?$', 'i'); - + emptyURL = 'about:blank', // safe URL to unload, or load nothing from (most HTML5 UAs) + emptyWAV = 'data:audio/wave;base64,/UklGRiYAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQIAAAD//w=='; // tiny WAV for HTML5 unloading this.mimePattern = /^\s*audio\/(?:x-)?(?:mp(?:eg|3))\s*(?:$|;)/i; // default mp3 set - // use altURL if not "online" - this.useAltURL = !overHTTP; - - swfCSS = { - swfBox: 'sm2-object-box', - swfDefault: 'movieContainer', - swfError: 'swf_error', // SWF loaded, but SM2 couldn't start (other error) - swfTimedout: 'swf_timedout', - swfLoaded: 'swf_loaded', - swfUnblocked: 'swf_unblocked', // or loaded OK - sm2Debug: 'sm2_debug', - highPerf: 'high_performance', - flashDebug: 'flash_debug' - }; - /** * HTML5 error codes, per W3C * Error code 1, MEDIA_ERR_ABORTED: Client aborted download at user's request. @@ -355,22 +234,12 @@ function SoundManager(smURL, smID) { /** * Configures top-level soundManager properties. * - * @param {object} options Option parameters, eg. { flashVersion: 9, url: '/path/to/swfs/' } + * @param {object} options Option parameters, eg. soundManager.setup({debugMode: true, ignoreMobileRestrictions: true}); * onready and ontimeout are also accepted parameters. call soundManager.setup() to see the full list. */ this.setup = function(options) { - var noURL = (!sm2.url); - - // warn if flash options have already been applied - - if (options !== _undefined && didInit && needsFlash && sm2.ok() && (options.flashVersion !== _undefined || options.url !== _undefined || options.html5Test !== _undefined)) { - complain(str('setupLate')); - } - - // TODO: defer: true? - assign(options); if (!useGlobalHTML5Audio) { @@ -399,57 +268,20 @@ function SoundManager(smURL, smID) { messages.push(strings.ignoreMobile); - } else { + } else if ((isAndroid && !ua.match(/android\s2\.3/i)) || !isAndroid) { - // prefer HTML5 for mobile + tablet-like devices, probably more reliable vs. flash at this point. + /** + * 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. + */ // - if (!sm2.setupOptions.useHTML5Audio || sm2.setupOptions.preferFlash) { - // notify that defaults are being changed. - sm2._wD(strings.mobileUA); - } + sm2._wD(strings.globalHTML5); // - 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. - */ - - // - sm2._wD(strings.globalHTML5); - // - - 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) { - - if (noURL && didDCLoaded && options.url !== _undefined) { - sm2.beginDelayedInit(); - } - - // special case 2: If lazy-loading SM2 (DOMContentLoaded has already happened) and user calls setup() with url: parameter, try to init ASAP. + useGlobalHTML5Audio = true; - if (!didDCLoaded && options.url !== _undefined && doc.readyState === 'complete') { - setTimeout(domContentLoaded, 1); } } @@ -462,19 +294,12 @@ function SoundManager(smURL, smID) { this.ok = function() { - return (needsFlash ? (didInit && !disabled) : (sm2.useHTML5Audio && sm2.hasHTML5)); + return sm2.hasHTML5; }; this.supported = this.ok; // legacy - this.getMovie = function(movie_id) { - - // safety net: some old browsers differ on SWF references, possibly related to ExternalInterface / flash version - return id(movie_id) || doc[movie_id] || window[movie_id]; - - }; - /** * Creates a SMSound sound object instance. Can also be overloaded, e.g., createSound('mySound', '/some.mp3'); * @@ -529,7 +354,6 @@ function SoundManager(smURL, smID) { function make() { - options = loopFix(options); sm2.sounds[options.id] = new SMSound(options); sm2.soundIDs.push(options.id); return sm2.sounds[options.id]; @@ -539,69 +363,13 @@ function SoundManager(smURL, smID) { if (html5OK(options)) { oSound = make(); - // - if (!sm2.html5Only) { - sm2._wD(options.id + ': Using HTML5'); - } - // oSound._setup_html5(options); } else { - if (sm2.html5Only) { - sm2._wD(options.id + ': No HTML5 support for this sound, and no Flash. Exiting.'); - return make(); - } - - // TODO: Move HTML5/flash checks into generic URL parsing/handling function. - - if (sm2.html5.usingFlash && options.url && options.url.match(/data:/i)) { - // data: URIs not supported by Flash, either. - sm2._wD(options.id + ': data: URIs not supported via Flash. Exiting.'); - return make(); - } - - if (fV > 8) { - if (options.isMovieStar === null) { - // attempt to detect MPEG-4 formats - options.isMovieStar = !!(options.serverURL || (options.type ? options.type.match(netStreamMimeTypes) : false) || (options.url && options.url.match(netStreamPattern))); - } - // - if (options.isMovieStar) { - sm2._wD(cs + 'using MovieStar handling'); - if (options.loops > 1) { - _wDS('noNSLoop'); - } - } - // - } - - options = policyFix(options, cs); - oSound = make(); - - if (fV === 8) { - 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); - if (!options.serverURL) { - // We are connected immediately - oSound.connected = true; - if (options.onconnect) { - options.onconnect.apply(oSound); - } - } - } - - if (!options.serverURL && (options.autoLoad || options.autoPlay)) { - // call load for non-rtmp streams - oSound.load(options); - } - - } + sm2._wD(options.id + ': No HTML5 support for this sound. Exiting.'); + return make(); - // rtmp will play in onconnect - if (!options.serverURL && options.autoPlay) { - oSound.play(); } return oSound; @@ -1062,38 +830,15 @@ function SoundManager(smURL, smID) { }; - /** - * Retrieves the memory used by the flash plugin. - * - * @return {number} The amount of memory in use - */ - - this.getMemoryUse = function() { - - // flash-only - var ram = 0; - - if (flash && fV !== 8) { - ram = parseInt(flash._getMemoryUse(), 10); - } - - return ram; - - }; - /** * Undocumented: NOPs soundManager and all SMSound objects. */ - this.disable = function(bNoDisable) { + this.disable = function() { // destroy all functions var i; - if (bNoDisable === _undefined) { - bNoDisable = false; - } - // already disabled? if (disabled) return false; @@ -1108,7 +853,7 @@ function SoundManager(smURL, smID) { disableObject(sm2); // fire "complete", despite fail - initComplete(bNoDisable); + initComplete(); event.remove(window, 'load', initUserOnload); @@ -1130,11 +875,6 @@ function SoundManager(smURL, smID) { }); } - if (!result && needsFlash) { - // if flash 9, test netStream (movieStar) types as well. - result = (sMIME && sm2.ok() ? !!((fV > 8 ? sMIME.match(netStreamMimeTypes) : null) || sMIME.match(sm2.mimePattern)) : null); // TODO: make less "weird" (per JSLint) - } - return result; }; @@ -1156,10 +896,6 @@ function SoundManager(smURL, smID) { }); } - if (!result && needsFlash) { - result = (sURL && sm2.ok() ? !!(sURL.match(sm2.filePattern)) : null); - } - return result; }; @@ -1291,73 +1027,22 @@ function SoundManager(smURL, smID) { this._writeDebug = function(sText, sTypeOrObject) { // pseudo-private console.log()-style output - // - - var sDID = 'soundmanager-debug', o, oItem; - - if (!sm2.setupOptions.debugMode) return false; - - if (hasConsole && sm2.useConsole) { - if (sTypeOrObject && typeof sTypeOrObject === 'object') { - // object passed; dump to console. - console.log(sText, sTypeOrObject); - } else if (debugLevels[sTypeOrObject] !== _undefined) { - console[debugLevels[sTypeOrObject]](sText); - } else { - console.log(sText); - } - if (sm2.consoleOnly) return true; - } - - o = id(sDID); - - if (!o) return false; - oItem = doc.createElement('div'); - - if (++wdCount % 2 === 0) { - oItem.className = 'sm2-alt'; - } + // + if (!sm2.setupOptions.debugMode || !hasConsole) return; - if (sTypeOrObject === _undefined) { - sTypeOrObject = 0; + if (sTypeOrObject && typeof sTypeOrObject === 'object') { + // object passed; dump to console. + console.log(sText, sTypeOrObject); + } else if (debugLevels[sTypeOrObject] !== _undefined) { + console[debugLevels[sTypeOrObject]](sText); } else { - sTypeOrObject = parseInt(sTypeOrObject, 10); - } - - oItem.appendChild(doc.createTextNode(sText)); - - if (sTypeOrObject) { - if (sTypeOrObject >= 2) { - oItem.style.fontWeight = 'bold'; - } - if (sTypeOrObject === 3) { - oItem.style.color = '#ff3333'; - } + console.log(sText); } - - // top-to-bottom - // o.appendChild(oItem); - - // bottom-to-top - o.insertBefore(oItem, o.firstChild); - - o = null; // - return true; - }; - // - // last-resort debugging option - if (wl.indexOf('sm2-debug=alert') !== -1) { - this._writeDebug = function(sText) { - window.alert(sText); - }; - } - // - // alias this._wD = this._writeDebug; @@ -1402,33 +1087,7 @@ function SoundManager(smURL, smID) { sm2.sounds[sm2.soundIDs[i]].destruct(); } - // trash ze flash (remove from the DOM) - - if (flash) { - - try { - - if (isIE) { - oRemovedHTML = flash.innerHTML; - } - - oRemoved = flash.parentNode.removeChild(flash); - - } catch(e) { - - // Remove failed? May be due to flash blockers silently removing the SWF object/embed node from the DOM. Warn and continue. - - _wDS('badRemove', 2); - - } - - } - - // actually, force recreate of movie. - - oRemovedHTML = oRemoved = needsFlash = flash = null; - - sm2.enabled = didDCLoaded = didInit = waitingForEI = initPending = didAppend = appendSuccess = disabled = useGlobalHTML5Audio = sm2.swfLoaded = false; + sm2.enabled = didDCLoaded = didInit = disabled = useGlobalHTML5Audio = false; sm2.soundIDs = []; sm2.sounds = {}; @@ -1456,29 +1115,6 @@ function SoundManager(smURL, smID) { } // - // reset HTML5 and flash canPlay test results - - sm2.html5 = { - usingFlash: null - }; - - sm2.flash = {}; - - // reset device-specific HTML/flash mode switches - - sm2.html5Only = false; - sm2.ignoreFlash = false; - - window.setTimeout(function() { - - // by default, re-init - - if (!excludeInit) { - sm2.beginDelayedInit(); - } - - }, 20); - return sm2; }; @@ -1497,48 +1133,14 @@ function SoundManager(smURL, smID) { }; - /** - * Undocumented: Determines the SM2 flash movie's load progress. - * - * @return {number or null} Percent loaded, or if invalid/unsupported, null. - */ - - this.getMoviePercent = function() { - - /** - * Interesting syntax notes... - * Flash/ExternalInterface (ActiveX/NPAPI) bridge methods are not typeof "function" nor instanceof Function, but are still valid. - * Furthermore, using (flash && flash.PercentLoaded) causes IE to throw "object doesn't support this property or method". - * Thus, 'in' syntax must be used. - */ - - return (flash && 'PercentLoaded' in flash ? flash.PercentLoaded() : null); - - }; - /** * Additional helper for manually invoking SM2's init process after DOM Ready / window.onload(). */ this.beginDelayedInit = function() { - windowLoaded = true; domContentLoaded(); - setTimeout(function() { - - if (initPending) return false; - - createMovie(); - initMovie(); - initPending = true; - - return true; - - }, 20); - - delayWaitForEI(); - }; /** @@ -1562,7 +1164,7 @@ function SoundManager(smURL, smID) { SMSound = function(oOptions) { - var s = this, resetProperties, add_html5_events, remove_html5_events, stop_html5_timer, start_html5_timer, attachOnPosition, onplay_called = false, onPositionItems = [], onPositionFired = 0, detachOnPosition, applyFromTo, lastURL = null, lastHTML5State, urlOmitted; + var s = this, resetProperties, add_html5_events, remove_html5_events, stop_html5_timer, start_html5_timer, attachOnPosition, onplay_called = false, onPositionItems = [], onPositionFired = 0, detachOnPosition, applyFromTo, lastURL = null, lastHTML5State; lastHTML5State = { // tracks duration + position (time) @@ -1585,7 +1187,6 @@ function SoundManager(smURL, smID) { this._iO = this.instanceOptions; // assign property defaults - this.pan = this.options.pan; this.volume = this.options.volume; // whether or not this object is using HTML5 @@ -1594,15 +1195,12 @@ function SoundManager(smURL, smID) { // internal HTML5 Audio() object reference this._a = null; - // for flash 8 special-case createSound() without url, followed by load/play with url case - urlOmitted = (!this.url); - /** * SMSound() public methods * ------------------------ */ - this.id3 = {}; + this.id3 = {}; // legacy /** * Writes SMSound object parameters to debug console @@ -1658,21 +1256,12 @@ function SoundManager(smURL, smID) { return s; } - // - if (!s.isHTML5 && fV === 8 && !s.url && !instanceOptions.autoPlay) { - // flash 8 load() -> play() won't work before onload has fired. - sm2._wD(s.id + ': Flash 8 load() limitation: Wait for onload() before calling play().', 1); - } - // - if (instanceOptions.url === s.url && s.readyState !== 0 && s.readyState !== 2) { _wDS('onURL', 1); // if loaded and an onload() exists, fire immediately. if (s.readyState === 3 && instanceOptions.onload) { // assume success based on truthy duration. - wrapCallback(s, function() { - instanceOptions.onload.apply(s, [(!!s.duration)]); - }); + instanceOptions.onload.apply(s, [(!!s.duration)]); } return s; } @@ -1682,7 +1271,6 @@ function SoundManager(smURL, smID) { s.loaded = false; s.readyState = 1; s.playState = 0; - s.id3 = {}; // TODO: If switching from HTML5 -> flash (or vice versa), stop currently-playing audio. @@ -1712,10 +1300,6 @@ function SoundManager(smURL, smID) { } // given explicit load call, try to preload. - - // early HTML5 implementation (non-standard) - s._a.autobuffer = 'auto'; - // standard property, values: none / metadata / auto // reference: http://msdn.microsoft.com/en-us/library/ie/ff974759%28v=vs.85%29.aspx s._a.preload = 'auto'; @@ -1730,40 +1314,8 @@ function SoundManager(smURL, smID) { } else { - if (sm2.html5Only) { - sm2._wD(s.id + ': No flash support. Exiting.'); - return s; - } - - if (s._iO.url && s._iO.url.match(/data:/i)) { - // data: URIs not supported by Flash, either. - sm2._wD(s.id + ': data: URIs not supported via Flash. Exiting.'); - return s; - } - - try { - s.isHTML5 = false; - s._iO = policyFix(loopFix(instanceOptions)); - // if we have "position", disable auto-play as we'll be seeking to that position at onload(). - if (s._iO.autoPlay && (s._iO.position || s._iO.from)) { - sm2._wD(s.id + ': Disabling autoPlay because of non-zero offset case'); - s._iO.autoPlay = false; - } - // re-assign local shortcut - instanceOptions = s._iO; - 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); - } - } catch(e) { - _wDS('smError', 2); - debugTS('onload', false); - catchError({ - type: 'SMSOUND_LOAD_JS_EXCEPTION', - fatal: true - }); - } + sm2._wD(s.id + ': No support for this format. Exiting.'); + return s; } @@ -1782,42 +1334,27 @@ function SoundManager(smURL, smID) { this.unload = function() { - // Flash 8/AS2 can't "close" a stream - fake it by loading an empty URL - // Flash 9/AS3: Close stream, preventing further load - // HTML5: Most UAs will use empty URL - - if (s.readyState !== 0) { - - sm2._wD(s.id + ': unload()'); - - if (!s.isHTML5) { - - if (fV === 8) { - flash._unload(s.id, emptyURL); - } else { - flash._unload(s.id); - } - - } else { - - stop_html5_timer(); + // Most UAs will use an empty URL to unload. - if (s._a) { + // already done? + if (s.readyState === 0) return s; - s._a.pause(); + sm2._wD(s.id + ': unload()'); - // update empty URL, too - lastURL = html5Unload(s._a); + stop_html5_timer(); - } + if (s._a) { - } + s._a.pause(); - // reset load/status flags - resetProperties(); + // update empty URL, too + lastURL = html5Unload(s._a); } + // reset load/status flags + resetProperties(); + return s; }; @@ -1830,28 +1367,17 @@ function SoundManager(smURL, smID) { sm2._wD(s.id + ': Destruct'); - if (!s.isHTML5) { + stop_html5_timer(); - // kill sound within Flash - // Disable the onfailure handler - s._iO.onfailure = null; - flash._destroySound(s.id); - - } else { - - stop_html5_timer(); - - if (s._a) { - s._a.pause(); - html5Unload(s._a); - if (!useGlobalHTML5Audio) { - remove_html5_events(); - } - // break obvious circular reference - s._a._s = null; - s._a = null; + if (s._a) { + s._a.pause(); + html5Unload(s._a); + if (!useGlobalHTML5Audio) { + remove_html5_events(); } - + // break obvious circular reference + s._a._s = null; + s._a = null; } if (!_bFromSM) { @@ -1871,8 +1397,7 @@ function SoundManager(smURL, smID) { this.play = function(options, _updatePlayState) { var fN, allowMulti, a, onready, - audioClone, onended, oncanplay, - startOK = true; + audioClone, onended, oncanplay; // fN = s.id + ': play(): '; @@ -1900,16 +1425,6 @@ function SoundManager(smURL, smID) { s.instanceOptions = s._iO; - // RTMP-only - if (!s.isHTML5 && s._iO.serverURL && !s.connected) { - if (!s.getAutoPlay()) { - sm2._wD(fN + ' Netstream not connected yet - setting autoPlay'); - s.setAutoPlay(true); - } - // play will be called in onconnect() - return s; - } - if (html5OK(s._iO)) { s._setup_html5(s._iO); start_html5_timer(); @@ -1923,10 +1438,8 @@ function SoundManager(smURL, smID) { sm2._wD(fN + 'Already playing (one-shot)', 1); - if (s.isHTML5) { - // go back to original position. - s.setPosition(s._iO.position); - } + // go back to original position. + s.setPosition(s._iO.position); return s; @@ -1939,17 +1452,8 @@ function SoundManager(smURL, smID) { // edge case: play() with explicit URL parameter if (options.url && options.url !== s.url) { - // special case for createSound() followed by load() / play() with url; avoid double-load case. - if (!s.readyState && !s.isHTML5 && fV === 8 && urlOmitted) { - - urlOmitted = false; - - } else { - - // load using merged options - s.load(s._iO); - - } + // load using merged options + s.load(s._iO); } @@ -1959,25 +1463,8 @@ function SoundManager(smURL, smID) { sm2._wD(fN + 'Attempting to load'); - // try to get this sound playing ASAP - if (!s.isHTML5 && !sm2.html5Only) { - - // flash: assign directly because setAutoPlay() increments the instanceCount - s._iO.autoPlay = true; - s.load(s._iO); - - } else if (s.isHTML5) { - - // iOS needs this when recycling sounds, loading a new URL on an existing object. - s.load(s._iO); - - } else { - - sm2._wD(fN + 'Unsupported type. Exiting.'); - - return s; - - } + // iOS needs this when recycling sounds, loading a new URL on an existing object. + s.load(s._iO); // HTML5 hack - re-set instanceOptions? s.instanceOptions = s._iO; @@ -2001,12 +1488,6 @@ 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'); - options.position = 0; - } - /** * Streams will pause when their buffer is full if they are being loaded. * In this case paused is true, but the song hasn't started playing yet. @@ -2022,160 +1503,126 @@ function SoundManager(smURL, smID) { sm2._wD(fN + 'Resuming from paused state', 1); s.resume(); - } else { + return s; - s._iO = mixin(options, s._iO); + } - /** - * Preload in the event of play() with position under Flash, - * or from/to parameters and non-RTMP case - */ - if (((!s.isHTML5 && s._iO.position !== null && s._iO.position > 0) || (s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0 && !s._iO.serverURL) { + s._iO = mixin(options, s._iO); - onready = function() { - // sound "canplay" or onload() - // re-apply position/from/to to instance options, and start playback - s._iO = mixin(options, s._iO); - s.play(s._iO); - }; + /** + * Preload in the event of play() with position under Flash, + * or from/to parameters and non-RTMP case + */ + if (((s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0) { - // HTML5 needs to at least have "canplay" fired before seeking. - if (s.isHTML5 && !s._html5_canplay) { - - // this hasn't been loaded yet. load it first, and then do this again. - sm2._wD(fN + 'Beginning load for non-zero offset case'); - - s.load({ - // note: custom HTML5-only event added for from/to implementation. - _oncanplay: onready - }); - - } else if (!s.isHTML5 && !s.loaded && (!s.readyState || s.readyState !== 2)) { - - // to be safe, preload the whole thing in Flash. - - sm2._wD(fN + 'Preloading for non-zero offset case'); - - s.load({ - onload: onready - }); - - } - - // otherwise, we're ready to go. re-apply local options, and continue - - s._iO = applyFromTo(); - - } - - // sm2._wD(fN + 'Starting to play'); - - // increment instance counter, where enabled + supported - if (!s.instanceCount || s._iO.multiShotEvents || (s.isHTML5 && s._iO.multiShot && !useGlobalHTML5Audio) || (!s.isHTML5 && fV > 8 && !s.getAutoPlay())) { - s.instanceCount++; - } + onready = function() { + // sound "canplay" or onload() + // re-apply position/from/to to instance options, and start playback + s._iO = mixin(options, s._iO); + s.play(s._iO); + }; - // if first play and onposition parameters exist, apply them now - if (s._iO.onposition && s.playState === 0) { - attachOnPosition(s); - } + // HTML5 needs to at least have "canplay" fired before seeking. + if (s.isHTML5 && !s._html5_canplay) { - s.playState = 1; - s.paused = false; + // this hasn't been loaded yet. load it first, and then do this again. + sm2._wD(fN + 'Beginning load for non-zero offset case'); - s.position = (s._iO.position !== _undefined && !isNaN(s._iO.position) ? s._iO.position : 0); + s.load({ + // note: custom HTML5-only event added for from/to implementation. + _oncanplay: onready + }); - if (!s.isHTML5) { - s._iO = policyFix(loopFix(s._iO)); } - if (s._iO.onplay && _updatePlayState) { - s._iO.onplay.apply(s); - onplay_called = true; - } + // otherwise, we're ready to go. re-apply local options, and continue + s._iO = applyFromTo(); - s.setVolume(s._iO.volume, true); - s.setPan(s._iO.pan, true); + } - if (s._iO.playbackRate !== 1) { - s.setPlaybackRate(s._iO.playbackRate); - } + // increment instance counter, where enabled + supported + if (!s.instanceCount || s._iO.multiShotEvents || (s._iO.multiShot && !useGlobalHTML5Audio)) { + s.instanceCount++; + } - if (!s.isHTML5) { + // if first play and onposition parameters exist, apply them now + if (s._iO.onposition && s.playState === 0) { + attachOnPosition(s); + } - startOK = flash._start(s.id, s._iO.loops || 1, (fV === 9 ? s.position : s.position / msecScale), s._iO.multiShot || false); + s.playState = 1; + s.paused = false; + s.position = (s._iO.position !== _undefined && !isNaN(s._iO.position) ? s._iO.position : 0); - if (fV === 9 && !startOK) { - // edge case: no sound hardware, or 32-channel flash ceiling hit. - // applies only to Flash 9, non-NetStream/MovieStar sounds. - // http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html#play%28%29 - sm2._wD(fN + 'No sound hardware, or 32-sound ceiling hit', 2); - if (s._iO.onplayerror) { - s._iO.onplayerror.apply(s); - } + if (s._iO.onplay && _updatePlayState) { + s._iO.onplay.apply(s); + onplay_called = true; + } - } + s.setVolume(s._iO.volume, true); - } else if (s.instanceCount < 2) { + if (s._iO.playbackRate !== 1) { + s.setPlaybackRate(s._iO.playbackRate); + } - // HTML5 single-instance case + if (s.instanceCount < 2) { - start_html5_timer(); + // HTML5 single-instance case - a = s._setup_html5(); + start_html5_timer(); - s.setPosition(s._iO.position); + a = s._setup_html5(); - a.play(); + s.setPosition(s._iO.position); - } else { + a.play(); - // HTML5 multi-shot case + } else { - sm2._wD(s.id + ': Cloning Audio() for instance #' + s.instanceCount + '...'); + // HTML5 multi-shot case - audioClone = new Audio(s._iO.url); + sm2._wD(s.id + ': Cloning Audio() for instance #' + s.instanceCount + '...'); - onended = function() { - event.remove(audioClone, 'ended', onended); - s._onfinish(s); - // cleanup - html5Unload(audioClone); - audioClone = null; - }; + audioClone = new Audio(s._iO.url); - oncanplay = function() { - event.remove(audioClone, 'canplay', oncanplay); - try { - audioClone.currentTime = s._iO.position / msecScale; - } catch(err) { - complain(s.id + ': multiShot play() failed to apply position of ' + (s._iO.position / msecScale)); - } - audioClone.play(); - }; + onended = function() { + event.remove(audioClone, 'ended', onended); + s._onfinish(s); + // cleanup + html5Unload(audioClone); + audioClone = null; + }; - event.add(audioClone, 'ended', onended); + oncanplay = function() { + event.remove(audioClone, 'canplay', oncanplay); + try { + audioClone.currentTime = s._iO.position / msecScale; + } catch(err) { + complain(s.id + ': multiShot play() failed to apply position of ' + (s._iO.position / msecScale)); + } + audioClone.play(); + }; - // apply volume to clones, too - if (s._iO.volume !== _undefined) { - audioClone.volume = Math.max(0, Math.min(1, s._iO.volume / 100)); - } + event.add(audioClone, 'ended', onended); - // playing multiple muted sounds? if you do this, you're weird ;) - but let's cover it. - if (s.muted) { - audioClone.muted = true; - } + // apply volume to clones, too + if (s._iO.volume !== _undefined) { + audioClone.volume = Math.max(0, Math.min(1, s._iO.volume / 100)); + } - if (s._iO.position) { - // HTML5 audio can't seek before onplay() event has fired. - // wait for canplay, then seek to position and start playback. - event.add(audioClone, 'canplay', oncanplay); - } else { - // begin playback at currentTime: 0 - audioClone.play(); - } + // playing multiple muted sounds? if you do this, you're weird ;) - but let's cover it. + if (s.muted) { + audioClone.muted = true; + } - } + if (s._iO.position) { + // HTML5 audio can't seek before onplay() event has fired. + // wait for canplay, then seek to position and start playback. + event.add(audioClone, 'canplay', oncanplay); + } else { + // begin playback at currentTime: 0 + audioClone.play(); + } } @@ -2187,13 +1634,12 @@ function SoundManager(smURL, smID) { this.start = this.play; /** - * Stops playing a sound (and optionally, all sounds) + * Stops playing a sound * - * @param {boolean} bAll Optional: Whether to stop all sounds * @return {SMSound} The SMSound object */ - this.stop = function(bAll) { + this.stop = function() { var instanceOptions = s._iO, originalPosition; @@ -2206,10 +1652,6 @@ function SoundManager(smURL, smID) { s._resetOnPosition(0); s.paused = false; - if (!s.isHTML5) { - s.playState = 0; - } - // remove onPosition listeners, if any detachOnPosition(); @@ -2218,37 +1660,28 @@ function SoundManager(smURL, smID) { s.clearOnPosition(instanceOptions.to); } - if (!s.isHTML5) { - - flash._stop(s.id, bAll); - - // hack for netStream: just unload - if (instanceOptions.serverURL) { - s.unload(); - } - - } else if (s._a) { + if (s._a) { - originalPosition = s.position; + originalPosition = s.position; - // act like Flash, though - s.setPosition(0); + // act like Flash, though + s.setPosition(0); - // hack: reflect old position for onstop() (also like Flash) - s.position = originalPosition; + // hack: reflect old position for onstop() (also like Flash) + s.position = originalPosition; - // html5 has no stop() - // NOTE: pausing means iOS requires interaction to resume. - s._a.pause(); + // html5 has no stop() + // NOTE: pausing means iOS requires interaction to resume. + s._a.pause(); - s.playState = 0; + s.playState = 0; - // and update UI - s._onTimer(); + // and update UI + s._onTimer(); - stop_html5_timer(); + stop_html5_timer(); - } + } s.instanceCount = 0; s._iO = {}; @@ -2263,42 +1696,6 @@ function SoundManager(smURL, smID) { }; - /** - * Undocumented/internal: Sets autoPlay for RTMP. - * - * @param {boolean} autoPlay state - */ - - this.setAutoPlay = function(autoPlay) { - - sm2._wD(s.id + ': Autoplay turned ' + (autoPlay ? 'on' : 'off')); - s._iO.autoPlay = autoPlay; - - if (!s.isHTML5) { - flash._setAutoPlay(s.id, autoPlay); - if (autoPlay) { - // only increment the instanceCount if the sound isn't loaded (TODO: verify RTMP) - if (!s.instanceCount && s.readyState === 1) { - s.instanceCount++; - sm2._wD(s.id + ': Incremented instance count to ' + s.instanceCount); - } - } - } - - }; - - /** - * Undocumented/internal: Returns the autoPlay boolean. - * - * @return {boolean} The current autoPlay value - */ - - this.getAutoPlay = function() { - - return s._iO.autoPlay; - - }; - /** * Sets the playback rate of a sound (HTML5-only.) * @@ -2318,13 +1715,11 @@ function SoundManager(smURL, smID) { } // - if (s.isHTML5) { - try { - s._iO.playbackRate = normalizedRate; - s._a.playbackRate = normalizedRate; - } catch(e) { - sm2._wD(s.id + ': setPlaybackRate(' + normalizedRate + ') failed: ' + e.message, 2); - } + try { + s._iO.playbackRate = normalizedRate; + s._a.playbackRate = normalizedRate; + } catch(e) { + sm2._wD(s.id + ': setPlaybackRate(' + normalizedRate + ') failed: ' + e.message, 2); } return s; @@ -2344,65 +1739,54 @@ function SoundManager(smURL, smID) { nMsecOffset = 0; } - var position, position1K, + var position1K, // Use the duration from the instance options, if we don't have a track duration yet. // position >= 0 and <= current available (loaded) duration - offset = (s.isHTML5 ? Math.max(nMsecOffset, 0) : Math.min(s.duration || s._iO.duration, Math.max(nMsecOffset, 0))); + offset = Math.max(nMsecOffset, 0); s.position = offset; position1K = s.position / msecScale; s._resetOnPosition(s.position); s._iO.position = offset; - if (!s.isHTML5) { - - position = (fV === 9 ? s.position : position1K); + if (!s._a) return s; - if (s.readyState && s.readyState !== 2) { - // if paused or not playing, will not resume (by playing) - flash._setPosition(s.id, position, (s.paused || !s.playState), s._iO.multiShot); - } - - } else if (s._a) { + // Set the position in the canplay handler if the sound is not ready yet + if (s._html5_canplay) { - // Set the position in the canplay handler if the sound is not ready yet - if (s._html5_canplay) { + if (s._a.currentTime.toFixed(3) !== position1K.toFixed(3)) { - if (s._a.currentTime.toFixed(3) !== position1K.toFixed(3)) { + /** + * DOM/JS errors/exceptions to watch out for: + * if seek is beyond (loaded?) position, "DOM exception 11" + * "INDEX_SIZE_ERR": DOM exception 1 + */ + sm2._wD(s.id + ': setPosition(' + position1K + ')'); - /** - * DOM/JS errors/exceptions to watch out for: - * if seek is beyond (loaded?) position, "DOM exception 11" - * "INDEX_SIZE_ERR": DOM exception 1 - */ - sm2._wD(s.id + ': setPosition(' + position1K + ')'); - - try { - s._a.currentTime = position1K; - if (s.playState === 0 || s.paused) { - // allow seek without auto-play/resume - s._a.pause(); - } - } catch(e) { - sm2._wD(s.id + ': setPosition(' + position1K + ') failed: ' + e.message, 2); + try { + s._a.currentTime = position1K; + if (s.playState === 0 || s.paused) { + // allow seek without auto-play/resume + s._a.pause(); } - + } catch(e) { + sm2._wD(s.id + ': setPosition(' + position1K + ') failed: ' + e.message, 2); } - } else if (position1K) { + } - // warn on non-zero seek attempts - sm2._wD(s.id + ': setPosition(' + position1K + '): Cannot seek yet, sound not ready', 2); - return s; + } else if (position1K) { - } + // warn on non-zero seek attempts + sm2._wD(s.id + ': setPosition(' + position1K + '): Cannot seek yet, sound not ready', 2); + return s; - if (s.paused) { + } - // if paused, refresh UI right away by forcing update - s._onTimer(true); + if (s.paused) { - } + // if paused, refresh UI right away by forcing update + s._onTimer(true); } @@ -2416,21 +1800,15 @@ function SoundManager(smURL, smID) { * @return {SMSound} The SMSound object */ - this.pause = function(_bCallFlash) { + this.pause = function() { if (s.paused || (s.playState === 0 && s.readyState !== 1)) return s; sm2._wD(s.id + ': pause()'); s.paused = true; - if (!s.isHTML5) { - if (_bCallFlash || _bCallFlash === _undefined) { - flash._pause(s.id, s._iO.multiShot); - } - } else { - s._setup_html5().pause(); - stop_html5_timer(); - } + s._setup_html5().pause(); + stop_html5_timer(); if (s._iO.onpause) { s._iO.onpause.apply(s); @@ -2464,22 +1842,8 @@ function SoundManager(smURL, smID) { s.paused = false; 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(); - - } + s._setup_html5().play(); + start_html5_timer(); if (!onplay_called && instanceOptions.onplay) { @@ -2508,7 +1872,7 @@ function SoundManager(smURL, smID) { if (s.playState === 0) { s.play({ - position: (fV === 9 && !s.isHTML5 ? s.position : s.position / msecScale) + position: (s.position / msecScale) }); return s; } @@ -2525,6 +1889,7 @@ function SoundManager(smURL, smID) { /** * Sets the panning (L-R) effect. + * Note: Not supported via HTML5. * * @param {number} nPan The pan value (-100 to 100) * @return {SMSound} The SMSound object @@ -2540,10 +1905,6 @@ function SoundManager(smURL, smID) { bInstanceOnly = false; } - if (!s.isHTML5) { - flash._setPan(s.id, nPan); - } // else { no HTML5 pan? } - s._iO.pan = nPan; if (!bInstanceOnly) { @@ -2579,11 +1940,7 @@ function SoundManager(smURL, smID) { _bInstanceOnly = false; } - if (!s.isHTML5) { - - flash._setVolume(s.id, (sm2.muted && !s.muted) || s.muted ? 0 : nVol); - - } else if (s._a) { + if (s._a) { if (sm2.muted && !s.muted) { s.muted = true; @@ -2616,9 +1973,7 @@ function SoundManager(smURL, smID) { s.muted = true; - if (!s.isHTML5) { - flash._setVolume(s.id, 0); - } else if (s._a) { + if (s._a) { s._a.muted = true; } @@ -2635,11 +1990,8 @@ function SoundManager(smURL, smID) { this.unmute = function() { s.muted = false; - var hasIO = (s._iO.volume !== _undefined); - if (!s.isHTML5) { - flash._setVolume(s.id, hasIO ? s._iO.volume : s.options.volume); - } else if (s._a) { + if (s._a) { s._a.muted = false; } @@ -2869,17 +2221,13 @@ function SoundManager(smURL, smID) { start_html5_timer = function() { - if (s.isHTML5) { - startTimer(s); - } + startTimer(s); }; stop_html5_timer = function() { - if (s.isHTML5) { - stopTimer(s); - } + stopTimer(s); }; @@ -2901,12 +2249,6 @@ function SoundManager(smURL, smID) { s.durationEstimate = null; s.buffered = []; - // legacy: 1D array - s.eqData = []; - - s.eqData.left = []; - s.eqData.right = []; - s.failures = 0; s.isBuffering = false; s.instanceOptions = {}; @@ -2920,6 +2262,11 @@ function SoundManager(smURL, smID) { s.muted = false; s.paused = false; + // legacy Flash bits: eqData, peakData, waveformData, id3 + s.eqData = []; + s.eqData.left = []; + s.eqData.right = []; + s.peakData = { left: 0, right: 0 @@ -2988,13 +2335,7 @@ function SoundManager(smURL, smID) { } - }/* else { - - // sm2._wD('_onTimer: Warn for "'+s.id+'": '+(!s._a?'Could not find element. ':'')+(s.playState === 0?'playState bad, 0?':'playState = '+s.playState+', OK')); - - return false; - - }*/ + } } @@ -3212,35 +2553,19 @@ function SoundManager(smURL, smID) { var fN, // check for duration to prevent false positives from flash 8 when loading from cache. - loadOK = !!nSuccess || (!s.isHTML5 && fV === 8 && s.duration); + loadOK = !!nSuccess; // 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); - } - if (sm2.sandbox.noLocal === true) { - sm2._wD(fN + str('noLocal'), 1); - } - } // s.loaded = loadOK; s.readyState = (loadOK ? 3 : 2); s._onbufferchange(0); - if (!loadOK && !s.isHTML5) { - // note: no error code from Flash. - s._onerror(); - } - if (s._iO.onload) { - wrapCallback(s, function() { - s._iO.onload.apply(s, [loadOK]); - }); + s._iO.onload.apply(s, [loadOK]); } return true; @@ -3251,9 +2576,7 @@ function SoundManager(smURL, smID) { // https://html.spec.whatwg.org/multipage/embedded-content.html#error-codes if (s._iO.onerror) { - wrapCallback(s, function() { - s._iO.onerror.apply(s, [errorCode, description]); - }); + s._iO.onerror.apply(s, [errorCode, description]); } }; @@ -3310,19 +2633,6 @@ function SoundManager(smURL, smID) { }; - /** - * flash 9/movieStar + RTMP-only method for unhandled warnings/exceptions from Flash - * e.g., RTMP "method missing" warning (non-fatal) for getStreamLength on server - */ - - this._onwarning = function(msg, level, code) { - - if (s._iO.onwarning) { - s._iO.onwarning(msg, level, code); - } - - }; - this._onfinish = function() { // store local copy before it gets trashed... @@ -3350,9 +2660,7 @@ function SoundManager(smURL, smID) { stop_html5_timer(); // reset position, too - if (s.isHTML5) { - s.position = 0; - } + s.position = 0; } @@ -3360,9 +2668,7 @@ function SoundManager(smURL, smID) { // fire onfinish for last, or every instance if (io_onfinish) { sm2._wD(s.id + ': onfinish()'); - wrapCallback(s, function() { - io_onfinish.apply(s); - }); + io_onfinish.apply(s); } } @@ -3378,86 +2684,26 @@ function SoundManager(smURL, smID) { s.bytesTotal = nBytesTotal; s.duration = Math.floor(nDuration); s.bufferLength = nBufferLength; - - if (!s.isHTML5 && !instanceOptions.isMovieStar) { - - if (instanceOptions.duration) { - // use duration from options, if specified and larger. nobody should be specifying duration in options, actually, and it should be retired. - s.durationEstimate = (s.duration > instanceOptions.duration) ? s.duration : instanceOptions.duration; - } else { - s.durationEstimate = parseInt((s.bytesTotal / s.bytesLoaded) * s.duration, 10); - } - - } else { - - s.durationEstimate = s.duration; - - } - - // for flash, reflect sequential-load-style buffering - if (!s.isHTML5) { - s.buffered = [{ - start: 0, - end: s.duration - }]; - } + s.durationEstimate = s.duration; // allow whileloading to fire even if "load" fired under HTML5, due to HTTP range/partials - if ((s.readyState !== 3 || s.isHTML5) && instanceOptions.whileloading) { + if (instanceOptions.whileloading) { instanceOptions.whileloading.apply(s); } }; - this._whileplaying = function(nPosition, oPeakData, oWaveformDataLeft, oWaveformDataRight, oEQData) { - - var instanceOptions = s._iO, - eqLeft; + this._whileplaying = function(nPosition) { - // flash safety net - if (isNaN(nPosition) || nPosition === null) return false; + var instanceOptions = s._iO; // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. Unexpected/invalid per W3, I think. Normalize to 0. s.position = Math.max(0, nPosition); s._processOnPosition(); - if (!s.isHTML5 && fV > 8) { - - if (instanceOptions.usePeakData && oPeakData !== _undefined && oPeakData) { - s.peakData = { - left: oPeakData.leftPeak, - right: oPeakData.rightPeak - }; - } - - if (instanceOptions.useWaveformData && oWaveformDataLeft !== _undefined && oWaveformDataLeft) { - s.waveformData = { - left: oWaveformDataLeft.split(','), - right: oWaveformDataRight.split(',') - }; - } - - if (instanceOptions.useEQData) { - if (oEQData !== _undefined && oEQData && oEQData.leftEQ) { - eqLeft = oEQData.leftEQ.split(','); - s.eqData = eqLeft; - s.eqData.left = eqLeft; - if (oEQData.rightEQ !== _undefined && oEQData.rightEQ) { - s.eqData.right = oEQData.rightEQ.split(','); - } - } - } - - } - if (s.playState === 1) { - // special case/hack: ensure buffering is false if loading from cache (and not yet started) - if (!s.isHTML5 && fV === 8 && !s.position && s.isBuffering) { - s._onbufferchange(0); - } - if (instanceOptions.whileplaying) { // flash may call after actual finish instanceOptions.whileplaying.apply(s); @@ -3469,118 +2715,6 @@ function SoundManager(smURL, smID) { }; - this._oncaptiondata = function(oData) { - - /** - * internal: flash 9 + NetStream (MovieStar/RTMP-only) feature - * - * @param {object} oData - */ - - sm2._wD(s.id + ': Caption data received.'); - - s.captiondata = oData; - - if (s._iO.oncaptiondata) { - s._iO.oncaptiondata.apply(s, [oData]); - } - - }; - - this._onmetadata = function(oMDProps, oMDData) { - - /** - * internal: flash 9 + NetStream (MovieStar/RTMP-only) feature - * RTMP may include song title, MovieStar content may include encoding info - * - * @param {array} oMDProps (names) - * @param {array} oMDData (values) - */ - - sm2._wD(s.id + ': Metadata received.'); - - var oData = {}, i, j; - - for (i = 0, j = oMDProps.length; i < j; i++) { - oData[oMDProps[i]] = oMDData[i]; - } - - s.metadata = oData; - - if (s._iO.onmetadata) { - s._iO.onmetadata.call(s, s.metadata); - } - - }; - - this._onid3 = function(oID3Props, oID3Data) { - - /** - * internal: flash 8 + flash 9 ID3 feature - * may include artist, song title etc. - * - * @param {array} oID3Props (names) - * @param {array} oID3Data (values) - */ - - sm2._wD(s.id + ': ID3 data received.'); - - var oData = [], i, j; - - for (i = 0, j = oID3Props.length; i < j; i++) { - oData[oID3Props[i]] = oID3Data[i]; - } - - s.id3 = mixin(s.id3, oData); - - if (s._iO.onid3) { - s._iO.onid3.apply(s); - } - - }; - - // flash/RTMP-only - - this._onconnect = function(bSuccess) { - - bSuccess = (bSuccess === 1); - sm2._wD(s.id + ': ' + (bSuccess ? 'Connected.' : 'Failed to connect? - ' + s.url), (bSuccess ? 1 : 2)); - s.connected = bSuccess; - - if (bSuccess) { - - s.failures = 0; - - if (idCheck(s.id)) { - if (s.getAutoPlay()) { - // only update the play state if auto playing - s.play(_undefined, s.getAutoPlay()); - } else if (s._iO.autoLoad) { - s.load(); - } - } - - if (s._iO.onconnect) { - s._iO.onconnect.apply(s, [bSuccess]); - } - - } - - }; - - this._ondataerror = function(sError) { - - // flash 9 wave/eq data handler - // hack: called at start, and end from flash at/after onfinish() - if (s.playState > 0) { - sm2._wD(s.id + ': Data error: ' + sError); - if (s._iO.ondataerror) { - s._iO.ondataerror.apply(s); - } - } - - }; - // this._debug(); // @@ -3592,18 +2726,6 @@ function SoundManager(smURL, smID) { * ------------------------------ */ - getDocument = function() { - - return (doc.body || doc.getElementsByTagName('div')[0]); - - }; - - id = function(sID) { - - return doc.getElementById(sID); - - }; - mixin = function(oMain, oAdd) { // non-destructive merge @@ -3636,31 +2758,12 @@ function SoundManager(smURL, smID) { }; - wrapCallback = function(oSound, callback) { - - /** - * 03/03/2013: Fix for Flash Player 11.6.602.171 + Flash 8 (flashVersion = 8) SWF issue - * setTimeout() fix for certain SMSound callbacks like onload() and onfinish(), where subsequent calls like play() and load() fail when Flash Player 11.6.602.171 is installed, and using soundManager with flashVersion = 8 (which is the default). - * Not sure of exact cause. Suspect race condition and/or invalid (NaN-style) position argument trickling down to the next JS -> Flash _start() call, in the play() case. - * Fix: setTimeout() to yield, plus safer null / NaN checking on position argument provided to Flash. - * https://getsatisfaction.com/schillmania/topics/recent_chrome_update_seems_to_have_broken_my_sm2_audio_player - */ - if (!oSound.isHTML5 && fV === 8) { - window.setTimeout(callback, 0); - } else { - callback(); - } - - }; - // additional soundManager properties that soundManager.setup() will accept extraOptions = { onready: 1, ontimeout: 1, - defaultOptions: 1, - flash9Options: 1, - movieStarOptions: 1 + defaultOptions: 1 }; assign = function(o, oParent) { @@ -3786,13 +2889,6 @@ function SoundManager(smURL, smID) { }; - function preferFlashCheck(kind) { - - // whether flash should play a given type - return (sm2.preferFlash && hasFlash && !sm2.ignoreFlash && (sm2.flash[kind] !== _undefined && sm2.flash[kind])); - - } - /** * Internal DOM2-level event helpers * --------------------------------- @@ -3897,6 +2993,7 @@ function SoundManager(smURL, smID) { abort: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': abort'); }), @@ -3908,6 +3005,8 @@ function SoundManager(smURL, smID) { var s = this._s, position1K; + if (!s) return; + if (s._html5_canplay) { // this event has already fired. ignore. return; @@ -3941,6 +3040,7 @@ function SoundManager(smURL, smID) { var s = this._s; + if (!s) return; if (!s.loaded) { s._onbufferchange(0); s._whileloading(s.bytesLoaded, s.bytesTotal, s._get_html5_duration()); @@ -3956,6 +3056,8 @@ function SoundManager(smURL, smID) { var s = this._s, duration; + if (!s) return; + duration = s._get_html5_duration(); if (!isNaN(duration) && duration !== s.duration) { @@ -3968,19 +3070,11 @@ function SoundManager(smURL, smID) { }), - // TODO: Reserved for potential use - /* - emptied: html5_event(function() { - - sm2._wD(this._s.id + ': emptied'); - - }), - */ - ended: html5_event(function() { var s = this._s; + if (!s) return; sm2._wD(s.id + ': ended'); s._onfinish(); @@ -3989,6 +3083,7 @@ function SoundManager(smURL, smID) { error: html5_event(function() { + if (!this._s) return; var description = (html5ErrorCodes[this.error.code] || null); sm2._wD(this._s.id + ': HTML5 error, code ' + this.error.code + (description ? ' (' + description + ')' : '')); this._s._onload(false); @@ -4000,6 +3095,8 @@ function SoundManager(smURL, smID) { var s = this._s; + if (!s) return; + sm2._wD(s.id + ': loadeddata'); // safari seems to nicely report progress events, eventually totalling 100% @@ -4011,12 +3108,14 @@ function SoundManager(smURL, smID) { loadedmetadata: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': loadedmetadata'); }), loadstart: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': loadstart'); // assume buffering at first this._s._onbufferchange(1); @@ -4025,7 +3124,7 @@ function SoundManager(smURL, smID) { play: html5_event(function() { - // sm2._wD(this._s.id + ': play()'); + if (!this._s) return; // once play starts, no buffering this._s._onbufferchange(0); @@ -4033,6 +3132,7 @@ function SoundManager(smURL, smID) { playing: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': playing ' + String.fromCharCode(9835)); // once play starts, no buffering this._s._onbufferchange(0); @@ -4043,6 +3143,8 @@ function SoundManager(smURL, smID) { // note: can fire repeatedly after "loaded" event, due to use of HTTP range/partials + if (!this._s) return; + var s = this._s, i, j, progStr, buffered = 0, isProgress = (e.type === 'progress'), @@ -4060,7 +3162,7 @@ function SoundManager(smURL, smID) { // https://developer.mozilla.org/en/DOM/TimeRanges // re-build "buffered" array - // HTML5 returns seconds. SM2 API uses msec for setPosition() etc., whether Flash or HTML5. + // HTML5 returns seconds. SM2 API uses msec for setPosition() etc. for (i = 0, j = ranges.length; i < j; i++) { s.buffered.push({ start: ranges.start(i) * msecScale, @@ -4106,6 +3208,7 @@ function SoundManager(smURL, smID) { ratechange: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': ratechange'); }), @@ -4115,6 +3218,8 @@ function SoundManager(smURL, smID) { // download paused/stopped, may have finished (eg. onload) var s = this._s; + if (!s) return; + sm2._wD(this._s.id + ': suspend'); html5_events.progress.call(this, e); s._onsuspend(); @@ -4123,12 +3228,14 @@ function SoundManager(smURL, smID) { stalled: html5_event(function() { + if (!this._s) return; sm2._wD(this._s.id + ': stalled'); }), timeupdate: html5_event(function() { + if (!this._s) return; this._s._onTimer(); }), @@ -4137,6 +3244,8 @@ function SoundManager(smURL, smID) { var s = this._s; + if (!s) return; + // see also: seeking sm2._wD(this._s.id + ': waiting'); @@ -4153,20 +3262,15 @@ function SoundManager(smURL, smID) { var result; - if (!iO || (!iO.type && !iO.url && !iO.serverURL)) { + if (!iO || (!iO.type && !iO.url)) { // nothing to check result = false; - } else if (iO.serverURL || (iO.type && preferFlashCheck(iO.type))) { - - // RTMP, or preferring flash - result = false; - } else { // Use type, if specified. Pass data: URIs to HTML5. If HTML5-only mode, no other options, so just give 'er - result = ((iO.type ? html5CanPlay({ type: iO.type }) : html5CanPlay({ url: iO.url }) || sm2.html5Only || iO.url.match(/data:/i))); + result = ((iO.type ? html5CanPlay({ type: iO.type }) : html5CanPlay({ url: iO.url }) || iO.url.match(/data:/i))); } @@ -4222,7 +3326,7 @@ function SoundManager(smURL, smID) { * } */ - if (!sm2.useHTML5Audio || !sm2.hasHTML5) return false; + if (!sm2.hasHTML5) return false; var url = (o.url || null), mime = (o.type || null), @@ -4234,7 +3338,7 @@ function SoundManager(smURL, smID) { // account for known cases like audio/mp3 - if (mime && sm2.html5[mime] !== _undefined) return (sm2.html5[mime] && !preferFlashCheck(mime)); + if (mime && sm2.html5[mime] !== _undefined) return (sm2.html5[mime]); if (!html5Ext) { @@ -4287,7 +3391,7 @@ function SoundManager(smURL, smID) { if (fileExt && sm2.html5[fileExt] !== _undefined) { // result known - result = (sm2.html5[fileExt] && !preferFlashCheck(fileExt)); + result = (sm2.html5[fileExt]); } else { @@ -4297,7 +3401,7 @@ function SoundManager(smURL, smID) { sm2.html5[fileExt] = result; // sm2._wD('canPlayType, found result: ' + result); - result = (result && sm2.html5[mime] && !preferFlashCheck(mime)); + result = (result && sm2.html5[mime]); } return result; @@ -4311,16 +3415,6 @@ function SoundManager(smURL, smID) { * assigns results to html5[] and flash[]. */ - 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. :/ var a = (Audio !== _undefined ? (isOpera && opera.version() < 10 ? new Audio(null) : new Audio()) : null), item, lookup, support = {}, aF, i; @@ -4344,9 +3438,6 @@ function SoundManager(smURL, smID) { isOK = true; sm2.html5[m[i]] = true; - // note flash support, too - sm2.flash[m[i]] = !!(m[i].match(flashMIME)); - } } @@ -4379,19 +3470,6 @@ function SoundManager(smURL, smID) { // write back generic type too, eg. audio/mp3 support[lookup] = support[item]; - // assign flash - if (item.match(flashMIME)) { - - sm2.flash[item] = true; - sm2.flash[lookup] = true; - - } else { - - sm2.flash[item] = false; - sm2.flash[lookup] = false; - - } - // assign result to related formats, too if (aF[item] && aF[item].related) { @@ -4401,7 +3479,6 @@ function SoundManager(smURL, smID) { // eg. audio/m4a support['audio/' + aF[item].related[i]] = support[item]; sm2.html5[aF[item].related[i]] = support[item]; - sm2.flash[aF[item].related[i]] = support[item]; } @@ -4414,9 +3491,6 @@ function SoundManager(smURL, smID) { support.canPlayType = (a ? cp : null); sm2.html5 = mixin(sm2.html5, support); - sm2.html5.usingFlash = featureCheck(); - needsFlash = sm2.html5.usingFlash; - return true; }; @@ -4426,15 +3500,6 @@ function SoundManager(smURL, smID) { // notReady: 'Unavailable - wait until onready() has fired.', notOK: 'Audio support is not available.', - domError: sm + 'exception caught while appending SWF to DOM.', - spcWmode: 'Removing wmode, preventing known SWF loading issue(s)', - swf404: smc + 'Verify that %s is a valid path.', - tryDebug: 'Try ' + sm + '.debugFlash = true for more security details (output goes to SWF.)', - checkSWF: 'See SWF output for more debug info.', - localFail: smc + 'Non-HTTP page (' + doc.location.protocol + ' URL?) Review Flash player security settings for this special case:\nhttp://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html\nMay need to add/allow path, eg. c:/sm2/ or /users/me/sm2/', - waitFocus: smc + 'Special case: Waiting for SWF to load with window focus...', - waitForever: smc + 'Waiting indefinitely for Flash (will recover if unblocked)...', - waitSWF: smc + 'Waiting for 100% SWF load...', needFunction: smc + 'Function object expected for %s', badID: 'Sound ID "%s" should be a string, starting with a non-numeric character', currentObj: smc + '_debug(): Current sound objects', @@ -4443,29 +3508,15 @@ function SoundManager(smURL, smID) { onload: smc + 'initComplete(): calling soundManager.onload()', onloadOK: sm + '.onload() complete', didInit: smc + 'init(): Already called?', - secNote: 'Flash security note: Network/internet URLs will not load due to security restrictions. Access can be configured via Flash Player Global Security Settings Page: http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html', - badRemove: smc + 'Failed to remove Flash node.', 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...', - fbLoaded: 'Flash loaded', - fbHandler: smc + 'flashBlockHandler()', manURL: 'SMSound.load(): Using manually-assigned URL', onURL: sm + '.load(): current URL already assigned.', - badFV: sm + '.flashVersion must be 8 or 9. "%s" is invalid. Reverting to %s.', - as2loop: 'Note: Setting stream:false so looping can work (flash 8 limitation)', - noNSLoop: 'Note: Looping not implemented for MovieStar formats', - needfl9: 'Note: Switching to flash 9, required for MP4 formats.', - mfTimeout: 'Setting flashLoadTimeout = 0 (infinite) for off-screen, mobile flash case', - needFlash: smc + 'Fatal error: Flash is needed to play some required formats, but is not available.', gotFocus: smc + 'Got window focus.', - policy: 'Enabling usePolicyFile for data access', setup: sm + '.setup(): allowed parameters: %s', setupError: sm + '.setup(): "%s" cannot be assigned with this method.', setupUndef: sm + '.setup(): Could not find option "%s"', - setupLate: sm + '.setup(): url, flashVersion and html5Test property changes will not take effect until reboot().', - noURL: smc + 'Flash URL required. Call soundManager.setup({url:...}) to get started.', + setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003), reset: sm + '.reset(): Removing event callbacks', mobileUA: 'Mobile UA detected, preferring HTML5 by default.', @@ -4504,29 +3555,6 @@ function SoundManager(smURL, smID) { }; - loopFix = function(sOpt) { - - // flash 8 requires stream = false for looping to work - if (fV === 8 && sOpt.loops > 1 && sOpt.stream) { - _wDS('as2loop'); - sOpt.stream = false; - } - - return sOpt; - - }; - - policyFix = function(sOpt, sPre) { - - if (sOpt && !sOpt.usePolicyFile && (sOpt.onid3 || sOpt.usePeakData || sOpt.useWaveformData || sOpt.useEQData)) { - sm2._wD((sPre || '') + str('policy')); - sOpt.usePolicyFile = true; - } - - return sOpt; - - }; - complain = function(sMsg) { // @@ -4559,182 +3587,10 @@ function SoundManager(smURL, smID) { }; - failSafely = function(bNoDisable) { - - // general failure exception handler - - if (bNoDisable === _undefined) { - bNoDisable = false; - } - - if (disabled || bNoDisable) { - sm2.disable(bNoDisable); - } - - }; - - normalizeMovieURL = function(movieURL) { - - var urlParams = null, url; - - if (movieURL) { - - if (movieURL.match(/\.swf(\?.*)?$/i)) { - - urlParams = movieURL.substr(movieURL.toLowerCase().lastIndexOf('.swf?') + 4); - - // assume user knows what they're doing - if (urlParams) return movieURL; - - } else if (movieURL.lastIndexOf('/') !== movieURL.length - 1) { - - // append trailing slash, if needed - movieURL += '/'; - - } - - } - - url = (movieURL && movieURL.lastIndexOf('/') !== -1 ? movieURL.substr(0, movieURL.lastIndexOf('/') + 1) : './') + sm2.movieURL; - - if (sm2.noSWFCache) { - url += ('?ts=' + new Date().getTime()); - } - - return url; - - }; - setVersionInfo = function() { // short-hand for internal use - - fV = parseInt(sm2.flashVersion, 10); - - if (fV !== 8 && fV !== 9) { - sm2._wD(str('badFV', fV, defaultFlashVersion)); - sm2.flashVersion = fV = defaultFlashVersion; - } - - // debug flash movie, if applicable - - 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)')); - - // 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')]; - - // if applicable, use _debug versions of SWFs - sm2.movieURL = (fV === 8 ? 'soundmanager2.swf' : 'soundmanager2_flash9.swf').replace('.swf', isDebug); - - sm2.features.peakData = sm2.features.waveformData = sm2.features.eqData = (fV > 8); - - }; - - setPolling = function(bPolling, bHighPerformance) { - - if (!flash) { - return; - } - - flash._setPolling(bPolling, bHighPerformance); - - }; - - initDebug = function() { - - // starts debug mode, creating output
for UAs without console object - - // allow force of debug mode via URL - // - if (sm2.debugURLParam.test(wl)) { - sm2.setupOptions.debugMode = sm2.debugMode = true; - } - - if (id(sm2.debugID)) { - return; - } - - var oD, oDebug, oTarget, oToggle, tmp; - - if (sm2.debugMode && !id(sm2.debugID) && (!hasConsole || !sm2.useConsole || !sm2.consoleOnly)) { - - oD = doc.createElement('div'); - oD.id = sm2.debugID + '-toggle'; - - oToggle = { - position: 'fixed', - bottom: '0px', - right: '0px', - width: '1.2em', - height: '1.2em', - lineHeight: '1.2em', - margin: '2px', - textAlign: 'center', - border: '1px solid #999', - cursor: 'pointer', - background: '#fff', - color: '#333', - zIndex: 10001 - }; - - oD.appendChild(doc.createTextNode('-')); - oD.onclick = toggleDebug; - oD.title = 'Toggle SM2 debug console'; - - if (ua.match(/msie 6/i)) { - oD.style.position = 'absolute'; - oD.style.cursor = 'hand'; - } - - for (tmp in oToggle) { - if (oToggle.hasOwnProperty(tmp)) { - oD.style[tmp] = oToggle[tmp]; - } - } - - oDebug = doc.createElement('div'); - oDebug.id = sm2.debugID; - 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()); - } - oTarget.appendChild(oDebug); - } - - } - - oTarget = null; - // + sm2.version = sm2.versionNumber + ' (HTML5-only mode)'; }; @@ -4747,28 +3603,6 @@ function SoundManager(smURL, smID) { }; - toggleDebug = function() { - - var o = id(sm2.debugID), - oT = id(sm2.debugID + '-toggle'); - - if (!o) { - return; - } - - if (debugOpen) { - // minimize - oT.innerHTML = '+'; - o.style.display = 'none'; - } else { - oT.innerHTML = '-'; - o.style.display = 'block'; - } - - debugOpen = !debugOpen; - - }; - debugTS = function(sEventType, bSuccess, sMessage) { // troubleshooter debug hooks @@ -4787,79 +3621,6 @@ function SoundManager(smURL, smID) { }; // - getSWFCSS = function() { - - var css = []; - - if (sm2.debugMode) { - css.push(swfCSS.sm2Debug); - } - - if (sm2.debugFlash) { - css.push(swfCSS.flashDebug); - } - - if (sm2.useHighPerformance) { - css.push(swfCSS.highPerf); - } - - return css.join(' '); - - }; - - flashBlockHandler = function() { - - // *possible* flash block situation. - - var name = str('fbHandler'), - p = sm2.getMoviePercent(), - css = swfCSS, - error = { - type: 'FLASHBLOCK' - }; - - if (sm2.html5Only) { - // no flash, or unused - return; - } - - if (!sm2.ok()) { - - if (needsFlash) { - // make the movie more visible, so user can fix - 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 - }); - - catchError(error); - - } else { - - // SM2 loaded OK (or recovered) - - // - if (sm2.didFlashBlock) { - sm2._wD(name + ': Unblocked'); - } - // - - if (sm2.oMC) { - sm2.oMC.className = [getSWFCSS(), css.swfDefault, css.swfLoaded + (sm2.didFlashBlock ? ' ' + css.swfUnblocked : '')].join(' '); - } - - } - - }; - addOnEvent = function(sType, oMethod, oScope) { if (on_queue[sType] === _undefined) { @@ -4899,7 +3660,7 @@ function SoundManager(smURL, smID) { queue = [], i, j, args = [status], - canRetry = (needsFlash && !sm2.ok()); + canRetry = !sm2.ok(); if (oOptions.error) { args[0].error = oOptions.error; @@ -4923,9 +3684,7 @@ function SoundManager(smURL, smID) { } if (!canRetry) { - // useFlashBlock and SWF timeout case doesn't count here. queue[i].fired = true; - } } @@ -4940,10 +3699,6 @@ function SoundManager(smURL, smID) { window.setTimeout(function() { - if (sm2.useFlashBlock) { - flashBlockHandler(); - } - processOnEvents(); // call user-defined "onload", scoped to window @@ -4962,141 +3717,6 @@ function SoundManager(smURL, smID) { }; - 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 - */ - - // this work has already been done. - if (hasFlash !== _undefined) return hasFlash; - - var hasPlugin = false, n = navigator, obj, type, types, AX = window.ActiveXObject; - - // MS Edge 14 throws an "Unspecified Error" because n.plugins is inaccessible due to permissions - var nP; - - try { - nP = n.plugins; - } catch(e) { - nP = undefined; - } - - 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'); - } catch(e) { - // oh well - obj = null; - } - - hasPlugin = (!!obj); - - // cleanup, because it is ActiveX after all - obj = null; - - } - - hasFlash = hasPlugin; - - return hasPlugin; - - }; - - featureCheck = function() { - - var flashNeeded, - item, - formats = sm2.audioFormats, - // iPhone <= 3.1 has broken HTML5 audio(), but firmware 3.2 (original iPad) + iOS4 works. - isSpecial = (is_iDevice && !!(ua.match(/os (1|2|3_0|3_1)\s/i))); - - if (isSpecial) { - - // has Audio(), but is broken; let it load links directly. - sm2.hasHTML5 = false; - - // ignore flash case, however - sm2.html5Only = true; - - // hide the SWF, if present - if (sm2.oMC) { - sm2.oMC.style.display = 'none'; - } - - } else if (sm2.useHTML5Audio) { - - if (!sm2.html5 || !sm2.html5.canPlayType) { - sm2._wD('SoundManager: No HTML5 Audio() support detected.'); - sm2.hasHTML5 = false; - } - - // - 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); - } - // - - } - - if (sm2.useHTML5Audio && sm2.hasHTML5) { - - // sort out whether flash is optional, required or can be ignored. - - // innocent until proven guilty. - 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; - - } - - } - - } - - } - - } - - // sanity check... - if (sm2.ignoreFlash) { - flashNeeded = false; - canIgnoreFlash = true; - } - - sm2.html5Only = (sm2.hasHTML5 && sm2.useHTML5Audio && !flashNeeded); - - return (!sm2.html5Only); - - }; - parseURL = function(url) { /** @@ -5245,755 +3865,30 @@ function SoundManager(smURL, smID) { }; - badSafariFix = function() { + /** + * Private initialization helpers + * ------------------------------ + */ - // special case: "bad" Safari (OS X 10.3 - 10.7) must fall back to flash for MP3/MP4 - if (!isBadSafari || !detectFlash()) { - // doesn't apply - return; - } + initComplete = function() { - var aF = sm2.audioFormats, i, item; + if (didInit) return false; - for (item in aF) { + // all good. + _wDS('sm2Loaded', 1); + didInit = true; + initUserOnload(); + debugTS('onload', true); + return true; - if (aF.hasOwnProperty(item)) { + }; - if (item === 'mp3' || item === 'mp4') { + /** + * apply top-level setupOptions object as local properties, eg., this.setupOptions.debugMode -> this.debugMode (soundManager.debugMode) + * this maintains backward compatibility, and allows properties to be defined separately for use by soundManager.setup(). + */ - 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--) { - sm2.html5[aF[item].related[i]] = false; - } - } - - } - - } - - } - - }; - - /** - * Pseudo-private flash/ExternalInterface methods - * ---------------------------------------------- - */ - - this._setSandboxType = function(sandboxType) { - - // - // Security sandbox according to Flash plugin - var sb = sm2.sandbox; - - sb.type = sandboxType; - sb.description = sb.types[(sb.types[sandboxType] !== _undefined ? sandboxType : 'unknown')]; - - if (sb.type === 'localWithFile') { - - sb.noRemote = true; - sb.noLocal = false; - _wDS('secNote', 2); - - } else if (sb.type === 'localWithNetwork') { - - sb.noRemote = false; - sb.noLocal = true; - - } else if (sb.type === 'localTrusted') { - - sb.noRemote = false; - sb.noLocal = false; - - } - // - - }; - - this._externalInterfaceOK = function(swfVersion) { - - // flash callback confirming flash loaded, EI working etc. - // swfVersion: SWF build string - - if (sm2.swfLoaded) { - return; - } - - var e; - - debugTS('swf', true); - debugTS('flashtojs', true); - sm2.swfLoaded = true; - tryInitOnFocus = false; - - if (isBadSafari) { - badSafariFix(); - } - - // complain if JS + SWF build/version strings don't match, excluding +DEV builds - // - if (!swfVersion || swfVersion.replace(/\+dev/i, '') !== sm2.versionNumber.replace(/\+dev/i, '')) { - - e = sm + ': Fatal: JavaScript file build "' + sm2.versionNumber + '" does not match Flash SWF build "' + swfVersion + '" at ' + sm2.url + '. Ensure both are up-to-date.'; - - // escape flash -> JS stack so this error fires in window. - setTimeout(function() { - throw new Error(e); - }, 0); - - // exit, init will fail with timeout - return; - - } - // - - // IE needs a larger timeout - setTimeout(init, isIE ? 100 : 1); - - }; - - /** - * Private initialization helpers - * ------------------------------ - */ - - createMovie = function(movieID, movieURL) { - - // ignore if already connected - if (didAppend && appendSuccess) return false; - - function initMsg() { - - // - - var options = [], - title, - msg = [], - delimiter = ' + '; - - title = 'SoundManager ' + sm2.version + (!sm2.html5Only && sm2.useHTML5Audio ? (sm2.hasHTML5 ? ' + HTML5 audio' : ', no HTML5 audio support') : ''); - - if (!sm2.html5Only) { - - if (sm2.preferFlash) { - options.push('preferFlash'); - } - - if (sm2.useHighPerformance) { - options.push('useHighPerformance'); - } - - if (sm2.flashPollingInterval) { - options.push('flashPollingInterval (' + sm2.flashPollingInterval + 'ms)'); - } - - if (sm2.html5PollingInterval) { - options.push('html5PollingInterval (' + sm2.html5PollingInterval + 'ms)'); - } - - if (sm2.wmode) { - options.push('wmode (' + sm2.wmode + ')'); - } - - if (sm2.debugFlash) { - options.push('debugFlash'); - } - - if (sm2.useFlashBlock) { - options.push('flashBlock'); - } - - } else if (sm2.html5PollingInterval) { - options.push('html5PollingInterval (' + sm2.html5PollingInterval + 'ms)'); - } - - if (options.length) { - msg = msg.concat([options.join(delimiter)]); - } - - sm2._wD(title + (msg.length ? delimiter + msg.join(', ') : ''), 1); - - showSupport(); - - // - - } - - if (sm2.html5Only) { - - // 100% HTML5 mode - setVersionInfo(); - - initMsg(); - sm2.oMC = id(sm2.movieID); - init(); - - // prevent multiple init attempts - didAppend = true; - - appendSuccess = true; - - return false; - - } - - // flash path - var remoteURL = (movieURL || sm2.url), - localURL = (sm2.altURL || remoteURL), - swfTitle = 'JS/Flash audio component (SoundManager 2)', - oTarget = getDocument(), - extraClass = getSWFCSS(), - isRTL = null, - html = doc.getElementsByTagName('html')[0], - oEmbed, oMovie, tmp, movieHTML, oEl, s, x, sClass; - - isRTL = (html && html.dir && html.dir.match(/rtl/i)); - movieID = (movieID === _undefined ? sm2.id : movieID); - - function param(name, value) { - return ''; - } - - // safety check for legacy (change to Flash 9 URL) - setVersionInfo(); - sm2.url = normalizeMovieURL(overHTTP ? remoteURL : localURL); - movieURL = sm2.url; - - sm2.wmode = (!sm2.wmode && sm2.useHighPerformance ? 'transparent' : sm2.wmode); - - if (sm2.wmode !== null && (ua.match(/msie 8/i) || (!isIE && !sm2.useHighPerformance)) && navigator.platform.match(/win32|win64/i)) { - /** - * extra-special case: movie doesn't load until scrolled into view when using wmode = anything but 'window' here - * does not apply when using high performance (position:fixed means on-screen), OR infinite flash load timeout - * wmode breaks IE 8 on Vista + Win7 too in some cases, as of January 2011 (?) - */ - messages.push(strings.spcWmode); - sm2.wmode = null; - } - - oEmbed = { - name: movieID, - id: movieID, - src: movieURL, - quality: 'high', - allowScriptAccess: sm2.allowScriptAccess, - bgcolor: sm2.bgColor, - pluginspage: http + 'www.macromedia.com/go/getflashplayer', - title: swfTitle, - type: 'application/x-shockwave-flash', - wmode: sm2.wmode, - // http://help.adobe.com/en_US/as3/mobile/WS4bebcd66a74275c36cfb8137124318eebc6-7ffd.html - hasPriority: 'true' - }; - - if (sm2.debugFlash) { - oEmbed.FlashVars = 'debug=1'; - } - - if (!sm2.wmode) { - // don't write empty attribute - delete oEmbed.wmode; - } - - if (isIE) { - - // IE is "special". - oMovie = doc.createElement('div'); - movieHTML = [ - '', - param('movie', movieURL), - param('AllowScriptAccess', sm2.allowScriptAccess), - param('quality', oEmbed.quality), - (sm2.wmode ? param('wmode', sm2.wmode) : ''), - param('bgcolor', sm2.bgColor), - param('hasPriority', 'true'), - (sm2.debugFlash ? param('FlashVars', oEmbed.FlashVars) : ''), - '' - ].join(''); - - } else { - - oMovie = doc.createElement('embed'); - for (tmp in oEmbed) { - if (oEmbed.hasOwnProperty(tmp)) { - oMovie.setAttribute(tmp, oEmbed[tmp]); - } - } - - } - - initDebug(); - extraClass = getSWFCSS(); - oTarget = getDocument(); - - if (oTarget) { - - sm2.oMC = (id(sm2.movieID) || doc.createElement('div')); - - if (!sm2.oMC.id) { - - sm2.oMC.id = sm2.movieID; - sm2.oMC.className = swfCSS.swfDefault + ' ' + extraClass; - s = null; - oEl = null; - - if (!sm2.useFlashBlock) { - if (sm2.useHighPerformance) { - // on-screen at all times - s = { - position: 'fixed', - width: '8px', - height: '8px', - // >= 6px for flash to run fast, >= 8px to start up under Firefox/win32 in some cases. odd? yes. - bottom: '0px', - left: '0px', - overflow: 'hidden' - }; - } else { - // hide off-screen, lower priority - s = { - position: 'absolute', - width: '6px', - height: '6px', - top: '-9999px', - left: '-9999px' - }; - if (isRTL) { - s.left = Math.abs(parseInt(s.left, 10)) + 'px'; - } - } - } - - if (isWebkit) { - // soundcloud-reported render/crash fix, safari 5 - sm2.oMC.style.zIndex = 10000; - } - - if (!sm2.debugFlash) { - for (x in s) { - if (s.hasOwnProperty(x)) { - sm2.oMC.style[x] = s[x]; - } - } - } - - 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()); - - } - - } 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.appendChild(oMovie); - - if (isIE) { - oEl = sm2.oMC.appendChild(doc.createElement('div')); - oEl.className = swfCSS.swfBox; - oEl.innerHTML = movieHTML; - } - - appendSuccess = true; - - } - - } - - didAppend = true; - - initMsg(); - - // sm2._wD(sm + ': Trying to load ' + movieURL + (!overHTTP && sm2.altURL ? ' (alternate URL)' : ''), 1); - - return true; - - }; - - initMovie = function() { - - if (sm2.html5Only) { - createMovie(); - return false; - } - - // attempt to get, or create, movie (may already exist) - if (flash) return false; - - if (!sm2.url) { - - /** - * Something isn't right - we've reached init, but the soundManager url property has not been set. - * User has not called setup({url: ...}), or has not set soundManager.url (legacy use case) directly before init time. - * Notify and exit. If user calls setup() with a url: property, init will be restarted as in the deferred loading case. - */ - - _wDS('noURL'); - return false; - - } - - // inline markup case - 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') { - setTimeout(sm2.oninitmovie, 1); - } - - // - flushMessages(); - // - - return true; - - }; - - delayWaitForEI = function() { - - setTimeout(waitForEI, 1000); - - }; - - rebootIntoHTML5 = function() { - - // special case: try for a reboot with preferFlash: false, if 100% HTML5 mode is possible and useFlashBlock is not enabled. - - window.setTimeout(function() { - - complain(smc + 'useFlashBlock is false, 100% HTML5 mode is possible. Rebooting with preferFlash: false...'); - - sm2.setup({ - preferFlash: false - }).reboot(); - - // if for some reason you want to detect this case, use an ontimeout() callback and look for html5Only and didFlashBlock == true. - sm2.didFlashBlock = true; - - sm2.beginDelayedInit(); - - }, 1); - - }; - - waitForEI = function() { - - var p, - loadIncomplete = false; - - if (!sm2.url) { - // No SWF url to load (noURL case) - exit for now. Will be retried when url is set. - return; - } - - if (waitingForEI) { - return; - } - - waitingForEI = true; - event.remove(window, 'load', delayWaitForEI); - - if (hasFlash && tryInitOnFocus && !isFocused) { - // Safari won't load flash in background tabs, only when focused. - _wDS('waitFocus'); - return; - } - - if (!didInit) { - p = sm2.getMoviePercent(); - if (p > 0 && p < 100) { - loadIncomplete = true; - } - } - - setTimeout(function() { - - p = sm2.getMoviePercent(); - - if (loadIncomplete) { - // special case: if movie *partially* loaded, retry until it's 100% before assuming failure. - waitingForEI = false; - sm2._wD(str('waitSWF')); - window.setTimeout(delayWaitForEI, 1); - return; - } - - // - 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); - - if (!overHTTP && p) { - - _wDS('localFail', 2); - - if (!sm2.debugFlash) { - _wDS('tryDebug', 2); - } - - } - - if (p === 0) { - - // if 0 (not null), probably a 404. - sm2._wD(str('swf404', sm2.url), 1); - - } - - debugTS('flashtojs', false, ': Timed out' + (overHTTP ? ' (Check flash security or flash blockers)' : ' (No plugin/missing SWF?)')); - - } - // - - // give up / time-out, depending - - if (!didInit && okToDisable) { - - if (p === null) { - - // SWF failed to report load progress. Possibly blocked. - - if (sm2.useFlashBlock || sm2.flashLoadTimeout === 0) { - - if (sm2.useFlashBlock) { - - flashBlockHandler(); - - } - - _wDS('waitForever'); - - } else if (!sm2.useFlashBlock && canIgnoreFlash) { - - // no custom flash block handling, but SWF has timed out. Will recover if user unblocks / allows SWF load. - rebootIntoHTML5(); - - } else { - - _wDS('waitForever'); - - // fire any regular registered ontimeout() listeners. - processOnEvents({ - type: 'ontimeout', - ignoreInit: true, - error: { - type: 'INIT_FLASHBLOCK' - } - }); - - } - - } else if (sm2.flashLoadTimeout === 0) { - - // SWF loaded? Shouldn't be a blocking issue, then. - - _wDS('waitForever'); - - } else if (!sm2.useFlashBlock && canIgnoreFlash) { - - rebootIntoHTML5(); - - } else { - - failSafely(true); - - } - - } - - }, sm2.flashLoadTimeout); - - }; - - handleFocus = function() { - - function cleanup() { - event.remove(window, 'focus', handleFocus); - } - - if (isFocused || !tryInitOnFocus) { - // already focused, or not special Safari background tab case - cleanup(); - return true; - } - - okToDisable = true; - isFocused = true; - _wDS('gotFocus'); - - // allow init to restart - waitingForEI = false; - - // kick off ExternalInterface timeout, now that the SWF has started - delayWaitForEI(); - - cleanup(); - return true; - - }; - - flushMessages = function() { - - // - - // SM2 pre-init debug messages - if (messages.length) { - sm2._wD('SoundManager 2: ' + messages.join(' '), 1); - messages = []; - } - - // - - }; - - showSupport = function() { - - // - - flushMessages(); - - var item, tests = []; - - 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)' : '')))); - } - } - sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); - } - - // - - }; - - initComplete = function(bNoDisable) { - - if (didInit) return false; - - if (sm2.html5Only) { - // all good. - _wDS('sm2Loaded', 1); - didInit = true; - initUserOnload(); - debugTS('onload', true); - return true; - } - - var wasTimeout = (sm2.useFlashBlock && sm2.flashLoadTimeout && !sm2.getMoviePercent()), - result = true, - error; - - if (!wasTimeout) { - didInit = true; - } - - 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); - } - - 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 { - - // - if (sm2.waitForWindowLoad && windowLoaded) { - _wDS('docLoaded'); - } - // - - initUserOnload(); - - } - - } - - return result; - - }; - - /** - * apply top-level setupOptions object as local properties, eg., this.setupOptions.flashVersion -> this.flashVersion (soundManager.flashVersion) - * this maintains backward compatibility, and allows properties to be defined separately for use by soundManager.setup(). - */ - - setProperties = function() { + setProperties = function() { var i, o = sm2.setupOptions; @@ -6031,125 +3926,58 @@ function SoundManager(smURL, smID) { return false; } - function cleanup() { - event.remove(window, 'load', sm2.beginDelayedInit); - } - - if (sm2.html5Only) { + // - if (!didInit) { - // we don't need no steenking flash! - cleanup(); - sm2.enabled = true; - initComplete(); - } + var item, tests = []; - return true; + if (!sm2.hasHTML5) return false; + for (item in sm2.audioFormats) { + if (sm2.audioFormats.hasOwnProperty(item)) { + tests.push(item + ' = ' + sm2.html5[item] + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); + } } - // flash path - initMovie(); - - try { - - // 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) - */ - setPolling(true, (sm2.flashPollingInterval || (sm2.useHighPerformance ? 10 : 50))); + sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); - if (!sm2.debugMode) { - // stop the SWF from making debug output calls to JS - flash._disableDebug(); - } + // + if (!didInit) { + // we don't need no steenking flash! + event.remove(window, 'load', sm2.beginDelayedInit); sm2.enabled = true; - debugTS('jstoflash', true); - - if (!sm2.html5Only) { - // prevent browser from showing cached page state (or rather, restoring "suspended" page state) via back button, because flash may be dead - // http://www.webkit.org/blog/516/webkit-page-cache-ii-the-unload-event/ - event.add(window, 'unload', doNothing); - } - - } catch(e) { - - sm2._wD('js/flash exception: ' + e.toString()); - - debugTS('jstoflash', false); - - catchError({ - type: 'JS_TO_FLASH_EXCEPTION', - fatal: true - }); - - // don't disable, for reboot() - failSafely(true); - initComplete(); - - return false; - } - initComplete(); - - // disconnect events - cleanup(); - return true; }; domContentLoaded = function() { - if (didDCLoaded) return false; + if (didDCLoaded) return; didDCLoaded = true; + // allow force of debug mode via URL + // + if (sm2.debugURLParam.test(wl)) { + sm2.setupOptions.debugMode = sm2.debugMode = true; + } + // + // assign top-level soundManager properties eg. soundManager.url setProperties(); - initDebug(); - - 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) { doc.removeEventListener('DOMContentLoaded', domContentLoaded, false); } - initMovie(); - - return true; + // 100% HTML5 mode + setVersionInfo(); + init(); }; @@ -6166,9 +3994,6 @@ function SoundManager(smURL, smID) { winOnLoad = function() { - // catch edge case of initComplete() firing after window.load() - windowLoaded = true; - // catch case where DOMContentLoaded has been sent, but we're still in doc.readyState = 'interactive' domContentLoaded(); @@ -6176,12 +4001,6 @@ function SoundManager(smURL, smID) { }; - // sniff up-front - detectFlash(); - - // focus and window load, init (primarily flash-driven) - event.add(window, 'focus', handleFocus); - event.add(window, 'load', delayWaitForEI); event.add(window, 'load', winOnLoad); if (doc.addEventListener) { @@ -6194,7 +4013,7 @@ function SoundManager(smURL, smID) { } else { - // no add/attachevent support - safe to assume no JS -> Flash either + // no add/attachevent support; perhaps a browser from the stone age (IE 5, Netscape 4.7 etc.) debugTS('onload', false); catchError({ type: 'NO_DOM2_EVENTS', @@ -6205,11 +4024,7 @@ function SoundManager(smURL, smID) { } // SoundManager() -// SM2_DEFER details: http://www.schillmania.com/projects/soundmanager2/doc/getstarted/#lazy-loading - -if (window.SM2_DEFER === _undefined || !SM2_DEFER) { - soundManager = new SoundManager(); -} +soundManager = new SoundManager(); /** * SoundManager public interfaces @@ -6232,25 +4047,9 @@ if (typeof module === 'object' && module && typeof module.exports === 'object') * 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(function() { @@ -6283,12 +4082,7 @@ if (typeof module === 'object' && module && typeof module.exports === 'object') // 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. +// public API window.soundManager = soundManager; }(window)); From 590283457c2a0fd195ea6858d74494f5662c7a08 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:33 -0800 Subject: [PATCH 30/59] Remove / update legacy flash comments. --- script/soundmanager2.js | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 2a5b2dcf..7ad9f3cb 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -1272,8 +1272,6 @@ function SoundManager() { s.readyState = 1; s.playState = 0; - // TODO: If switching from HTML5 -> flash (or vice versa), stop currently-playing audio. - if (html5OK(instanceOptions)) { oSound = s._setup_html5(instanceOptions); @@ -1510,8 +1508,7 @@ function SoundManager() { s._iO = mixin(options, s._iO); /** - * Preload in the event of play() with position under Flash, - * or from/to parameters and non-RTMP case + * Attempt to preload in the event of from/to parameters */ if (((s._iO.from !== null && s._iO.from > 0) || s._iO.to !== null) && s.instanceCount === 0 && s.playState === 0) { From 9952b7560706cf814a315654f401b10384470f55 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:33 -0800 Subject: [PATCH 31/59] "Could not find" -> "unknown" SM2 setup options. --- script/soundmanager2.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 7ad9f3cb..17a4d194 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3512,7 +3512,7 @@ function SoundManager() { gotFocus: smc + 'Got window focus.', setup: sm + '.setup(): allowed parameters: %s', setupError: sm + '.setup(): "%s" cannot be assigned with this method.', - setupUndef: sm + '.setup(): Could not find option "%s"', + setupUndef: sm + '.setup(): Unknown option "%s"', setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003), reset: sm + '.reset(): Removing event callbacks', From 544425fc73078f759b61bd194016d2edabe65145 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:33 -0800 Subject: [PATCH 32/59] =?UTF-8?q?ASCII=20=E2=9C=93=20/=20=E2=9C=97=20for?= =?UTF-8?q?=20format=20support=20tests,=20more=20concise=20vs.=20true=20/?= =?UTF-8?q?=20false.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- script/soundmanager2.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 17a4d194..d96860ae 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3931,11 +3931,11 @@ function SoundManager() { for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { - tests.push(item + ' = ' + sm2.html5[item] + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); + tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); } } - sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(', '), 1); + sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(' '), 1); // From c6fe2aa8ef153cc50e2a9fccb4bd602b2df03057 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:33 -0800 Subject: [PATCH 33/59] `waitForWindowLoad` option can be dropped, since no longer waiting for Flash or other things. `initUserOnload()` can be inlined and called immediately, no `setTimeout()` shenanigans. --- script/soundmanager2.js | 38 +++++++++++--------------------------- 1 file changed, 11 insertions(+), 27 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index d96860ae..41fb58ed 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -63,7 +63,6 @@ function SoundManager() { this.setupOptions = { debugMode: true, // enable debugging output (console.log() with HTML fallback) - waitForWindowLoad: false, // force SM2 to wait for window.onload() before trying to call soundManager.onload() html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. 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. @@ -184,7 +183,7 @@ function SoundManager() { */ var SMSound, - sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, initUserOnload, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], + sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/i), isSafari = (ua.match(/safari/i) && !ua.match(/chrome/i)), @@ -855,8 +854,6 @@ function SoundManager() { // fire "complete", despite fail initComplete(); - event.remove(window, 'load', initUserOnload); - return true; }; @@ -3692,28 +3689,6 @@ function SoundManager() { }; - initUserOnload = function() { - - window.setTimeout(function() { - - processOnEvents(); - - // call user-defined "onload", scoped to window - - if (typeof sm2.onload === 'function') { - _wDS('onload', 1); - sm2.onload.apply(window); - _wDS('onloadOK', 1); - } - - if (sm2.waitForWindowLoad) { - event.add(window, 'load', initUserOnload); - } - - }, 1); - - }; - parseURL = function(url) { /** @@ -3874,7 +3849,16 @@ function SoundManager() { // all good. _wDS('sm2Loaded', 1); didInit = true; - initUserOnload(); + + processOnEvents(); + + // call user-defined "onload", scoped to window + if (typeof sm2.onload === 'function') { + _wDS('onload', 1); + sm2.onload.apply(window); + _wDS('onloadOK', 1); + } + debugTS('onload', true); return true; From d2677f0bc49b74db003ae99ae5e5a95c8568d815 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:33 -0800 Subject: [PATCH 34/59] Tidy up some comments. --- script/soundmanager2.js | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 41fb58ed..2b4fd292 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -96,7 +96,7 @@ function SoundManager() { multiShot: true, // let sounds "restart" or layer on top of each other when played multiple times, rather than one-shot/one at a time multiShotEvents: false, // fire multiple sound events (currently onfinish() only) when multiShot is enabled position: null, // offset (milliseconds) to seek to within loaded sound data. - playbackRate: 1, // rate at which to play the sound (HTML5-only) + playbackRate: 1, // rate at which to play the sound stream: true, // allows playing before entire file has loaded (recommended) to: null, // position to end playback within a sound (msec), default = end type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 @@ -1658,10 +1658,10 @@ function SoundManager() { originalPosition = s.position; - // act like Flash, though + // reset position on stop s.setPosition(0); - // hack: reflect old position for onstop() (also like Flash) + // reflect old position for onstop() (also like Flash) s.position = originalPosition; // html5 has no stop() @@ -2519,8 +2519,6 @@ function SoundManager() { remove_html5_events = function() { - // Remove event listeners - var f; function remove(oEvt, oFn, bCapture) { @@ -2691,7 +2689,8 @@ function SoundManager() { var instanceOptions = s._iO; - // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. Unexpected/invalid per W3, I think. Normalize to 0. + // Safari HTML5 play() may return small -ve values when starting from position: 0, eg. -50.120396875. + // Unexpected/invalid per W3, I think. Normalize to 0. s.position = Math.max(0, nPosition); s._processOnPosition(); @@ -3405,8 +3404,8 @@ function SoundManager() { testHTML5 = function() { /** - * Internal: Iterates over audioFormats, determining support eg. audio/mp3, audio/mpeg and so on - * assigns results to html5[] and flash[]. + * Internal: Iterates over audioFormats, determining support eg. audio/mp3, audio/mpeg etc. + * results are assigned to `soundManager.html5` object. */ // 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. :/ From 1d43b217dfcdcda37d32ea98b1e131854f353e73 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:33 -0800 Subject: [PATCH 35/59] SM2 can ignore HTML5 `loadedmetadata` event altogether; `durationchange` seems to fire ahead of this event as-is. --- script/soundmanager2.js | 7 ------- 1 file changed, 7 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 2b4fd292..2a69df5e 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3099,13 +3099,6 @@ function SoundManager() { }), - loadedmetadata: html5_event(function() { - - if (!this._s) return; - sm2._wD(this._s.id + ': loadedmetadata'); - - }), - loadstart: html5_event(function() { if (!this._s) return; From 4238bb91dd219dfa1eaa8c31a943d9a4b10c62c3 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 36/59] `setup()` is going to complain when legacy Flash-era options are provided. Note as "unknown". Could retain the list of legacy labels, but that seems redundant. --- script/soundmanager2.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 2a69df5e..31b36a52 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -2837,7 +2837,7 @@ function SoundManager() { } else if (bonusOptions[i] === _undefined) { - // invalid or disallowed parameter. complain. + // invalid, legacy (flash-era) or disallowed parameter. complain. complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); result = false; @@ -3501,7 +3501,7 @@ function SoundManager() { gotFocus: smc + 'Got window focus.', setup: sm + '.setup(): allowed parameters: %s', setupError: sm + '.setup(): "%s" cannot be assigned with this method.', - setupUndef: sm + '.setup(): Unknown option "%s"', + setupUndef: sm + '.setup(): Ignoring unknown option "%s"', setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', sm2Loaded: 'SoundManager 2: Ready. ' + String.fromCharCode(10003), reset: sm + '.reset(): Removing event callbacks', From eb7e46de07692647f9312e09549be39fb423e4e0 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 37/59] Single `if`. Drop redundant `return`. --- script/soundmanager2.js | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 31b36a52..fda88cf2 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -2695,17 +2695,10 @@ function SoundManager() { s._processOnPosition(); - if (s.playState === 1) { - - if (instanceOptions.whileplaying) { - // flash may call after actual finish - instanceOptions.whileplaying.apply(s); - } - + if (s.playState === 1 && instanceOptions.whileplaying) { + instanceOptions.whileplaying.apply(s); } - return true; - }; // From 63748c2aea92ccb3660b8cda7f6c4996c893bfdd Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 38/59] Flash 9/movieStar + RTMP-only `_onfailure` method. No longer used. --- script/soundmanager2.js | 20 +------------------- 1 file changed, 1 insertion(+), 19 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index fda88cf2..5ec6e12d 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -2606,25 +2606,7 @@ function SoundManager() { return true; }; - - /** - * flash 9/movieStar + RTMP-only method, should fire only once at most - * at this point we just recreate failed sounds rather than trying to reconnect - */ - - this._onfailure = function(msg, level, code) { - - s.failures++; - sm2._wD(s.id + ': Failure (' + s.failures + '): ' + msg); - - if (s._iO.onfailure && s.failures === 1) { - s._iO.onfailure(msg, level, code); - } else { - sm2._wD(s.id + ': Ignoring failure'); - } - - }; - + this._onfinish = function() { // store local copy before it gets trashed... From 5dfb63ed46ed49b5b919415c43af258f94ba8f44 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 39/59] Combine legacy flash-only properties at end: `eqData`, `peakData`, `waveformData`, `id3`. --- script/soundmanager2.js | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 5ec6e12d..c8bf8c7f 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -2256,7 +2256,11 @@ function SoundManager() { s.muted = false; s.paused = false; + s.playState = 0; + s.position = null; + // legacy Flash bits: eqData, peakData, waveformData, id3 + // these are not used in the HTML5-only version, but are retained for backward compatibility. s.eqData = []; s.eqData.left = []; s.eqData.right = []; @@ -2271,9 +2275,6 @@ function SoundManager() { right: [] }; - s.playState = 0; - s.position = null; - s.id3 = {}; }; From ba1e6a805902db4500f891d52e75cac1a1d56352 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 40/59] Internal `_onload()`: Flash 8 used to fire with 0/false-y duration when loading from cache. That is no longer a concern. ;) --- script/soundmanager2.js | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index c8bf8c7f..5c2558a8 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -2542,11 +2542,10 @@ function SoundManager() { * ------------------------------ */ - this._onload = function(nSuccess) { + this._onload = function(ok) { var fN, - // check for duration to prevent false positives from flash 8 when loading from cache. - loadOK = !!nSuccess; + loadOK = !!ok; // fN = s.id + ': '; From abe8421557bd69ea17b1606162a8ebe95976a447 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 41/59] Complain, disable and exit if no HTML5 support. Silent param option for `soundManager.disable()` to prevent additional log. --- script/soundmanager2.js | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 5c2558a8..c366b174 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -833,7 +833,7 @@ function SoundManager() { * Undocumented: NOPs soundManager and all SMSound objects. */ - this.disable = function() { + this.disable = function(silent) { // destroy all functions var i; @@ -843,7 +843,7 @@ function SoundManager() { disabled = true; - _wDS('shutdown', 1); + if (!silent) _wDS('shutdown', 1); for (i = sm2.soundIDs.length - 1; i >= 0; i--) { disableObject(sm2.sounds[sm2.soundIDs[i]]); @@ -1147,7 +1147,7 @@ function SoundManager() { this.destruct = function() { sm2._wD(sm + '.destruct()'); - sm2.disable(true); + sm2.disable(); }; @@ -3878,7 +3878,11 @@ function SoundManager() { var item, tests = []; - if (!sm2.hasHTML5) return false; + if (!sm2.hasHTML5) { + complain('SoundManager 2: No HTML5 audio support detected. :( Disabling API.'); + sm2.disable(true); + return false; + } for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { From 89df681c097737734debb86444aa72c143228a4d Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 42/59] More comment tweaks. --- script/soundmanager2.js | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index c366b174..803ecaa3 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -144,6 +144,8 @@ function SoundManager() { }; + // a quick way to enable SM2's debug mode, more logging. + this.debugURLParam = /([#?&])debug=1/i; // dynamic attributes @@ -175,7 +177,7 @@ function SoundManager() { */ this.html5 = { - usingFlash: false // legacy: set if/when flash fallback is needed + usingFlash: false // legacy: indicated if/when flash fallback was active, e.g., for MP3 support. }; /** @@ -234,7 +236,7 @@ function SoundManager() { * Configures top-level soundManager properties. * * @param {object} options Option parameters, eg. soundManager.setup({debugMode: true, ignoreMobileRestrictions: true}); - * onready and ontimeout are also accepted parameters. call soundManager.setup() to see the full list. + * `onready` and `ontimeout` are also accepted parameters. call soundManager.setup() to see the full list. */ this.setup = function(options) { @@ -679,6 +681,8 @@ function SoundManager() { /** * Calls the setPan() method of a SMSound object by ID. + * Note: This was originally a flash-only method. Native HTML5 Audio() does not implement panning. + * Web Audio API supports panning, but is not implemented in SM2 (that's another whole can of worms.) * * @param {string} sID The ID of the sound * @param {number} nPan The pan value (-100 to 100) @@ -704,10 +708,10 @@ function SoundManager() { this.setVolume = function(sID, nVol) { - // setVolume(50) function overloading case - apply to all sounds - var i, j; + // setVolume(50) function overloading case - apply to all sounds + if (sID !== _undefined && !isNaN(sID) && nVol === _undefined) { for (i = 0, j = sm2.soundIDs.length; i < j; i++) { sm2.sounds[sm2.soundIDs[i]].setVolume(sID); From 120781b1f5e28f5a5736de68cba745245974e37c Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 43/59] `soundManager.mute()`: Drop invalid check. Should have been `typeof sID !== 'string'` - better: compare vs `undefined` and then mute all sounds. --- script/soundmanager2.js | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 803ecaa3..383096ff 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -737,11 +737,7 @@ function SoundManager() { var i = 0; - if (sID instanceof String) { - sID = null; - } - - if (!sID) { + if (sID === _undefined) { sm2._wD(sm + '.mute(): Muting all sounds'); for (i = sm2.soundIDs.length - 1; i >= 0; i--) { From e664f465ea90519306617c03b008ff7e339d867d Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:34 -0800 Subject: [PATCH 44/59] Fix up formatting for unsupported case. --- script/soundmanager2.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 383096ff..8edd8b19 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3886,7 +3886,7 @@ function SoundManager() { for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { - tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? ' (' + (sm2.audioFormats[item].required ? 'required, ' : '') : ''))); + tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? (sm2.audioFormats[item].required ? ' (required) ' : '') : ''))); } } From 15020f7f6040a9651d06d4727a20a0703666c63b Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 45/59] Note about MIME type and `Audio().canPlayType()`. --- script/soundmanager2.js | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 8edd8b19..28afbad7 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -66,7 +66,7 @@ function SoundManager() { html5PollingInterval: null, // msec affecting whileplaying() for HTML5 audio, excluding mobile devices. If null, native HTML5 update events are used. 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. + html5Test: /^(probably|maybe)$/i, // HTML5 Audio().canPlayType() format support test. Use /^probably$/i; if you want to be more conservative. idPrefix: 'sound' // if an id is not provided to createSound(), this prefix is used for generated IDs - 'sound0', 'sound1' etc. }; @@ -107,8 +107,10 @@ function SoundManager() { this.audioFormats = { /** - * determines HTML5 support. - * if no support for a "required" format, SM2 will fail to start. + * known popular file types, and associated MIME type strings for HTML5 support. + * the MIME is a form of file type and optional codec descriptor. + * variants are provided in the hope of a "probably" from `Audio().canPlayType()`. + * this is the API which checks the OS for codec support. "probably" is the best-case scenario. :D */ mp3: { From 24241be2d4090e654917048fc2d35be2c6bd0427 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 46/59] Drop legacy definitions from `features`: `buffering`, `peakData`, `waveformData`, `eqData` and `movieStar`. Any legacy code will get undefined, false-y values. --- script/soundmanager2.js | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 28afbad7..adfd7765 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -162,14 +162,9 @@ function SoundManager() { this.filePattern = new RegExp(''); // legacy // support indicators, set at init (mostly legacy flash backcompat stuff) - - this.features = { - buffering: false, - peakData: false, - waveformData: false, - eqData: false, - movieStar: false - }; + // previously: `buffering`, `peakData`, `waveformData`, `eqData`, `movieStar` + // any checks from legacy code will now return undefined, false-y. + this.features = {}; /** * format support From 5d79d893e38bad70fe44b8137cdb00551b551263 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 47/59] Drop `usingFlash` from `html5`. No longer used, safe to return undefined / false-y. --- script/soundmanager2.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index adfd7765..b73cdb99 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -174,7 +174,8 @@ function SoundManager() { */ this.html5 = { - usingFlash: false // legacy: indicated if/when flash fallback was active, e.g., for MP3 support. + // legacy: indicated if/when flash fallback was active, e.g., for MP3 support. + // usingFlash: false }; /** From 396622ac80c992503206ddb95208f9519a4100f2 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 48/59] Drop special -nodebug markers around the reboot bit. Call `beginDelayedInit()` to restart now. --- script/soundmanager2.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index b73cdb99..ec3dd21e 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -1104,11 +1104,10 @@ function SoundManager() { on_queue = []; } - // if (!excludeInit) { sm2._wD(sm + ': Rebooting...'); + sm2.beginDelayedInit(); } - // return sm2; From 88056b8144c046f648f9c72c513acf984f95ec9f Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 49/59] Simplify init to one modern `onDOMContentLoaded` listener. Nicer HTML5 support output. --- script/soundmanager2.js | 115 ++++++++++++++-------------------------- 1 file changed, 39 insertions(+), 76 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index ec3dd21e..bed96b54 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -183,8 +183,8 @@ function SoundManager() { */ var SMSound, - sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doc = document, doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, setVersionInfo, strings, domContentLoaded, winOnLoad, didDCLoaded, catchError, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], - html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, domContentLoadedIE, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, + sm2 = this, globalHTML5Audio = null, sm = 'soundManager', smc = sm + ': ', h5 = 'HTML5::', ua = navigator.userAgent, wl = window.location.href.toString(), doNothing, setProperties, init, on_queue = [], debugTS, didInit = false, disabled = false, _wDS, initComplete, mixin, assign, extraOptions, addOnEvent, processOnEvents, setVersionInfo, strings, debugLevels = ['log', 'info', 'warn', 'error'], disableObject, str, complain, idCheck, startTimer, stopTimer, timerExecute, h5TimerCount = 0, h5IntervalTimer = null, parseURL, messages = [], + html5OK, html5CanPlay, html5ErrorCodes, html5Ext, html5Unload, testHTML5, event, slice = Array.prototype.slice, useGlobalHTML5Audio = false, lastGlobalHTML5URL, html5_events, idCounter = 0, didSetup, msecScale = 1000, is_iDevice = ua.match(/(ipad|iphone|ipod)/i), isAndroid = ua.match(/android/i), isSafari = (ua.match(/safari/i) && !ua.match(/chrome/i)), isOpera = (ua.match(/opera/i)), @@ -1082,7 +1082,7 @@ function SoundManager() { sm2.sounds[sm2.soundIDs[i]].destruct(); } - sm2.enabled = didDCLoaded = didInit = disabled = useGlobalHTML5Audio = false; + sm2.enabled = didInit = disabled = useGlobalHTML5Audio = false; sm2.soundIDs = []; sm2.sounds = {}; @@ -1133,7 +1133,7 @@ function SoundManager() { this.beginDelayedInit = function() { - domContentLoaded(); + init(); }; @@ -3480,6 +3480,8 @@ function SoundManager() { mobileUA: 'Mobile UA detected, preferring HTML5 by default.', globalHTML5: 'Using singleton HTML5 Audio() pattern for this device.', ignoreMobile: 'Ignoring mobile restrictions for this device.' + support: '🔊SoundManager 2 HTML5 support:', + noSupport: 'SoundManager 2: No HTML5 audio support detected. :( Disabling API.' // }; @@ -3861,39 +3863,61 @@ function SoundManager() { }; - init = function() { // called after onload() + // do this work only once. if (didInit) { _wDS('didInit'); return false; } + // allow force of debug mode via URL // + if (sm2.debugURLParam.test(wl)) { + sm2.setupOptions.debugMode = sm2.debugMode = true; + } + // + + // assign top-level soundManager properties eg. soundManager.url + setProperties(); + + testHTML5(); - var item, tests = []; + // 100% HTML5 mode + setVersionInfo(); if (!sm2.hasHTML5) { - complain('SoundManager 2: No HTML5 audio support detected. :( Disabling API.'); + complain(strings.noSupport); sm2.disable(true); return false; } + // + + var item, formats = [], tests = [], allOK = true; + for (item in sm2.audioFormats) { if (sm2.audioFormats.hasOwnProperty(item)) { - tests.push(item + (sm2.html5[item] ? ' ✓' : ' ✗') + ((!sm2.html5[item] ? (sm2.audioFormats[item].required ? ' (required) ' : '') : ''))); + if (!sm2.html5[item]) { + allOK = false; + } + formats.push(item); + tests.push(item + (sm2.html5[item] ? ' ✅' : ' ⛔️')); } } - sm2._wD('SoundManager 2 HTML5 support: ' + tests.join(' '), 1); + if (allOK) { + sm2._wD(strings.support + ' ' + formats.join(', ') + ' 💯👌', 1); + } else { + complain(strings.support + ' ' + tests.join(' · ') + ' - likely browser/OS limitation. 😒', 1); + } // if (!didInit) { // we don't need no steenking flash! - event.remove(window, 'load', sm2.beginDelayedInit); sm2.enabled = true; initComplete(); } @@ -3902,75 +3926,14 @@ function SoundManager() { }; - domContentLoaded = function() { - - if (didDCLoaded) return; - - didDCLoaded = true; - - // allow force of debug mode via URL - // - if (sm2.debugURLParam.test(wl)) { - sm2.setupOptions.debugMode = sm2.debugMode = true; - } - // - - // assign top-level soundManager properties eg. soundManager.url - setProperties(); - - testHTML5(); - - if (doc.removeEventListener) { - doc.removeEventListener('DOMContentLoaded', domContentLoaded, false); - } - - // 100% HTML5 mode - setVersionInfo(); + function domContentLoaded() { + event.remove(document, 'DOMContentLoaded', init); init(); - - }; - - domContentLoadedIE = function() { - - if (doc.readyState === 'complete') { - domContentLoaded(); - doc.detachEvent('onreadystatechange', domContentLoadedIE); - } - - return true; - - }; - - winOnLoad = function() { - - // catch case where DOMContentLoaded has been sent, but we're still in doc.readyState = 'interactive' - domContentLoaded(); - - event.remove(window, 'load', winOnLoad); - - }; - - event.add(window, 'load', winOnLoad); - - if (doc.addEventListener) { - - doc.addEventListener('DOMContentLoaded', domContentLoaded, false); - - } else if (doc.attachEvent) { - - doc.attachEvent('onreadystatechange', domContentLoadedIE); - - } else { - - // no add/attachevent support; perhaps a browser from the stone age (IE 5, Netscape 4.7 etc.) - debugTS('onload', false); - catchError({ - type: 'NO_DOM2_EVENTS', - fatal: true - }); - } + // wait for DOMContentLoaded to start. + event.add(document, 'DOMContentLoaded', domContentLoaded); + } // SoundManager() soundManager = new SoundManager(); From defa4d0e1e7decceb40566a17c4f4210c638ad3d Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 50/59] Drop `required` on HTML5 formats. SM2 no longer needs to "require" Flash (historically, for MP3 support.) --- script/soundmanager2.js | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index bed96b54..273aaac8 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -114,34 +114,28 @@ function SoundManager() { */ mp3: { - type: ['audio/mpeg; codecs="mp3"', 'audio/mpeg', 'audio/mp3', 'audio/MPA', 'audio/mpa-robust'], - required: true + type: ['audio/mpeg; codecs="mp3"', 'audio/mpeg', 'audio/mp3', 'audio/MPA', 'audio/mpa-robust'] }, mp4: { related: ['aac', 'm4a', 'm4b'], // additional formats under the MP4 container - type: ['audio/mp4; codecs="mp4a.40.2"', 'audio/aac', 'audio/x-m4a', 'audio/MP4A-LATM', 'audio/mpeg4-generic'], - required: false + type: ['audio/mp4; codecs="mp4a.40.2"', 'audio/aac', 'audio/x-m4a', 'audio/MP4A-LATM', 'audio/mpeg4-generic'] }, ogg: { - type: ['audio/ogg; codecs=vorbis'], - required: false + type: ['audio/ogg; codecs=vorbis'] }, opus: { - type: ['audio/ogg; codecs=opus', 'audio/opus'], - required: false + type: ['audio/ogg; codecs=opus', 'audio/opus'] }, wav: { - type: ['audio/wav; codecs="1"', 'audio/wav', 'audio/wave', 'audio/x-wav'], - required: false + type: ['audio/wav; codecs="1"', 'audio/wav', 'audio/wave', 'audio/x-wav'] }, flac: { - type: ['audio/flac'], - required: false + type: ['audio/flac'] } }; From ca0b325d105c6d1ff773a56e405176f0deb36f34 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:35 -0800 Subject: [PATCH 51/59] Sounds are now always HTML5, no need to check. --- script/soundmanager2.js | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 273aaac8..dbe79706 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -1177,9 +1177,6 @@ function SoundManager() { // assign property defaults this.volume = this.options.volume; - // whether or not this object is using HTML5 - this.isHTML5 = false; - // internal HTML5 Audio() object reference this._a = null; @@ -1508,7 +1505,7 @@ function SoundManager() { }; // HTML5 needs to at least have "canplay" fired before seeking. - if (s.isHTML5 && !s._html5_canplay) { + if (!s._html5_canplay) { // this hasn't been loaded yet. load it first, and then do this again. sm2._wD(fN + 'Beginning load for non-zero offset case'); @@ -2457,8 +2454,6 @@ function SoundManager() { } - s.isHTML5 = true; - // store a ref on the track s._a = a; @@ -3773,7 +3768,7 @@ function SoundManager() { for (i = sm2.soundIDs.length - 1; i >= 0; i--) { - if (sm2.sounds[sm2.soundIDs[i]].isHTML5 && sm2.sounds[sm2.soundIDs[i]]._hasTimer) { + if (sm2.sounds[sm2.soundIDs[i]]._hasTimer) { sm2.sounds[sm2.soundIDs[i]]._onTimer(); } From 74f3f29423d6ae4017642b2db15f0c009a05a4ca Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:36 -0800 Subject: [PATCH 52/59] Comment / spacing clean-up. Report undefined / disallowed `setup()` params in one line per call. --- script/soundmanager2.js | 77 ++++++++++++++++++++++------------------- 1 file changed, 41 insertions(+), 36 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index dbe79706..7ba1a8a2 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -1194,7 +1194,7 @@ function SoundManager() { this._debug = function() { // - sm2._wD(s.id + ': Merged options:', s.options); + sm2._wD(s.id + ' options:', s.options); // }; @@ -2569,7 +2569,7 @@ function SoundManager() { s.isBuffering = (nIsBuffering === 1); if (s._iO.onbufferchange) { - sm2._wD(s.id + ': Buffer state change: ' + nIsBuffering); + sm2._wD(s.id + ': isBuffering = ' + !!nIsBuffering); s._iO.onbufferchange.apply(s, [nIsBuffering]); } @@ -2592,7 +2592,7 @@ function SoundManager() { return true; }; - + this._onfinish = function() { // store local copy before it gets trashed... @@ -2773,6 +2773,13 @@ function SoundManager() { // + var issues = { + setupUndef: [], + setupError: [] + }; + + var txt; + for (i in o) { if (o.hasOwnProperty(i)) { @@ -2798,8 +2805,8 @@ function SoundManager() { } else if (bonusOptions[i] === _undefined) { - // invalid, legacy (flash-era) or disallowed parameter. complain. - complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); + // invalid, legacy (flash-era) or disallowed parameter. note for later. + issues[(sm2[i] === _undefined ? 'setupUndef' : 'setupError')].push(i); result = false; @@ -2824,7 +2831,7 @@ function SoundManager() { // recursion case, eg., { defaultOptions: { ... } } // invalid or disallowed parameter. complain. - complain(str((sm2[i] === _undefined ? 'setupUndef' : 'setupError'), i), 2); + issues[(sm2[i] === _undefined ? 'setupUndef' : 'setupError')].push(i); result = false; @@ -2839,6 +2846,28 @@ function SoundManager() { } + // + + function maybePlural(string, arr) { + if (string === _undefined || arr.length < 2) return string; + var base = 'unknown option'; + return string.replace(base, base + 's'); + } + + if (issues.setupUndef.length) { + txt = str('setupUndef', issues.setupUndef.join(', ')); + txt = maybePlural(txt, issues.setupUndef); + complain(txt, 2); + } + + if (issues.setupError.length) { + txt = str('setupError', issues.setupError.join(', ')); + txt = maybePlural(txt, issues.setupError); + complain(txt, 2); + } + + // + return result; }; @@ -3029,7 +3058,7 @@ function SoundManager() { var s = this._s; if (!s) return; - sm2._wD(s.id + ': ended'); + sm2._wD(s.id + ': ended □'); s._onfinish(); @@ -3080,7 +3109,7 @@ function SoundManager() { playing: html5_event(function() { if (!this._s) return; - sm2._wD(this._s.id + ': playing ' + String.fromCharCode(9835)); + sm2._wD(this._s.id + ': playing ♫'); // once play starts, no buffering this._s._onbufferchange(0); @@ -3450,8 +3479,6 @@ function SoundManager() { needFunction: smc + 'Function object expected for %s', badID: 'Sound ID "%s" should be a string, starting with a non-numeric character', currentObj: smc + '_debug(): Current sound objects', - waitOnload: smc + 'Waiting for window.onload()', - docLoaded: smc + 'Document already loaded', onload: smc + 'initComplete(): calling soundManager.onload()', onloadOK: sm + '.onload() complete', didInit: smc + 'init(): Already called?', @@ -3459,16 +3486,12 @@ function SoundManager() { queue: smc + 'Queueing %s handler', manURL: 'SMSound.load(): Using manually-assigned URL', onURL: sm + '.load(): current URL already assigned.', - gotFocus: smc + 'Got window focus.', setup: sm + '.setup(): allowed parameters: %s', - setupError: sm + '.setup(): "%s" cannot be assigned with this method.', + setupError: sm + '.setup(): Option "%s" cannot be assigned with this method.', setupUndef: sm + '.setup(): Ignoring unknown option "%s"', - setupLate: sm + '.setup(): html5Test property changes will not take effect until reboot().', - 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.', - ignoreMobile: 'Ignoring mobile restrictions for this device.' + ignoreMobile: 'Ignoring mobile restrictions for this device.', support: '🔊SoundManager 2 HTML5 support:', noSupport: 'SoundManager 2: No HTML5 audio support detected. :( Disabling API.' // @@ -3491,7 +3514,7 @@ function SoundManager() { // first argument o = args.shift(); - sstr = (strings && strings[o] ? strings[o] : ''); + sstr = ((strings && strings[o]) || ''); if (sstr && args && args.length) { for (i = 0, j = args.length; i < j; i++) { @@ -3694,7 +3717,6 @@ function SoundManager() { }; - startTimer = function(oSound) { /** @@ -3776,22 +3798,6 @@ function SoundManager() { }; - catchError = function(options) { - - options = (options !== _undefined ? options : {}); - - if (typeof sm2.onerror === 'function') { - sm2.onerror.apply(window, [{ - type: (options.type !== _undefined ? options.type : null) - }]); - } - - if (options.fatal !== _undefined && options.fatal) { - sm2.disable(); - } - - }; - /** * Private initialization helpers * ------------------------------ @@ -3802,12 +3808,11 @@ function SoundManager() { if (didInit) return false; // all good. - _wDS('sm2Loaded', 1); didInit = true; processOnEvents(); - // call user-defined "onload", scoped to window + // legacy, direct-assignment method: call user-defined "onload", scoped to window if (typeof sm2.onload === 'function') { _wDS('onload', 1); sm2.onload.apply(window); From e13d00f7ddef2f8c2380f40fb7d42b3556e34d36 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:36 -0800 Subject: [PATCH 53/59] `_get_html5_duration()`: If no `Audio().duration`, use existing SM2 object `duration` if specified. --- script/soundmanager2.js | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 7ba1a8a2..3426db87 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -2328,9 +2328,8 @@ function SoundManager() { this._get_html5_duration = function() { - 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)), + // if audio object exists, use its duration - else, use current duration on object if known. + var d = (s._a && s._a.duration ? s._a.duration * msecScale : s.duration || null), result = (d && !isNaN(d) && d !== Infinity ? d : null); return result; From 8286fb3ed8dda5bba919e4ae1b03ac1f7bd2df4c Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 12:08:36 -0800 Subject: [PATCH 54/59] Allow `loadeddata` to trigger duration check for all, stop excluding Safari. --- script/soundmanager2.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 3426db87..9d12dc07 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3081,8 +3081,7 @@ function SoundManager() { sm2._wD(s.id + ': loadeddata'); - // safari seems to nicely report progress events, eventually totalling 100% - if (!s._loaded && !isSafari) { + if (!s._loaded) { s.duration = s._get_html5_duration(); } From c25d997c1f6c183dfa169ca791bb50998145e5fe Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 13:33:36 -0800 Subject: [PATCH 55/59] Post-dev-branch-merge tweaks. --- script/soundmanager2.js | 9 --------- 1 file changed, 9 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index b41487e9..a6ee73a2 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3091,13 +3091,6 @@ function SoundManager() { }), - loadedmetadata: html5_event(function() { - - if (!this._s) return; - sm2._wD(this._s.id + ': loadedmetadata'); - - }), - loadstart: html5_event(function() { var s = this._s; @@ -3229,8 +3222,6 @@ function SoundManager() { var s = this._s; if (!s) return; - if (!s) return; - // see also: seeking sm2._wD(this._s.id + ': waiting'); From 4ae835a567f62feec9cb7ebf2e902ad92f379cc9 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 14:05:24 -0800 Subject: [PATCH 56/59] Explain `title` sound option a bit. --- script/soundmanager2.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index a6ee73a2..9368acfa 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -98,7 +98,7 @@ function SoundManager() { position: null, // offset (milliseconds) to seek to within loaded sound data. playbackRate: 1, // rate at which to play the sound stream: true, // allows playing before entire file has loaded (recommended) - title: '', // wordings shown in iOS lock screen + title: '', // shown on iOS lock screen, perhaps others to: null, // position to end playback within a sound (msec), default = end type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 volume: 100 // self-explanatory. 0-100, the latter being the max. @@ -2441,7 +2441,7 @@ function SoundManager() { } - // set the title of the audio + // Audio() title is reflected in the lock screen on iOS, maybe others. s._a.title = instanceOptions.title; // assign local reference From b717e1f7c9578b9d434b75d8ce5e3d6ab47b1cd9 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 14:06:06 -0800 Subject: [PATCH 57/59] HTML5 `pause` event. Close #222 (and thanks for the PR! :bow:) --- script/soundmanager2.js | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 9368acfa..ee3ce475 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3101,6 +3101,18 @@ function SoundManager() { }), + pause: html5_event(function() { + + var s = this._s; + if (!s) return; + sm2._wD(this._s.id + ': HTML5 pause'); + // a device may forcefully pause this sound, e.g., device sleep or playing audio elsewhere. + // update SM2 state and fire events accordingly. + // if paused by user interaction, this should cause no ill effect. + s.pause(); + + }), + play: html5_event(function() { if (!this._s) return; From 4a405998053a102d961997ed17252b9748eea2be Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 14:24:53 -0800 Subject: [PATCH 58/59] Consistent OK/checkmark emoji. --- script/soundmanager2.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index ee3ce475..508abd8d 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -3061,7 +3061,7 @@ function SoundManager() { var s = this._s; if (!s) return; - sm2._wD(s.id + ': ended □'); + sm2._wD(s.id + ': ended'); s._onfinish(); @@ -3915,7 +3915,7 @@ function SoundManager() { } if (allOK) { - sm2._wD(strings.support + ' ' + formats.join(', ') + ' 💯👌', 1); + sm2._wD(strings.support + ' ' + formats.join(', ') + ' 💯✅', 1); } else { complain(strings.support + ' ' + tests.join(' · ') + ' - likely browser/OS limitation. 😒', 1); } From cf9896a4dc17055f232578dd54586704badba665 Mon Sep 17 00:00:00 2001 From: Scott Schiller Date: Fri, 23 Nov 2018 14:26:31 -0800 Subject: [PATCH 59/59] Warn about `autoPlay`. Drop legacy `stream` + `serverURL` (Flash-era) stuff. --- script/soundmanager2.js | 15 ++------------- 1 file changed, 2 insertions(+), 13 deletions(-) diff --git a/script/soundmanager2.js b/script/soundmanager2.js index 508abd8d..df8bf1eb 100644 --- a/script/soundmanager2.js +++ b/script/soundmanager2.js @@ -79,7 +79,7 @@ function SoundManager() { */ autoLoad: false, // enable automatic loading (otherwise .load() will be called on demand with .play(), the latter being nicer on bandwidth - if you want to .load yourself, you also can) - autoPlay: false, // enable playing of file as soon as possible (much faster if "stream" is true) + autoPlay: false, // WARNING: legacy, don't use. Blocked by modern OSes and mobile devices. Here be dragons. from: null, // position to start playback within a sound (msec), default = beginning loops: 1, // how many times to repeat the sound (position will wrap around to 0, setPosition() will break out of loop when >0) onid3: null, // callback function for "ID3 data is added/available" @@ -97,7 +97,6 @@ function SoundManager() { multiShotEvents: false, // fire multiple sound events (currently onfinish() only) when multiShot is enabled position: null, // offset (milliseconds) to seek to within loaded sound data. playbackRate: 1, // rate at which to play the sound - stream: true, // allows playing before entire file has loaded (recommended) title: '', // shown on iOS lock screen, perhaps others to: null, // position to end playback within a sound (msec), default = end type: null, // MIME-like hint for file pattern / canPlay() tests, eg. audio/mp3 @@ -1472,18 +1471,8 @@ function SoundManager() { } - /** - * Streams will pause when their buffer is full if they are being loaded. - * In this case paused is true, but the song hasn't started playing yet. - * If we just call resume() the onplay() callback will never be called. - * So only call resume() if the position is > 0. - * Another reason is because options like volume won't have been applied yet. - * For normal sounds, just resume. - */ - - if (s.paused && s.position >= 0 && (!s._iO.serverURL || s.position > 0)) { + if (s.paused && s.position >= 0) { - // https://gist.github.com/37b17df75cc4d7a90bf6 sm2._wD(fN + 'Resuming from paused state', 1); s.resume();