Dash-Industry-Forum · epiclabsDASH · Mar 5, 2018 · Aug 9, 2017 · Aug 9, 2017 · Sep 11, 2017
diff --git a/index.d.ts b/index.d.ts
@@ -49,7 +49,7 @@ declare namespace dashjs {
         codec: string | null;
         contentProtection: any | null;
     }
-    
+
     export interface MediaPlayerClass {
         initialize(view?: HTMLElement, source?: string, autoPlay?: boolean): void;
         on(type: AstInFutureEvent['type'], listener: (e: AstInFutureEvent) => void, scope?: object): void;
@@ -202,6 +202,7 @@ declare namespace dashjs {
         getJumpGaps(): boolean;
         setSmallGapLimit(value: number): void;
         getSmallGapLimit(): number;
+        preload(): void;
         reset(): void;
     }
 

diff --git a/samples/getting-started-basic-embed/pre-load-video.html b/samples/getting-started-basic-embed/pre-load-video.html
@@ -0,0 +1,62 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8" />
+    <title>Preload Video example</title>
+
+    <script src="../../dist/dash.all.debug.js"></script>
+    <!--dash.all.min.js should be used in production over dash.all.debug.js
+        Debug files are not compressed or obfuscated making the file size much larger compared with dash.all.min.js-->
+    <!--<script src="../../dist/dash.all.min.js"></script>-->
+
+    <script>
+        var video,
+            player;
+
+        function init() {
+            var url = "https://dash.akamaized.net/envivio/EnvivioDash3/manifest.mpd";
+
+            player = dashjs.MediaPlayer().create();
+            player.initialize(null, url, true);
+            player.preload();
+        }
+
+        function attachVideoPlayer() {
+            var videoContainer = document.getElementById('videoContainer');
+            if (!video) {
+                video = document.createElement('video');
+                video.controls = true;
+                videoContainer.appendChild(video);
+            }
+
+            player.attachView(video);
+        }
+    </script>
+
+    <style>
+        video {
+            width: 640px;
+            height: 360px;
+        }
+    </style>
+</head>
+
+<body>
+    <div>
+        This sample shows how to use preload feature of dash.js. In this sample, streaming is initialized and dash.js starts downloading stream segments as soon as the page is loaded. Right when the user clicks "Attach View" the video element is created,
+        attached to the already initialized dash.js MediaPlayer and then playback starts.
+    </div>
+    <div>
+        <button onclick="attachVideoPlayer()">Attach View</button>
+    </div>
+    <div id="videoContainer">
+    </div>
+    <script>
+        document.addEventListener("DOMContentLoaded", function () {
+            init();
+        });
+    </script>
+</body>
+
+</html>
diff --git a/samples/index.html b/samples/index.html
@@ -21,6 +21,7 @@
     <tr><td style="width:80px"></td><td><a href="getting-started-basic-embed/auto-load-single-video-with-reference.html">auto-load-single-video-with-reference.html</a> - this example shows how to auto-embed the player while still obtaining a reference to the MediaPlayer instance. This is useful for calling its public API, which the example illustrates by tracing out the players buffer length. </td></tr>
     <tr><td style="width:80px"></td><td><a href="getting-started-basic-embed/auto-load-multi-video.html">auto-load-multi-video.html</a> - this example shows how to auto-embed multiple instances of dash.js players in a page. To make it more difficult, one of the available video elements specifies a non-DASH source. </td></tr>
     <tr><td style="width:80px"></td><td><a href="getting-started-basic-embed/manual-load-single-video.html">manual-load-single-video.html</a> - for the fullest embed control, go back to basics. This example shows how to instantiate and initialize a dash.js player without using any of the Dash.create() methods. Consider this the baseline embed example. </td></tr>
+    <tr><td style="width:80px"></td><td><a href="getting-started-basic-embed/pre-load-video.html">pre-load-video.html</a> - this examples shows how to use preload feature of dash.js, which allows to initialize streaming and starts downloading the content before the player is attached to a video element</td></tr>
 
     <tr><td colspan="2">/live-streaming</td></tr>
     <tr><td style="width:80px"></td><td><a href="live-streaming/live-delay-comparison-custom-manifest.html">live-delay-comparison-custom-manifest.html</a> - example showing how to use the two MediaPlayer APIS which control live delay: setLiveDelay and setLiveDelayFragmentCount.</td></tr>

diff --git a/src/core/events/CoreEvents.js b/src/core/events/CoreEvents.js
@@ -63,7 +63,6 @@ class CoreEvents extends EventsBase {
         this.SEGMENTS_LOADED = 'segmentsLoaded';
         this.SERVICE_LOCATION_BLACKLIST_ADD = 'serviceLocationBlacklistAdd';
         this.SERVICE_LOCATION_BLACKLIST_CHANGED = 'serviceLocationBlacklistChanged';
-        this.SOURCEBUFFER_APPEND_COMPLETED = 'sourceBufferAppendCompleted';
         this.SOURCEBUFFER_REMOVE_COMPLETED = 'sourceBufferRemoveCompleted';
         this.STREAMS_COMPOSED = 'streamsComposed';
         this.STREAM_BUFFERING_COMPLETED = 'streamBufferingCompleted';

diff --git a/src/dash/DashHandler.js b/src/dash/DashHandler.js
@@ -348,6 +348,7 @@ function DashHandler(config) {
         request.index = segment.availabilityIdx;
         request.mediaInfo = streamProcessor.getMediaInfo();
         request.adaptationIndex = representation.adaptation.index;
+        request.representationId = representation.id;
 
         if (setRequestUrl(request, url, representation)) {
             return request;

diff --git a/src/streaming/FragmentSink.js b/src/streaming/FragmentSink.js
@@ -0,0 +1,59 @@
+/**
+ * The copyright in this software is being made available under the BSD License,
+ * included below. This software may be subject to other third party and contributor
+ * rights, including patent rights, and no such rights are granted under this license.
+ *
+ * Copyright (c) 2013, Dash Industry Forum.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *  * Redistributions of source code must retain the above copyright notice, this
+ *  list of conditions and the following disclaimer.
+ *  * Redistributions in binary form must reproduce the above copyright notice,
+ *  this list of conditions and the following disclaimer in the documentation and/or
+ *  other materials provided with the distribution.
+ *  * Neither the name of Dash Industry Forum nor the names of its
+ *  contributors may be used to endorse or promote products derived from this software
+ *  without specific prior written permission.
+ *
+ *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
+ *  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ *  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ *  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+ *  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ *  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ *  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ *  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ *  POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * The an end place to put fragments after they have been fetched.
+ * @interface FragmentSink
+ */
+/**
+ * Append a chunk to the internal buffer. You should assume that the effects of this are asynchronous.
+ * @function FragmentSink#append
+ * @param {Object} chunk A loaded chunk like that generated by the FragmentController
+ */
+/**
+ * Remove data from within the specified time ranges.
+ * @function FragmentSink#remove
+ * @param {?Number} start The beginning of the range that should be removed from the sink's internal buffer. If NaN, it is regarded as unbounded.
+ * @param {?Number} end The end of the range that should be removed from the sink's internal buffer. If NaN, it is regarded as unbounded.
+ */
+/**
+ * Abort an append operation currently ongoing.
+ * @function FragmentSink#abort
+ */
+/**
+ * @function FragmentSink#getAllBufferRanges
+ * @returns {Array} A TimeRanges-like object representing all the buffer ranges that are present in the sink.
+ */
+/**
+ * Remove all the data in the sink's internal buffer.
+ * @function FragmentSink#reset
+ */
+