feat(switchItemOnError): Add option to switch item on error

Author: FranklinWaller

README.md

@@ -83,3 +83,21 @@ meisterPlayer.setItem({
 
 meisterPlayer.load();
 ```
+
+### switchItemOnError *[Boolean]* (default: true) ###
+
+Goes to the next item in the 'sources' array when the current item has thrown an error. (NOT_FOUND, CODEC_ERRORS, etc) 
+This can be usefull for codecs that cannot be determined if it can play on the current device.
+Multisource will switch out the item with a new item so playback can continue.
+
+Example:
+
+``` JavaScript
+meisterPlayer.setItem({
+    sources: [ ... ],
+    type: 'multi-source',
+    switchItemOnError: false, // Will stop playback after an fatal error occured.
+});
+```
+
+

src/js/MultiSource.js

@@ -56,6 +56,11 @@ class MultiSource extends Meister.ParserPlugin {
     process(item) {
         this.currentItem = item;
 
+        // Set default config
+        if (typeof this.currentItem.switchItemOnError === 'undefined') {
+            this.currentItem.switchItemOnError = true;
+        }
+
         return new Promise((resolve, reject) => {
             const hasDRM = typeof item.drmConfig === 'object';
             item.sources = this.restructureItems(item.sources, hasDRM); // eslint-disable-line
@@ -68,7 +73,9 @@ class MultiSource extends Meister.ParserPlugin {
                         newItem.metadata = item.metadata; // eslint-disable-line
                     }
 
-                    this.on('playerError', this.onPlayerError.bind(this));
+                    if (this.currentItem.switchItemOnError) {
+                        this.on('playerError', this.onPlayerError.bind(this));
+                    }
 
                     resolve(newItem);
                 }