Updates to VERSIONS, docs, and libs

Author: lannymcnie

README.md

@@ -2,8 +2,9 @@
 
 SoundJS is a library to make working with audio on the web easier. It provides a consistent API for playing audio in
 different browsers, including using a target plugin model to provide an easy way to provide additional audio plugins
-like a Flash fallback. A mechanism has been provided for easily tying in audio preloading to
-[PreloadJS](http://createjs.com/preloadjs/).
+like a Flash fallback (included, but must be used separately from the combined/minified version).
+
+A mechanism has been provided for easily tying in audio preloading to [PreloadJS](http://createjs.com/preloadjs/).
 
 
 ## Example

VERSIONS.txt

@@ -1,12 +1,18 @@
 Version NEXT [Not yet released]
 ****************************************************************************************************
-* Changed XHR error conditions to only include 400-599. Specifically removed status=0 as an error,
+CRITICAL
+- removed deprecated properties, particularly getValue/setValue properties, in favour of .value
+	this particularly affects instance and global properties like mute, volume, pan, etc.
+
+OTHER
+* changed XHR error conditions to only include 400-599. Specifically removed status=0 as an error,
   	which affects compiled applications.
-* Fixed issue where values don't get appended to GET requests in XHRRequest
-* Added "touchstart" as an audio unlocking event, which seems to be the best for iOS
-* Checked if preload candidates are videos, since SoundJS mistakenly handles these when they are mp4.
-* Added missing Methods and Types classes from recent PreloadJS changes
-* Handled case where audio duration returned < 0, resulting in a DOM Error
+* fixed issue where values don't get appended to GET requests in XHRRequest
+* added "touchstart" as an audio unlocking event, which seems to be the best for iOS
+* checked if preload candidates are videos, since SoundJS mistakenly handles these when they are mp4.
+* added missing Methods and Types classes from recent PreloadJS changes
+* handled case where audio duration returned < 0, resulting in a DOM Error
+* fixed issue where new instances wouldn't get the global mute/volume (thanks @PythonFanboy)
 
 
 Version 0.6.2 [November 26, 2015]

docs/soundjs_docs-NEXT.zip

@@ -446,7 +446,7 @@ this.createjs = this.createjs || {};
 
 	/**
 	 * The capabilities of the plugin. This is generated via the {{#crossLink "CordovaAudioPlugin/_generateCapabilities"}}{{/crossLink}}
-	 * method. Please see the Sound {{#crossLink "Sound/getCapabilities"}}{{/crossLink}} method for an overview of all
+	 * method. Please see the Sound {{#crossLink "Sound/capabilities:property"}}{{/crossLink}} method for an overview of all
 	 * of the available properties.
 	 * @property _capabilities
 	 * @type {Object}
@@ -470,7 +470,7 @@ this.createjs = this.createjs || {};
 	};
 
 	/**
-	 * Determine the capabilities of the plugin. Used internally. Please see the Sound API {{#crossLink "Sound/getCapabilities"}}{{/crossLink}}
+	 * Determine the capabilities of the plugin. Used internally. Please see the Sound API {{#crossLink "Sound/capabilities:property"}}{{/crossLink}}
 	 * method for an overview of plugin capabilities.
 	 * @method _generateCapabilities
 	 * @static
@@ -566,6 +566,6 @@ this.createjs = this.createjs || {};
 	 * @type String
 	 * @static
 	 **/
-	s.buildDate = /*=date*/"Mon, 12 Dec 2016 17:03:54 GMT"; // injected by build process
+	s.buildDate = /*=date*/"Thu, 08 Jun 2017 21:05:43 GMT"; // injected by build process
 
 })();

lib/cordovaaudioplugin-NEXT.combined.js

@@ -844,10 +844,6 @@ this.createjs = this.createjs || {};
 	}
 	var p = createjs.extend(Loader, createjs.AbstractLoader);
 
-	// TODO: deprecated
-	// p.initialize = function() {}; // searchable for devs wondering where it is. REMOVED. See docs for details.
-
-
 // Static Properties
 	var s = Loader;
 	/**
@@ -979,10 +975,6 @@ this.createjs = this.createjs || {};
 	};
 	var p = createjs.extend(FlashAudioSoundInstance, createjs.AbstractSoundInstance);
 
-	// TODO: deprecated
-	// p.initialize = function() {}; // searchable for devs wondering where it is. REMOVED. See docs for details.
-
-
 // Static Propeties
 	var s = FlashAudioSoundInstance;
 	/**
@@ -1060,13 +1052,13 @@ this.createjs = this.createjs || {};
 	p._beginPlaying = function (playProps) {
 		if (s._flash == null) { return false; }
 
-		this.setPosition(playProps.offset);
-		this.setLoop(playProps.loop);
-		this.setVolume(playProps.volume);
-		this.setPan(playProps.pan);
+		this.position = playProps.offset;
+		this.loop = playProps.loop;
+		this.volume = playProps.volume;
+		this.pan = playProps.pan;
 		if (playProps.startTime != null) {
-			this.setStartTime(playProps.startTime);
-			this.setDuration(playProps.duration);
+			this.startTime = playProps.startTime;
+			this.duration = playProps.duration;
 		}
 		this._paused = false;
 
@@ -1287,10 +1279,6 @@ this.createjs = this.createjs || {};
 	var p = createjs.extend(FlashAudioPlugin, createjs.AbstractPlugin);
 	var s = FlashAudioPlugin;
 
-	// TODO: deprecated
-	// p.initialize = function() {}; // searchable for devs wondering where it is. REMOVED. See docs for details.
-
-
 // Static properties
 	/**
 	 * Event constant for the "registerFlashID" event for cleaner code.
@@ -1314,7 +1302,7 @@ this.createjs = this.createjs || {};
 
 	/**
 	 * The capabilities of the plugin. This is generated via the {{#crossLink "WebAudioPlugin/_generateCapabilities"}}{{/crossLink}}
-	 * method. Please see the Sound {{#crossLink "Sound/getCapabilities"}}{{/crossLink}} method for a list of available
+	 * method. Please see the Sound {{#crossLink "Sound/capabilities:property"}}{{/crossLink}} method for a list of available
 	 * capabilities.
 	 * @property _capabilities
 	 * @type {Object}
@@ -1351,7 +1339,7 @@ this.createjs = this.createjs || {};
 	};
 
 	/**
-	 * Determine the capabilities of the plugin. Used internally. Please see the Sound API {{#crossLink "Sound/getCapabilities"}}{{/crossLink}}
+	 * Determine the capabilities of the plugin. Used internally. Please see the Sound API {{#crossLink "Sound/capabilities:property"}}{{/crossLink}}
 	 * method for an overview of plugin capabilities.
 	 * @method _generateCapabilities
 	 * @static
@@ -1599,6 +1587,6 @@ this.createjs = this.createjs || {};
 	 * @type String
 	 * @static
 	 **/
-	s.buildDate = /*=date*/"Mon, 14 Sep 2015 19:11:47 GMT"; // injected by build process
+	s.buildDate = /*=date*/"Thu, 08 Jun 2017 21:05:43 GMT"; // injected by build process
 
 })();