]> git.bitcoin.ninja Git - youtube-dl/commitdiff
[extractor/common] Introduce fragments interface
authorSergey M․ <dstftw@gmail.com>
Mon, 5 Sep 2016 18:18:57 +0000 (01:18 +0700)
committerSergey M․ <dstftw@gmail.com>
Sat, 17 Sep 2016 11:31:09 +0000 (18:31 +0700)
youtube_dl/extractor/common.py

index c0002345870a4490cd3d5904d148b3d272813f28..566ed7a4dbc1679918d858ed27d36479ffa1760a 100644 (file)
@@ -86,7 +86,9 @@ class InfoExtractor(object):
                     from worst to best quality.
 
                     Potential fields:
-                    * url        Mandatory. The URL of the video file
+                    * url        Mandatory. The URL of the video file or URL of
+                                 the manifest file in case of fragmented media
+                                 (DASH, hls, hds).
                     * ext        Will be calculated from URL if missing
                     * format     A human-readable description of the format
                                  ("mp4 container with h264/opus").
@@ -115,6 +117,11 @@ class InfoExtractor(object):
                                  download, lower-case.
                                  "http", "https", "rtsp", "rtmp", "rtmpe",
                                  "m3u8", "m3u8_native" or "http_dash_segments".
+                    * fragments  A list of fragments of the fragmented media,
+                                 with the following entries:
+                                 * "url" (mandatory) - fragment's URL
+                                 * "duration" (optional, int or float)
+                                 * "filesize" (optional, int)
                     * preference Order number of this format. If this field is
                                  present and not None, the formats get sorted
                                  by this field, regardless of all other values.