2 * Apple HTTP Live Streaming demuxer
3 * Copyright (c) 2010 Martin Storsjo
4 * Copyright (c) 2013 Anssi Hannula
6 * This file is part of FFmpeg.
8 * FFmpeg is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * FFmpeg is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with FFmpeg; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 * Apple HTTP Live Streaming demuxer
26 * https://www.rfc-editor.org/rfc/rfc8216.txt
29 #include "libavformat/http.h"
30 #include "libavutil/avstring.h"
31 #include "libavutil/avassert.h"
32 #include "libavutil/intreadwrite.h"
33 #include "libavutil/mathematics.h"
34 #include "libavutil/opt.h"
35 #include "libavutil/dict.h"
36 #include "libavutil/time.h"
39 #include "avio_internal.h"
42 #define INITIAL_BUFFER_SIZE 32768
44 #define MAX_FIELD_LEN 64
45 #define MAX_CHARACTERISTICS_LEN 512
47 #define MPEG_TIME_BASE 90000
48 #define MPEG_TIME_BASE_Q (AVRational){1, MPEG_TIME_BASE}
51 * An apple http stream consists of a playlist with media segment files,
52 * played sequentially. There may be several playlists with the same
53 * video content, in different bandwidth variants, that are played in
54 * parallel (preferably only one bandwidth variant at a time). In this case,
55 * the user supplied the url to a main playlist that only lists the variant
58 * If the main playlist doesn't point at any variants, we still create
59 * one anonymous toplevel variant for this, to maintain the structure.
74 enum KeyType key_type;
76 /* associated Media Initialization Section, treated as a segment */
77 struct segment *init_section;
89 * Each playlist has its own demuxer. If it currently is active,
90 * it has an open AVIOContext too, and potentially an AVPacket
91 * containing the next packet from this stream.
94 char url[MAX_URL_SIZE];
99 AVIOContext *input_next;
100 int input_next_requested;
101 AVFormatContext *parent;
103 AVFormatContext *ctx;
105 int has_noheader_flag;
107 /* main demuxer streams associated with this playlist
108 * indexed by the subdemuxer stream indexes */
109 AVStream **main_streams;
113 enum PlaylistType type;
114 int64_t target_duration;
115 int64_t start_seq_no;
117 struct segment **segments;
122 int m3u8_hold_counters;
123 int64_t cur_seg_offset;
124 int64_t last_load_time;
126 /* Currently active Media Initialization Section */
127 struct segment *cur_init_section;
128 uint8_t *init_sec_buf;
129 unsigned int init_sec_buf_size;
130 unsigned int init_sec_data_len;
131 unsigned int init_sec_buf_read_offset;
133 char key_url[MAX_URL_SIZE];
136 /* ID3 timestamp handling (elementary audio streams have ID3 timestamps
137 * (and possibly other ID3 tags) in the beginning of each segment) */
138 int is_id3_timestamped; /* -1: not yet known */
139 int64_t id3_mpegts_timestamp; /* in mpegts tb */
140 int64_t id3_offset; /* in stream original tb */
141 uint8_t* id3_buf; /* temp buffer for id3 parsing */
142 unsigned int id3_buf_size;
143 AVDictionary *id3_initial; /* data from first id3 tag */
144 int id3_found; /* ID3 tag found at some point */
145 int id3_changed; /* ID3 tag data has changed at some point */
146 ID3v2ExtraMeta *id3_deferred_extra; /* stored here until subdemuxer is opened */
148 int64_t seek_timestamp;
150 int seek_stream_index; /* into subdemuxer stream array */
152 /* Renditions associated with this playlist, if any.
153 * Alternative rendition playlists have a single rendition associated
154 * with them, and variant main Media Playlists may have
155 * multiple (playlist-less) renditions associated with them. */
157 struct rendition **renditions;
159 /* Media Initialization Sections (EXT-X-MAP) associated with this
160 * playlist, if any. */
162 struct segment **init_sections;
166 * Renditions are e.g. alternative subtitle or audio streams.
167 * The rendition may either be an external playlist or it may be
168 * contained in the main Media Playlist of the variant (in which case
172 enum AVMediaType type;
173 struct playlist *playlist;
174 char group_id[MAX_FIELD_LEN];
175 char language[MAX_FIELD_LEN];
176 char name[MAX_FIELD_LEN];
183 /* every variant contains at least the main Media Playlist in index 0 */
185 struct playlist **playlists;
187 char audio_group[MAX_FIELD_LEN];
188 char video_group[MAX_FIELD_LEN];
189 char subtitles_group[MAX_FIELD_LEN];
192 typedef struct HLSContext {
194 AVFormatContext *ctx;
196 struct variant **variants;
198 struct playlist **playlists;
200 struct rendition **renditions;
203 int m3u8_hold_counters;
204 int live_start_index;
206 int64_t first_timestamp;
207 int64_t cur_timestamp;
208 AVIOInterruptCB *interrupt_callback;
209 AVDictionary *avio_opts;
210 char *allowed_extensions;
215 AVIOContext *playlist_pb;
218 static void free_segment_dynarray(struct segment **segments, int n_segments)
221 for (i = 0; i < n_segments; i++) {
222 av_freep(&segments[i]->key);
223 av_freep(&segments[i]->url);
224 av_freep(&segments[i]);
228 static void free_segment_list(struct playlist *pls)
230 free_segment_dynarray(pls->segments, pls->n_segments);
231 av_freep(&pls->segments);
235 static void free_init_section_list(struct playlist *pls)
238 for (i = 0; i < pls->n_init_sections; i++) {
239 av_freep(&pls->init_sections[i]->url);
240 av_freep(&pls->init_sections[i]);
242 av_freep(&pls->init_sections);
243 pls->n_init_sections = 0;
246 static void free_playlist_list(HLSContext *c)
249 for (i = 0; i < c->n_playlists; i++) {
250 struct playlist *pls = c->playlists[i];
251 free_segment_list(pls);
252 free_init_section_list(pls);
253 av_freep(&pls->main_streams);
254 av_freep(&pls->renditions);
255 av_freep(&pls->id3_buf);
256 av_dict_free(&pls->id3_initial);
257 ff_id3v2_free_extra_meta(&pls->id3_deferred_extra);
258 av_freep(&pls->init_sec_buf);
259 av_packet_free(&pls->pkt);
260 av_freep(&pls->pb.buffer);
261 ff_format_io_close(c->ctx, &pls->input);
262 pls->input_read_done = 0;
263 ff_format_io_close(c->ctx, &pls->input_next);
264 pls->input_next_requested = 0;
267 avformat_close_input(&pls->ctx);
271 av_freep(&c->playlists);
275 static void free_variant_list(HLSContext *c)
278 for (i = 0; i < c->n_variants; i++) {
279 struct variant *var = c->variants[i];
280 av_freep(&var->playlists);
283 av_freep(&c->variants);
287 static void free_rendition_list(HLSContext *c)
290 for (i = 0; i < c->n_renditions; i++)
291 av_freep(&c->renditions[i]);
292 av_freep(&c->renditions);
296 static struct playlist *new_playlist(HLSContext *c, const char *url,
299 struct playlist *pls = av_mallocz(sizeof(struct playlist));
302 pls->pkt = av_packet_alloc();
307 ff_make_absolute_url(pls->url, sizeof(pls->url), base, url);
309 av_packet_free(&pls->pkt);
313 pls->seek_timestamp = AV_NOPTS_VALUE;
315 pls->is_id3_timestamped = -1;
316 pls->id3_mpegts_timestamp = AV_NOPTS_VALUE;
318 dynarray_add(&c->playlists, &c->n_playlists, pls);
322 struct variant_info {
324 /* variant group ids: */
325 char audio[MAX_FIELD_LEN];
326 char video[MAX_FIELD_LEN];
327 char subtitles[MAX_FIELD_LEN];
330 static struct variant *new_variant(HLSContext *c, struct variant_info *info,
331 const char *url, const char *base)
334 struct playlist *pls;
336 pls = new_playlist(c, url, base);
340 var = av_mallocz(sizeof(struct variant));
345 var->bandwidth = atoi(info->bandwidth);
346 strcpy(var->audio_group, info->audio);
347 strcpy(var->video_group, info->video);
348 strcpy(var->subtitles_group, info->subtitles);
351 dynarray_add(&c->variants, &c->n_variants, var);
352 dynarray_add(&var->playlists, &var->n_playlists, pls);
356 static void handle_variant_args(struct variant_info *info, const char *key,
357 int key_len, char **dest, int *dest_len)
359 if (!strncmp(key, "BANDWIDTH=", key_len)) {
360 *dest = info->bandwidth;
361 *dest_len = sizeof(info->bandwidth);
362 } else if (!strncmp(key, "AUDIO=", key_len)) {
364 *dest_len = sizeof(info->audio);
365 } else if (!strncmp(key, "VIDEO=", key_len)) {
367 *dest_len = sizeof(info->video);
368 } else if (!strncmp(key, "SUBTITLES=", key_len)) {
369 *dest = info->subtitles;
370 *dest_len = sizeof(info->subtitles);
375 char uri[MAX_URL_SIZE];
380 static void handle_key_args(struct key_info *info, const char *key,
381 int key_len, char **dest, int *dest_len)
383 if (!strncmp(key, "METHOD=", key_len)) {
384 *dest = info->method;
385 *dest_len = sizeof(info->method);
386 } else if (!strncmp(key, "URI=", key_len)) {
388 *dest_len = sizeof(info->uri);
389 } else if (!strncmp(key, "IV=", key_len)) {
391 *dest_len = sizeof(info->iv);
395 struct init_section_info {
396 char uri[MAX_URL_SIZE];
400 static struct segment *new_init_section(struct playlist *pls,
401 struct init_section_info *info,
402 const char *url_base)
405 char tmp_str[MAX_URL_SIZE], *ptr = tmp_str;
410 sec = av_mallocz(sizeof(*sec));
414 if (!av_strncasecmp(info->uri, "data:", 5)) {
417 ff_make_absolute_url(tmp_str, sizeof(tmp_str), url_base, info->uri);
423 sec->url = av_strdup(ptr);
429 if (info->byterange[0]) {
430 sec->size = strtoll(info->byterange, NULL, 10);
431 ptr = strchr(info->byterange, '@');
433 sec->url_offset = strtoll(ptr+1, NULL, 10);
435 /* the entire file is the init section */
439 dynarray_add(&pls->init_sections, &pls->n_init_sections, sec);
444 static void handle_init_section_args(struct init_section_info *info, const char *key,
445 int key_len, char **dest, int *dest_len)
447 if (!strncmp(key, "URI=", key_len)) {
449 *dest_len = sizeof(info->uri);
450 } else if (!strncmp(key, "BYTERANGE=", key_len)) {
451 *dest = info->byterange;
452 *dest_len = sizeof(info->byterange);
456 struct rendition_info {
458 char uri[MAX_URL_SIZE];
459 char group_id[MAX_FIELD_LEN];
460 char language[MAX_FIELD_LEN];
461 char assoc_language[MAX_FIELD_LEN];
462 char name[MAX_FIELD_LEN];
465 char characteristics[MAX_CHARACTERISTICS_LEN];
468 static struct rendition *new_rendition(HLSContext *c, struct rendition_info *info,
469 const char *url_base)
471 struct rendition *rend;
472 enum AVMediaType type = AVMEDIA_TYPE_UNKNOWN;
473 char *characteristic;
477 if (!strcmp(info->type, "AUDIO"))
478 type = AVMEDIA_TYPE_AUDIO;
479 else if (!strcmp(info->type, "VIDEO"))
480 type = AVMEDIA_TYPE_VIDEO;
481 else if (!strcmp(info->type, "SUBTITLES"))
482 type = AVMEDIA_TYPE_SUBTITLE;
483 else if (!strcmp(info->type, "CLOSED-CAPTIONS"))
484 /* CLOSED-CAPTIONS is ignored since we do not support CEA-608 CC in
485 * AVC SEI RBSP anyway */
488 if (type == AVMEDIA_TYPE_UNKNOWN) {
489 av_log(c->ctx, AV_LOG_WARNING, "Can't support the type: %s\n", info->type);
493 /* URI is mandatory for subtitles as per spec */
494 if (type == AVMEDIA_TYPE_SUBTITLE && !info->uri[0]) {
495 av_log(c->ctx, AV_LOG_ERROR, "The URI tag is REQUIRED for subtitle.\n");
499 /* TODO: handle subtitles (each segment has to parsed separately) */
500 if (c->ctx->strict_std_compliance > FF_COMPLIANCE_EXPERIMENTAL)
501 if (type == AVMEDIA_TYPE_SUBTITLE) {
502 av_log(c->ctx, AV_LOG_WARNING, "Can't support the subtitle(uri: %s)\n", info->uri);
506 rend = av_mallocz(sizeof(struct rendition));
510 dynarray_add(&c->renditions, &c->n_renditions, rend);
513 strcpy(rend->group_id, info->group_id);
514 strcpy(rend->language, info->language);
515 strcpy(rend->name, info->name);
517 /* add the playlist if this is an external rendition */
519 rend->playlist = new_playlist(c, info->uri, url_base);
521 dynarray_add(&rend->playlist->renditions,
522 &rend->playlist->n_renditions, rend);
525 if (info->assoc_language[0]) {
526 int langlen = strlen(rend->language);
527 if (langlen < sizeof(rend->language) - 3) {
528 rend->language[langlen] = ',';
529 strncpy(rend->language + langlen + 1, info->assoc_language,
530 sizeof(rend->language) - langlen - 2);
534 if (!strcmp(info->defaultr, "YES"))
535 rend->disposition |= AV_DISPOSITION_DEFAULT;
536 if (!strcmp(info->forced, "YES"))
537 rend->disposition |= AV_DISPOSITION_FORCED;
539 chr_ptr = info->characteristics;
540 while ((characteristic = av_strtok(chr_ptr, ",", &saveptr))) {
541 if (!strcmp(characteristic, "public.accessibility.describes-music-and-sound"))
542 rend->disposition |= AV_DISPOSITION_HEARING_IMPAIRED;
543 else if (!strcmp(characteristic, "public.accessibility.describes-video"))
544 rend->disposition |= AV_DISPOSITION_VISUAL_IMPAIRED;
552 static void handle_rendition_args(struct rendition_info *info, const char *key,
553 int key_len, char **dest, int *dest_len)
555 if (!strncmp(key, "TYPE=", key_len)) {
557 *dest_len = sizeof(info->type);
558 } else if (!strncmp(key, "URI=", key_len)) {
560 *dest_len = sizeof(info->uri);
561 } else if (!strncmp(key, "GROUP-ID=", key_len)) {
562 *dest = info->group_id;
563 *dest_len = sizeof(info->group_id);
564 } else if (!strncmp(key, "LANGUAGE=", key_len)) {
565 *dest = info->language;
566 *dest_len = sizeof(info->language);
567 } else if (!strncmp(key, "ASSOC-LANGUAGE=", key_len)) {
568 *dest = info->assoc_language;
569 *dest_len = sizeof(info->assoc_language);
570 } else if (!strncmp(key, "NAME=", key_len)) {
572 *dest_len = sizeof(info->name);
573 } else if (!strncmp(key, "DEFAULT=", key_len)) {
574 *dest = info->defaultr;
575 *dest_len = sizeof(info->defaultr);
576 } else if (!strncmp(key, "FORCED=", key_len)) {
577 *dest = info->forced;
578 *dest_len = sizeof(info->forced);
579 } else if (!strncmp(key, "CHARACTERISTICS=", key_len)) {
580 *dest = info->characteristics;
581 *dest_len = sizeof(info->characteristics);
585 * - AUTOSELECT: client may autoselect based on e.g. system language
586 * - INSTREAM-ID: EIA-608 closed caption number ("CC1".."CC4")
590 /* used by parse_playlist to allocate a new variant+playlist when the
591 * playlist is detected to be a Media Playlist (not Master Playlist)
592 * and we have no parent Master Playlist (parsing of which would have
593 * allocated the variant and playlist already)
594 * *pls == NULL => Master Playlist or parentless Media Playlist
595 * *pls != NULL => parented Media Playlist, playlist+variant allocated */
596 static int ensure_playlist(HLSContext *c, struct playlist **pls, const char *url)
600 if (!new_variant(c, NULL, url, NULL))
601 return AVERROR(ENOMEM);
602 *pls = c->playlists[c->n_playlists - 1];
606 static int open_url_keepalive(AVFormatContext *s, AVIOContext **pb,
607 const char *url, AVDictionary **options)
609 #if !CONFIG_HTTP_PROTOCOL
610 return AVERROR_PROTOCOL_NOT_FOUND;
613 URLContext *uc = ffio_geturlcontext(*pb);
615 (*pb)->eof_reached = 0;
616 ret = ff_http_do_new_request2(uc, url, options);
618 ff_format_io_close(s, pb);
624 static int open_url(AVFormatContext *s, AVIOContext **pb, const char *url,
625 AVDictionary **opts, AVDictionary *opts2, int *is_http_out)
627 HLSContext *c = s->priv_data;
628 AVDictionary *tmp = NULL;
629 const char *proto_name = NULL;
633 if (av_strstart(url, "crypto", NULL)) {
634 if (url[6] == '+' || url[6] == ':')
635 proto_name = avio_find_protocol_name(url + 7);
636 } else if (av_strstart(url, "data", NULL)) {
637 if (url[4] == '+' || url[4] == ':')
638 proto_name = avio_find_protocol_name(url + 5);
642 proto_name = avio_find_protocol_name(url);
645 return AVERROR_INVALIDDATA;
647 // only http(s) & file are allowed
648 if (av_strstart(proto_name, "file", NULL)) {
649 if (strcmp(c->allowed_extensions, "ALL") && !av_match_ext(url, c->allowed_extensions)) {
650 av_log(s, AV_LOG_ERROR,
651 "Filename extension of \'%s\' is not a common multimedia extension, blocked for security reasons.\n"
652 "If you wish to override this adjust allowed_extensions, you can set it to \'ALL\' to allow all\n",
654 return AVERROR_INVALIDDATA;
656 } else if (av_strstart(proto_name, "http", NULL)) {
658 } else if (av_strstart(proto_name, "data", NULL)) {
661 return AVERROR_INVALIDDATA;
663 if (!strncmp(proto_name, url, strlen(proto_name)) && url[strlen(proto_name)] == ':')
665 else if (av_strstart(url, "crypto", NULL) && !strncmp(proto_name, url + 7, strlen(proto_name)) && url[7 + strlen(proto_name)] == ':')
667 else if (av_strstart(url, "data", NULL) && !strncmp(proto_name, url + 5, strlen(proto_name)) && url[5 + strlen(proto_name)] == ':')
669 else if (strcmp(proto_name, "file") || !strncmp(url, "file,", 5))
670 return AVERROR_INVALIDDATA;
672 av_dict_copy(&tmp, *opts, 0);
673 av_dict_copy(&tmp, opts2, 0);
675 if (is_http && c->http_persistent && *pb) {
676 ret = open_url_keepalive(c->ctx, pb, url, &tmp);
677 if (ret == AVERROR_EXIT) {
680 } else if (ret < 0) {
681 if (ret != AVERROR_EOF)
682 av_log(s, AV_LOG_WARNING,
683 "keepalive request failed for '%s' with error: '%s' when opening url, retrying with new connection\n",
684 url, av_err2str(ret));
685 av_dict_copy(&tmp, *opts, 0);
686 av_dict_copy(&tmp, opts2, 0);
687 ret = s->io_open(s, pb, url, AVIO_FLAG_READ, &tmp);
690 ret = s->io_open(s, pb, url, AVIO_FLAG_READ, &tmp);
693 // update cookies on http response with setcookies.
694 char *new_cookies = NULL;
696 if (!(s->flags & AVFMT_FLAG_CUSTOM_IO))
697 av_opt_get(*pb, "cookies", AV_OPT_SEARCH_CHILDREN, (uint8_t**)&new_cookies);
700 av_dict_set(opts, "cookies", new_cookies, AV_DICT_DONT_STRDUP_VAL);
706 *is_http_out = is_http;
711 static int parse_playlist(HLSContext *c, const char *url,
712 struct playlist *pls, AVIOContext *in)
714 int ret = 0, is_segment = 0, is_variant = 0;
715 int64_t duration = 0;
716 enum KeyType key_type = KEY_NONE;
719 char key[MAX_URL_SIZE] = "";
720 char line[MAX_URL_SIZE];
723 int64_t seg_offset = 0;
724 int64_t seg_size = -1;
725 uint8_t *new_url = NULL;
726 struct variant_info variant_info;
727 char tmp_str[MAX_URL_SIZE];
728 struct segment *cur_init_section = NULL;
729 int is_http = av_strstart(url, "http", NULL);
730 struct segment **prev_segments = NULL;
731 int prev_n_segments = 0;
732 int64_t prev_start_seq_no = -1;
734 if (is_http && !in && c->http_persistent && c->playlist_pb) {
736 ret = open_url_keepalive(c->ctx, &c->playlist_pb, url, NULL);
737 if (ret == AVERROR_EXIT) {
739 } else if (ret < 0) {
740 if (ret != AVERROR_EOF)
741 av_log(c->ctx, AV_LOG_WARNING,
742 "keepalive request failed for '%s' with error: '%s' when parsing playlist\n",
743 url, av_err2str(ret));
749 AVDictionary *opts = NULL;
750 av_dict_copy(&opts, c->avio_opts, 0);
752 if (c->http_persistent)
753 av_dict_set(&opts, "multiple_requests", "1", 0);
755 ret = c->ctx->io_open(c->ctx, &in, url, AVIO_FLAG_READ, &opts);
760 if (is_http && c->http_persistent)
766 if (av_opt_get(in, "location", AV_OPT_SEARCH_CHILDREN, &new_url) >= 0)
769 ff_get_chomp_line(in, line, sizeof(line));
770 if (strcmp(line, "#EXTM3U")) {
771 ret = AVERROR_INVALIDDATA;
776 prev_start_seq_no = pls->start_seq_no;
777 prev_segments = pls->segments;
778 prev_n_segments = pls->n_segments;
779 pls->segments = NULL;
783 pls->type = PLS_TYPE_UNSPECIFIED;
785 while (!avio_feof(in)) {
786 ff_get_chomp_line(in, line, sizeof(line));
787 if (av_strstart(line, "#EXT-X-STREAM-INF:", &ptr)) {
789 memset(&variant_info, 0, sizeof(variant_info));
790 ff_parse_key_value(ptr, (ff_parse_key_val_cb) handle_variant_args,
792 } else if (av_strstart(line, "#EXT-X-KEY:", &ptr)) {
793 struct key_info info = {{0}};
794 ff_parse_key_value(ptr, (ff_parse_key_val_cb) handle_key_args,
798 if (!strcmp(info.method, "AES-128"))
799 key_type = KEY_AES_128;
800 if (!strcmp(info.method, "SAMPLE-AES"))
801 key_type = KEY_SAMPLE_AES;
802 if (!strncmp(info.iv, "0x", 2) || !strncmp(info.iv, "0X", 2)) {
803 ff_hex_to_data(iv, info.iv + 2);
806 av_strlcpy(key, info.uri, sizeof(key));
807 } else if (av_strstart(line, "#EXT-X-MEDIA:", &ptr)) {
808 struct rendition_info info = {{0}};
809 ff_parse_key_value(ptr, (ff_parse_key_val_cb) handle_rendition_args,
811 new_rendition(c, &info, url);
812 } else if (av_strstart(line, "#EXT-X-TARGETDURATION:", &ptr)) {
813 ret = ensure_playlist(c, &pls, url);
816 pls->target_duration = strtoll(ptr, NULL, 10) * AV_TIME_BASE;
817 } else if (av_strstart(line, "#EXT-X-MEDIA-SEQUENCE:", &ptr)) {
819 ret = ensure_playlist(c, &pls, url);
822 seq_no = strtoull(ptr, NULL, 10);
823 if (seq_no > INT64_MAX) {
824 av_log(c->ctx, AV_LOG_DEBUG, "MEDIA-SEQUENCE higher than "
825 "INT64_MAX, mask out the highest bit\n");
828 pls->start_seq_no = seq_no;
829 } else if (av_strstart(line, "#EXT-X-PLAYLIST-TYPE:", &ptr)) {
830 ret = ensure_playlist(c, &pls, url);
833 if (!strcmp(ptr, "EVENT"))
834 pls->type = PLS_TYPE_EVENT;
835 else if (!strcmp(ptr, "VOD"))
836 pls->type = PLS_TYPE_VOD;
837 } else if (av_strstart(line, "#EXT-X-MAP:", &ptr)) {
838 struct init_section_info info = {{0}};
839 ret = ensure_playlist(c, &pls, url);
842 ff_parse_key_value(ptr, (ff_parse_key_val_cb) handle_init_section_args,
844 cur_init_section = new_init_section(pls, &info, url);
845 if (!cur_init_section) {
846 ret = AVERROR(ENOMEM);
849 cur_init_section->key_type = key_type;
851 memcpy(cur_init_section->iv, iv, sizeof(iv));
853 int64_t seq = pls->start_seq_no + pls->n_segments;
854 memset(cur_init_section->iv, 0, sizeof(cur_init_section->iv));
855 AV_WB64(cur_init_section->iv + 8, seq);
858 if (key_type != KEY_NONE) {
859 ff_make_absolute_url(tmp_str, sizeof(tmp_str), url, key);
861 av_free(cur_init_section);
862 ret = AVERROR_INVALIDDATA;
865 cur_init_section->key = av_strdup(tmp_str);
866 if (!cur_init_section->key) {
867 av_free(cur_init_section);
868 ret = AVERROR(ENOMEM);
872 cur_init_section->key = NULL;
875 } else if (av_strstart(line, "#EXT-X-ENDLIST", &ptr)) {
878 } else if (av_strstart(line, "#EXTINF:", &ptr)) {
880 duration = atof(ptr) * AV_TIME_BASE;
881 } else if (av_strstart(line, "#EXT-X-BYTERANGE:", &ptr)) {
882 seg_size = strtoll(ptr, NULL, 10);
883 ptr = strchr(ptr, '@');
885 seg_offset = strtoll(ptr+1, NULL, 10);
886 } else if (av_strstart(line, "#", NULL)) {
887 av_log(c->ctx, AV_LOG_INFO, "Skip ('%s')\n", line);
889 } else if (line[0]) {
891 if (!new_variant(c, &variant_info, line, url)) {
892 ret = AVERROR(ENOMEM);
899 ret = ensure_playlist(c, &pls, url);
902 seg = av_malloc(sizeof(struct segment));
904 ret = AVERROR(ENOMEM);
908 memcpy(seg->iv, iv, sizeof(iv));
910 int64_t seq = pls->start_seq_no + pls->n_segments;
911 memset(seg->iv, 0, sizeof(seg->iv));
912 AV_WB64(seg->iv + 8, seq);
915 if (key_type != KEY_NONE) {
916 ff_make_absolute_url(tmp_str, sizeof(tmp_str), url, key);
918 ret = AVERROR_INVALIDDATA;
922 seg->key = av_strdup(tmp_str);
925 ret = AVERROR(ENOMEM);
932 ff_make_absolute_url(tmp_str, sizeof(tmp_str), url, line);
934 ret = AVERROR_INVALIDDATA;
940 seg->url = av_strdup(tmp_str);
944 ret = AVERROR(ENOMEM);
948 if (duration < 0.001 * AV_TIME_BASE) {
949 av_log(c->ctx, AV_LOG_WARNING, "Cannot get correct #EXTINF value of segment %s,"
950 " set to default value to 1ms.\n", seg->url);
951 duration = 0.001 * AV_TIME_BASE;
953 seg->duration = duration;
954 seg->key_type = key_type;
955 dynarray_add(&pls->segments, &pls->n_segments, seg);
958 seg->size = seg_size;
960 seg->url_offset = seg_offset;
961 seg_offset += seg_size;
968 seg->init_section = cur_init_section;
973 if (pls->start_seq_no > prev_start_seq_no && c->first_timestamp != AV_NOPTS_VALUE) {
974 int64_t prev_timestamp = c->first_timestamp;
976 int64_t diff = pls->start_seq_no - prev_start_seq_no;
977 for (i = 0; i < prev_n_segments && i < diff; i++) {
978 c->first_timestamp += prev_segments[i]->duration;
980 av_log(c->ctx, AV_LOG_DEBUG, "Media sequence change (%"PRId64" -> %"PRId64")"
981 " reflected in first_timestamp: %"PRId64" -> %"PRId64"\n",
982 prev_start_seq_no, pls->start_seq_no,
983 prev_timestamp, c->first_timestamp);
984 } else if (pls->start_seq_no < prev_start_seq_no) {
985 av_log(c->ctx, AV_LOG_WARNING, "Media sequence changed unexpectedly: %"PRId64" -> %"PRId64"\n",
986 prev_start_seq_no, pls->start_seq_no);
988 free_segment_dynarray(prev_segments, prev_n_segments);
989 av_freep(&prev_segments);
992 pls->last_load_time = av_gettime_relative();
997 ff_format_io_close(c->ctx, &in);
998 c->ctx->ctx_flags = c->ctx->ctx_flags & ~(unsigned)AVFMTCTX_UNSEEKABLE;
999 if (!c->n_variants || !c->variants[0]->n_playlists ||
1000 !(c->variants[0]->playlists[0]->finished ||
1001 c->variants[0]->playlists[0]->type == PLS_TYPE_EVENT))
1002 c->ctx->ctx_flags |= AVFMTCTX_UNSEEKABLE;
1006 static struct segment *current_segment(struct playlist *pls)
1008 return pls->segments[pls->cur_seq_no - pls->start_seq_no];
1011 static struct segment *next_segment(struct playlist *pls)
1013 int64_t n = pls->cur_seq_no - pls->start_seq_no + 1;
1014 if (n >= pls->n_segments)
1016 return pls->segments[n];
1019 static int read_from_url(struct playlist *pls, struct segment *seg,
1020 uint8_t *buf, int buf_size)
1024 /* limit read if the segment was only a part of a file */
1026 buf_size = FFMIN(buf_size, seg->size - pls->cur_seg_offset);
1028 ret = avio_read(pls->input, buf, buf_size);
1030 pls->cur_seg_offset += ret;
1035 /* Parse the raw ID3 data and pass contents to caller */
1036 static void parse_id3(AVFormatContext *s, AVIOContext *pb,
1037 AVDictionary **metadata, int64_t *dts,
1038 ID3v2ExtraMetaAPIC **apic, ID3v2ExtraMeta **extra_meta)
1040 static const char id3_priv_owner_ts[] = "com.apple.streaming.transportStreamTimestamp";
1041 ID3v2ExtraMeta *meta;
1043 ff_id3v2_read_dict(pb, metadata, ID3v2_DEFAULT_MAGIC, extra_meta);
1044 for (meta = *extra_meta; meta; meta = meta->next) {
1045 if (!strcmp(meta->tag, "PRIV")) {
1046 ID3v2ExtraMetaPRIV *priv = &meta->data.priv;
1047 if (priv->datasize == 8 && !strcmp(priv->owner, id3_priv_owner_ts)) {
1048 /* 33-bit MPEG timestamp */
1049 int64_t ts = AV_RB64(priv->data);
1050 av_log(s, AV_LOG_DEBUG, "HLS ID3 audio timestamp %"PRId64"\n", ts);
1051 if ((ts & ~((1ULL << 33) - 1)) == 0)
1054 av_log(s, AV_LOG_ERROR, "Invalid HLS ID3 audio timestamp %"PRId64"\n", ts);
1056 } else if (!strcmp(meta->tag, "APIC") && apic)
1057 *apic = &meta->data.apic;
1061 /* Check if the ID3 metadata contents have changed */
1062 static int id3_has_changed_values(struct playlist *pls, AVDictionary *metadata,
1063 ID3v2ExtraMetaAPIC *apic)
1065 AVDictionaryEntry *entry = NULL;
1066 AVDictionaryEntry *oldentry;
1067 /* check that no keys have changed values */
1068 while ((entry = av_dict_get(metadata, "", entry, AV_DICT_IGNORE_SUFFIX))) {
1069 oldentry = av_dict_get(pls->id3_initial, entry->key, NULL, AV_DICT_MATCH_CASE);
1070 if (!oldentry || strcmp(oldentry->value, entry->value) != 0)
1074 /* check if apic appeared */
1075 if (apic && (pls->ctx->nb_streams != 2 || !pls->ctx->streams[1]->attached_pic.data))
1079 int size = pls->ctx->streams[1]->attached_pic.size;
1080 if (size != apic->buf->size - AV_INPUT_BUFFER_PADDING_SIZE)
1083 if (memcmp(apic->buf->data, pls->ctx->streams[1]->attached_pic.data, size) != 0)
1090 /* Parse ID3 data and handle the found data */
1091 static void handle_id3(AVIOContext *pb, struct playlist *pls)
1093 AVDictionary *metadata = NULL;
1094 ID3v2ExtraMetaAPIC *apic = NULL;
1095 ID3v2ExtraMeta *extra_meta = NULL;
1096 int64_t timestamp = AV_NOPTS_VALUE;
1098 parse_id3(pls->ctx, pb, &metadata, ×tamp, &apic, &extra_meta);
1100 if (timestamp != AV_NOPTS_VALUE) {
1101 pls->id3_mpegts_timestamp = timestamp;
1102 pls->id3_offset = 0;
1105 if (!pls->id3_found) {
1106 /* initial ID3 tags */
1107 av_assert0(!pls->id3_deferred_extra);
1110 /* get picture attachment and set text metadata */
1111 if (pls->ctx->nb_streams)
1112 ff_id3v2_parse_apic(pls->ctx, extra_meta);
1114 /* demuxer not yet opened, defer picture attachment */
1115 pls->id3_deferred_extra = extra_meta;
1117 ff_id3v2_parse_priv_dict(&metadata, extra_meta);
1118 av_dict_copy(&pls->ctx->metadata, metadata, 0);
1119 pls->id3_initial = metadata;
1122 if (!pls->id3_changed && id3_has_changed_values(pls, metadata, apic)) {
1123 avpriv_report_missing_feature(pls->parent, "Changing ID3 metadata in HLS audio elementary stream");
1124 pls->id3_changed = 1;
1126 av_dict_free(&metadata);
1129 if (!pls->id3_deferred_extra)
1130 ff_id3v2_free_extra_meta(&extra_meta);
1133 static void intercept_id3(struct playlist *pls, uint8_t *buf,
1134 int buf_size, int *len)
1136 /* intercept id3 tags, we do not want to pass them to the raw
1137 * demuxer on all segment switches */
1139 int id3_buf_pos = 0;
1141 struct segment *seg = current_segment(pls);
1143 /* gather all the id3 tags */
1145 /* see if we can retrieve enough data for ID3 header */
1146 if (*len < ID3v2_HEADER_SIZE && buf_size >= ID3v2_HEADER_SIZE) {
1147 bytes = read_from_url(pls, seg, buf + *len, ID3v2_HEADER_SIZE - *len);
1150 if (bytes == ID3v2_HEADER_SIZE - *len)
1151 /* no EOF yet, so fill the caller buffer again after
1152 * we have stripped the ID3 tags */
1157 } else if (*len <= 0) {
1164 if (*len < ID3v2_HEADER_SIZE)
1167 if (ff_id3v2_match(buf, ID3v2_DEFAULT_MAGIC)) {
1168 int64_t maxsize = seg->size >= 0 ? seg->size : 1024*1024;
1169 int taglen = ff_id3v2_tag_len(buf);
1170 int tag_got_bytes = FFMIN(taglen, *len);
1171 int remaining = taglen - tag_got_bytes;
1173 if (taglen > maxsize) {
1174 av_log(pls->parent, AV_LOG_ERROR, "Too large HLS ID3 tag (%d > %"PRId64" bytes)\n",
1180 * Copy the id3 tag to our temporary id3 buffer.
1181 * We could read a small id3 tag directly without memcpy, but
1182 * we would still need to copy the large tags, and handling
1183 * both of those cases together with the possibility for multiple
1184 * tags would make the handling a bit complex.
1186 pls->id3_buf = av_fast_realloc(pls->id3_buf, &pls->id3_buf_size, id3_buf_pos + taglen);
1189 memcpy(pls->id3_buf + id3_buf_pos, buf, tag_got_bytes);
1190 id3_buf_pos += tag_got_bytes;
1192 /* strip the intercepted bytes */
1193 *len -= tag_got_bytes;
1194 memmove(buf, buf + tag_got_bytes, *len);
1195 av_log(pls->parent, AV_LOG_DEBUG, "Stripped %d HLS ID3 bytes\n", tag_got_bytes);
1197 if (remaining > 0) {
1198 /* read the rest of the tag in */
1199 if (read_from_url(pls, seg, pls->id3_buf + id3_buf_pos, remaining) != remaining)
1201 id3_buf_pos += remaining;
1202 av_log(pls->parent, AV_LOG_DEBUG, "Stripped additional %d HLS ID3 bytes\n", remaining);
1206 /* no more ID3 tags */
1211 /* re-fill buffer for the caller unless EOF */
1212 if (*len >= 0 && (fill_buf || *len == 0)) {
1213 bytes = read_from_url(pls, seg, buf + *len, buf_size - *len);
1215 /* ignore error if we already had some data */
1223 /* Now parse all the ID3 tags */
1224 AVIOContext id3ioctx;
1225 ffio_init_context(&id3ioctx, pls->id3_buf, id3_buf_pos, 0, NULL, NULL, NULL, NULL);
1226 handle_id3(&id3ioctx, pls);
1229 if (pls->is_id3_timestamped == -1)
1230 pls->is_id3_timestamped = (pls->id3_mpegts_timestamp != AV_NOPTS_VALUE);
1233 static int open_input(HLSContext *c, struct playlist *pls, struct segment *seg, AVIOContext **in)
1235 AVDictionary *opts = NULL;
1239 if (c->http_persistent)
1240 av_dict_set(&opts, "multiple_requests", "1", 0);
1242 if (seg->size >= 0) {
1243 /* try to restrict the HTTP request to the part we want
1244 * (if this is in fact a HTTP request) */
1245 av_dict_set_int(&opts, "offset", seg->url_offset, 0);
1246 av_dict_set_int(&opts, "end_offset", seg->url_offset + seg->size, 0);
1249 av_log(pls->parent, AV_LOG_VERBOSE, "HLS request for url '%s', offset %"PRId64", playlist %d\n",
1250 seg->url, seg->url_offset, pls->index);
1252 if (seg->key_type == KEY_NONE) {
1253 ret = open_url(pls->parent, in, seg->url, &c->avio_opts, opts, &is_http);
1254 } else if (seg->key_type == KEY_AES_128) {
1255 char iv[33], key[33], url[MAX_URL_SIZE];
1256 if (strcmp(seg->key, pls->key_url)) {
1257 AVIOContext *pb = NULL;
1258 if (open_url(pls->parent, &pb, seg->key, &c->avio_opts, opts, NULL) == 0) {
1259 ret = avio_read(pb, pls->key, sizeof(pls->key));
1260 if (ret != sizeof(pls->key)) {
1261 av_log(pls->parent, AV_LOG_ERROR, "Unable to read key file %s\n",
1264 ff_format_io_close(pls->parent, &pb);
1266 av_log(pls->parent, AV_LOG_ERROR, "Unable to open key file %s\n",
1269 av_strlcpy(pls->key_url, seg->key, sizeof(pls->key_url));
1271 ff_data_to_hex(iv, seg->iv, sizeof(seg->iv), 0);
1272 ff_data_to_hex(key, pls->key, sizeof(pls->key), 0);
1273 iv[32] = key[32] = '\0';
1274 if (strstr(seg->url, "://"))
1275 snprintf(url, sizeof(url), "crypto+%s", seg->url);
1277 snprintf(url, sizeof(url), "crypto:%s", seg->url);
1279 av_dict_set(&opts, "key", key, 0);
1280 av_dict_set(&opts, "iv", iv, 0);
1282 ret = open_url(pls->parent, in, url, &c->avio_opts, opts, &is_http);
1287 } else if (seg->key_type == KEY_SAMPLE_AES) {
1288 av_log(pls->parent, AV_LOG_ERROR,
1289 "SAMPLE-AES encryption is not supported yet\n");
1290 ret = AVERROR_PATCHWELCOME;
1293 ret = AVERROR(ENOSYS);
1295 /* Seek to the requested position. If this was a HTTP request, the offset
1296 * should already be where want it to, but this allows e.g. local testing
1297 * without a HTTP server.
1299 * This is not done for HTTP at all as avio_seek() does internal bookkeeping
1300 * of file offset which is out-of-sync with the actual offset when "offset"
1301 * AVOption is used with http protocol, causing the seek to not be a no-op
1302 * as would be expected. Wrong offset received from the server will not be
1303 * noticed without the call, though.
1305 if (ret == 0 && !is_http && seg->url_offset) {
1306 int64_t seekret = avio_seek(*in, seg->url_offset, SEEK_SET);
1308 av_log(pls->parent, AV_LOG_ERROR, "Unable to seek to offset %"PRId64" of HLS segment '%s'\n", seg->url_offset, seg->url);
1310 ff_format_io_close(pls->parent, in);
1315 av_dict_free(&opts);
1316 pls->cur_seg_offset = 0;
1320 static int update_init_section(struct playlist *pls, struct segment *seg)
1322 static const int max_init_section_size = 1024*1024;
1323 HLSContext *c = pls->parent->priv_data;
1328 if (seg->init_section == pls->cur_init_section)
1331 pls->cur_init_section = NULL;
1333 if (!seg->init_section)
1336 ret = open_input(c, pls, seg->init_section, &pls->input);
1338 av_log(pls->parent, AV_LOG_WARNING,
1339 "Failed to open an initialization section in playlist %d\n",
1344 if (seg->init_section->size >= 0)
1345 sec_size = seg->init_section->size;
1346 else if ((urlsize = avio_size(pls->input)) >= 0)
1349 sec_size = max_init_section_size;
1351 av_log(pls->parent, AV_LOG_DEBUG,
1352 "Downloading an initialization section of size %"PRId64"\n",
1355 sec_size = FFMIN(sec_size, max_init_section_size);
1357 av_fast_malloc(&pls->init_sec_buf, &pls->init_sec_buf_size, sec_size);
1359 ret = read_from_url(pls, seg->init_section, pls->init_sec_buf,
1360 pls->init_sec_buf_size);
1361 ff_format_io_close(pls->parent, &pls->input);
1366 pls->cur_init_section = seg->init_section;
1367 pls->init_sec_data_len = ret;
1368 pls->init_sec_buf_read_offset = 0;
1370 /* spec says audio elementary streams do not have media initialization
1371 * sections, so there should be no ID3 timestamps */
1372 pls->is_id3_timestamped = 0;
1377 static int64_t default_reload_interval(struct playlist *pls)
1379 return pls->n_segments > 0 ?
1380 pls->segments[pls->n_segments - 1]->duration :
1381 pls->target_duration;
1384 static int playlist_needed(struct playlist *pls)
1386 AVFormatContext *s = pls->parent;
1388 int stream_needed = 0;
1391 /* If there is no context or streams yet, the playlist is needed */
1392 if (!pls->ctx || !pls->n_main_streams)
1395 /* check if any of the streams in the playlist are needed */
1396 for (i = 0; i < pls->n_main_streams; i++) {
1397 if (pls->main_streams[i]->discard < AVDISCARD_ALL) {
1403 /* If all streams in the playlist were discarded, the playlist is not
1404 * needed (regardless of whether whole programs are discarded or not). */
1408 /* Otherwise, check if all the programs (variants) this playlist is in are
1409 * discarded. Since all streams in the playlist are part of the same programs
1410 * we can just check the programs of the first stream. */
1412 first_st = pls->main_streams[0]->index;
1414 for (i = 0; i < s->nb_programs; i++) {
1415 AVProgram *program = s->programs[i];
1416 if (program->discard < AVDISCARD_ALL) {
1417 for (j = 0; j < program->nb_stream_indexes; j++) {
1418 if (program->stream_index[j] == first_st) {
1419 /* playlist is in an undiscarded program */
1426 /* some streams were not discarded but all the programs were */
1430 static int read_data(void *opaque, uint8_t *buf, int buf_size)
1432 struct playlist *v = opaque;
1433 HLSContext *c = v->parent->priv_data;
1435 int just_opened = 0;
1436 int reload_count = 0;
1437 struct segment *seg;
1443 if (!v->input || (c->http_persistent && v->input_read_done)) {
1444 int64_t reload_interval;
1446 /* Check that the playlist is still needed before opening a new
1448 v->needed = playlist_needed(v);
1451 av_log(v->parent, AV_LOG_INFO, "No longer receiving playlist %d ('%s')\n",
1456 /* If this is a live stream and the reload interval has elapsed since
1457 * the last playlist reload, reload the playlists now. */
1458 reload_interval = default_reload_interval(v);
1462 if (reload_count > c->max_reload)
1465 av_gettime_relative() - v->last_load_time >= reload_interval) {
1466 if ((ret = parse_playlist(c, v->url, v, NULL)) < 0) {
1467 if (ret != AVERROR_EXIT)
1468 av_log(v->parent, AV_LOG_WARNING, "Failed to reload playlist %d\n",
1472 /* If we need to reload the playlist again below (if
1473 * there's still no more segments), switch to a reload
1474 * interval of half the target duration. */
1475 reload_interval = v->target_duration / 2;
1477 if (v->cur_seq_no < v->start_seq_no) {
1478 av_log(v->parent, AV_LOG_WARNING,
1479 "skipping %"PRId64" segments ahead, expired from playlists\n",
1480 v->start_seq_no - v->cur_seq_no);
1481 v->cur_seq_no = v->start_seq_no;
1483 if (v->cur_seq_no > v->last_seq_no) {
1484 v->last_seq_no = v->cur_seq_no;
1485 v->m3u8_hold_counters = 0;
1486 } else if (v->last_seq_no == v->cur_seq_no) {
1487 v->m3u8_hold_counters++;
1488 if (v->m3u8_hold_counters >= c->m3u8_hold_counters) {
1492 av_log(v->parent, AV_LOG_WARNING, "maybe the m3u8 list sequence have been wraped.\n");
1494 if (v->cur_seq_no >= v->start_seq_no + v->n_segments) {
1497 while (av_gettime_relative() - v->last_load_time < reload_interval) {
1498 if (ff_check_interrupt(c->interrupt_callback))
1499 return AVERROR_EXIT;
1500 av_usleep(100*1000);
1502 /* Enough time has elapsed since the last reload */
1506 v->input_read_done = 0;
1507 seg = current_segment(v);
1509 /* load/update Media Initialization Section, if any */
1510 ret = update_init_section(v, seg);
1514 if (c->http_multiple == 1 && v->input_next_requested) {
1515 FFSWAP(AVIOContext *, v->input, v->input_next);
1516 v->cur_seg_offset = 0;
1517 v->input_next_requested = 0;
1520 ret = open_input(c, v, seg, &v->input);
1523 if (ff_check_interrupt(c->interrupt_callback))
1524 return AVERROR_EXIT;
1525 av_log(v->parent, AV_LOG_WARNING, "Failed to open segment %"PRId64" of playlist %d\n",
1534 if (c->http_multiple == -1) {
1535 uint8_t *http_version_opt = NULL;
1536 int r = av_opt_get(v->input, "http_version", AV_OPT_SEARCH_CHILDREN, &http_version_opt);
1538 c->http_multiple = (!strncmp((const char *)http_version_opt, "1.1", 3) || !strncmp((const char *)http_version_opt, "2.0", 3));
1539 av_freep(&http_version_opt);
1543 seg = next_segment(v);
1544 if (c->http_multiple == 1 && !v->input_next_requested &&
1545 seg && seg->key_type == KEY_NONE && av_strstart(seg->url, "http", NULL)) {
1546 ret = open_input(c, v, seg, &v->input_next);
1548 if (ff_check_interrupt(c->interrupt_callback))
1549 return AVERROR_EXIT;
1550 av_log(v->parent, AV_LOG_WARNING, "Failed to open segment %"PRId64" of playlist %d\n",
1554 v->input_next_requested = 1;
1558 if (v->init_sec_buf_read_offset < v->init_sec_data_len) {
1559 /* Push init section out first before first actual segment */
1560 int copy_size = FFMIN(v->init_sec_data_len - v->init_sec_buf_read_offset, buf_size);
1561 memcpy(buf, v->init_sec_buf, copy_size);
1562 v->init_sec_buf_read_offset += copy_size;
1566 seg = current_segment(v);
1567 ret = read_from_url(v, seg, buf, buf_size);
1569 if (just_opened && v->is_id3_timestamped != 0) {
1570 /* Intercept ID3 tags here, elementary audio streams are required
1571 * to convey timestamps using them in the beginning of each segment. */
1572 intercept_id3(v, buf, buf_size, &ret);
1577 if (c->http_persistent &&
1578 seg->key_type == KEY_NONE && av_strstart(seg->url, "http", NULL)) {
1579 v->input_read_done = 1;
1581 ff_format_io_close(v->parent, &v->input);
1585 c->cur_seq_no = v->cur_seq_no;
1590 static void add_renditions_to_variant(HLSContext *c, struct variant *var,
1591 enum AVMediaType type, const char *group_id)
1595 for (i = 0; i < c->n_renditions; i++) {
1596 struct rendition *rend = c->renditions[i];
1598 if (rend->type == type && !strcmp(rend->group_id, group_id)) {
1601 /* rendition is an external playlist
1602 * => add the playlist to the variant */
1603 dynarray_add(&var->playlists, &var->n_playlists, rend->playlist);
1605 /* rendition is part of the variant main Media Playlist
1606 * => add the rendition to the main Media Playlist */
1607 dynarray_add(&var->playlists[0]->renditions,
1608 &var->playlists[0]->n_renditions,
1614 static void add_metadata_from_renditions(AVFormatContext *s, struct playlist *pls,
1615 enum AVMediaType type)
1620 for (i = 0; i < pls->n_main_streams; i++) {
1621 AVStream *st = pls->main_streams[i];
1623 if (st->codecpar->codec_type != type)
1626 for (; rend_idx < pls->n_renditions; rend_idx++) {
1627 struct rendition *rend = pls->renditions[rend_idx];
1629 if (rend->type != type)
1632 if (rend->language[0])
1633 av_dict_set(&st->metadata, "language", rend->language, 0);
1635 av_dict_set(&st->metadata, "comment", rend->name, 0);
1637 st->disposition |= rend->disposition;
1639 if (rend_idx >=pls->n_renditions)
1644 /* if timestamp was in valid range: returns 1 and sets seq_no
1645 * if not: returns 0 and sets seq_no to closest segment */
1646 static int find_timestamp_in_playlist(HLSContext *c, struct playlist *pls,
1647 int64_t timestamp, int64_t *seq_no)
1650 int64_t pos = c->first_timestamp == AV_NOPTS_VALUE ?
1651 0 : c->first_timestamp;
1653 if (timestamp < pos) {
1654 *seq_no = pls->start_seq_no;
1658 for (i = 0; i < pls->n_segments; i++) {
1659 int64_t diff = pos + pls->segments[i]->duration - timestamp;
1661 *seq_no = pls->start_seq_no + i;
1664 pos += pls->segments[i]->duration;
1667 *seq_no = pls->start_seq_no + pls->n_segments - 1;
1672 static int64_t select_cur_seq_no(HLSContext *c, struct playlist *pls)
1676 if (!pls->finished && !c->first_packet &&
1677 av_gettime_relative() - pls->last_load_time >= default_reload_interval(pls))
1678 /* reload the playlist since it was suspended */
1679 parse_playlist(c, pls->url, pls, NULL);
1681 /* If playback is already in progress (we are just selecting a new
1682 * playlist) and this is a complete file, find the matching segment
1683 * by counting durations. */
1684 if (pls->finished && c->cur_timestamp != AV_NOPTS_VALUE) {
1685 find_timestamp_in_playlist(c, pls, c->cur_timestamp, &seq_no);
1689 if (!pls->finished) {
1690 if (!c->first_packet && /* we are doing a segment selection during playback */
1691 c->cur_seq_no >= pls->start_seq_no &&
1692 c->cur_seq_no < pls->start_seq_no + pls->n_segments)
1693 /* While spec 3.4.3 says that we cannot assume anything about the
1694 * content at the same sequence number on different playlists,
1695 * in practice this seems to work and doing it otherwise would
1696 * require us to download a segment to inspect its timestamps. */
1697 return c->cur_seq_no;
1699 /* If this is a live stream, start live_start_index segments from the
1701 if (c->live_start_index < 0)
1702 return pls->start_seq_no + FFMAX(pls->n_segments + c->live_start_index, 0);
1704 return pls->start_seq_no + FFMIN(c->live_start_index, pls->n_segments - 1);
1707 /* Otherwise just start on the first segment. */
1708 return pls->start_seq_no;
1711 static int save_avio_options(AVFormatContext *s)
1713 HLSContext *c = s->priv_data;
1714 static const char * const opts[] = {
1715 "headers", "http_proxy", "user_agent", "cookies", "referer", "rw_timeout", "icy", NULL };
1716 const char * const * opt = opts;
1721 if (av_opt_get(s->pb, *opt, AV_OPT_SEARCH_CHILDREN | AV_OPT_ALLOW_NULL, &buf) >= 0) {
1722 ret = av_dict_set(&c->avio_opts, *opt, buf,
1723 AV_DICT_DONT_STRDUP_VAL);
1733 static int nested_io_open(AVFormatContext *s, AVIOContext **pb, const char *url,
1734 int flags, AVDictionary **opts)
1736 av_log(s, AV_LOG_ERROR,
1737 "A HLS playlist item '%s' referred to an external file '%s'. "
1738 "Opening this file was forbidden for security reasons\n",
1740 return AVERROR(EPERM);
1743 static void add_stream_to_programs(AVFormatContext *s, struct playlist *pls, AVStream *stream)
1745 HLSContext *c = s->priv_data;
1749 for (i = 0; i < c->n_variants; i++) {
1750 struct variant *v = c->variants[i];
1752 for (j = 0; j < v->n_playlists; j++) {
1753 if (v->playlists[j] != pls)
1756 av_program_add_stream_index(s, i, stream->index);
1759 bandwidth = v->bandwidth;
1760 else if (bandwidth != v->bandwidth)
1761 bandwidth = -1; /* stream in multiple variants with different bandwidths */
1766 av_dict_set_int(&stream->metadata, "variant_bitrate", bandwidth, 0);
1769 static int set_stream_info_from_input_stream(AVStream *st, struct playlist *pls, AVStream *ist)
1773 err = avcodec_parameters_copy(st->codecpar, ist->codecpar);
1777 if (pls->is_id3_timestamped) /* custom timestamps via id3 */
1778 avpriv_set_pts_info(st, 33, 1, MPEG_TIME_BASE);
1780 avpriv_set_pts_info(st, ist->pts_wrap_bits, ist->time_base.num, ist->time_base.den);
1783 st->disposition = ist->disposition;
1786 for (int i = 0; i < ist->nb_side_data; i++) {
1787 const AVPacketSideData *sd_src = &ist->side_data[i];
1790 dst_data = av_stream_new_side_data(st, sd_src->type, sd_src->size);
1792 return AVERROR(ENOMEM);
1793 memcpy(dst_data, sd_src->data, sd_src->size);
1796 st->internal->need_context_update = 1;
1801 /* add new subdemuxer streams to our context, if any */
1802 static int update_streams_from_subdemuxer(AVFormatContext *s, struct playlist *pls)
1806 while (pls->n_main_streams < pls->ctx->nb_streams) {
1807 int ist_idx = pls->n_main_streams;
1808 AVStream *st = avformat_new_stream(s, NULL);
1809 AVStream *ist = pls->ctx->streams[ist_idx];
1812 return AVERROR(ENOMEM);
1814 st->id = pls->index;
1815 dynarray_add(&pls->main_streams, &pls->n_main_streams, st);
1817 add_stream_to_programs(s, pls, st);
1819 err = set_stream_info_from_input_stream(st, pls, ist);
1827 static void update_noheader_flag(AVFormatContext *s)
1829 HLSContext *c = s->priv_data;
1830 int flag_needed = 0;
1833 for (i = 0; i < c->n_playlists; i++) {
1834 struct playlist *pls = c->playlists[i];
1836 if (pls->has_noheader_flag) {
1843 s->ctx_flags |= AVFMTCTX_NOHEADER;
1845 s->ctx_flags &= ~AVFMTCTX_NOHEADER;
1848 static int hls_close(AVFormatContext *s)
1850 HLSContext *c = s->priv_data;
1852 free_playlist_list(c);
1853 free_variant_list(c);
1854 free_rendition_list(c);
1856 av_dict_free(&c->avio_opts);
1857 ff_format_io_close(c->ctx, &c->playlist_pb);
1862 static int hls_read_header(AVFormatContext *s)
1864 HLSContext *c = s->priv_data;
1866 int64_t highest_cur_seq_no = 0;
1869 c->interrupt_callback = &s->interrupt_callback;
1871 c->first_packet = 1;
1872 c->first_timestamp = AV_NOPTS_VALUE;
1873 c->cur_timestamp = AV_NOPTS_VALUE;
1875 if ((ret = save_avio_options(s)) < 0)
1878 /* XXX: Some HLS servers don't like being sent the range header,
1879 in this case, need to setting http_seekable = 0 to disable
1881 av_dict_set_int(&c->avio_opts, "seekable", c->http_seekable, 0);
1883 if ((ret = parse_playlist(c, s->url, NULL, s->pb)) < 0)
1886 if (c->n_variants == 0) {
1887 av_log(s, AV_LOG_WARNING, "Empty playlist\n");
1891 /* If the playlist only contained playlists (Master Playlist),
1892 * parse each individual playlist. */
1893 if (c->n_playlists > 1 || c->playlists[0]->n_segments == 0) {
1894 for (i = 0; i < c->n_playlists; i++) {
1895 struct playlist *pls = c->playlists[i];
1896 pls->m3u8_hold_counters = 0;
1897 if ((ret = parse_playlist(c, pls->url, pls, NULL)) < 0) {
1898 av_log(s, AV_LOG_WARNING, "parse_playlist error %s [%s]\n", av_err2str(ret), pls->url);
1900 if (c->n_playlists > 1)
1907 for (i = 0; i < c->n_variants; i++) {
1908 if (c->variants[i]->playlists[0]->n_segments == 0) {
1909 av_log(s, AV_LOG_WARNING, "Empty segment [%s]\n", c->variants[i]->playlists[0]->url);
1910 c->variants[i]->playlists[0]->broken = 1;
1914 /* If this isn't a live stream, calculate the total duration of the
1916 if (c->variants[0]->playlists[0]->finished) {
1917 int64_t duration = 0;
1918 for (i = 0; i < c->variants[0]->playlists[0]->n_segments; i++)
1919 duration += c->variants[0]->playlists[0]->segments[i]->duration;
1920 s->duration = duration;
1923 /* Associate renditions with variants */
1924 for (i = 0; i < c->n_variants; i++) {
1925 struct variant *var = c->variants[i];
1927 if (var->audio_group[0])
1928 add_renditions_to_variant(c, var, AVMEDIA_TYPE_AUDIO, var->audio_group);
1929 if (var->video_group[0])
1930 add_renditions_to_variant(c, var, AVMEDIA_TYPE_VIDEO, var->video_group);
1931 if (var->subtitles_group[0])
1932 add_renditions_to_variant(c, var, AVMEDIA_TYPE_SUBTITLE, var->subtitles_group);
1935 /* Create a program for each variant */
1936 for (i = 0; i < c->n_variants; i++) {
1937 struct variant *v = c->variants[i];
1940 program = av_new_program(s, i);
1943 av_dict_set_int(&program->metadata, "variant_bitrate", v->bandwidth, 0);
1946 /* Select the starting segments */
1947 for (i = 0; i < c->n_playlists; i++) {
1948 struct playlist *pls = c->playlists[i];
1950 if (pls->n_segments == 0)
1953 pls->cur_seq_no = select_cur_seq_no(c, pls);
1954 highest_cur_seq_no = FFMAX(highest_cur_seq_no, pls->cur_seq_no);
1957 /* Open the demuxer for each playlist */
1958 for (i = 0; i < c->n_playlists; i++) {
1959 struct playlist *pls = c->playlists[i];
1961 ff_const59 AVInputFormat *in_fmt = NULL;
1963 if (!(pls->ctx = avformat_alloc_context())) {
1964 ret = AVERROR(ENOMEM);
1968 if (pls->n_segments == 0)
1976 * If this is a live stream and this playlist looks like it is one segment
1977 * behind, try to sync it up so that every substream starts at the same
1978 * time position (so e.g. avformat_find_stream_info() will see packets from
1979 * all active streams within the first few seconds). This is not very generic,
1980 * though, as the sequence numbers are technically independent.
1982 if (!pls->finished && pls->cur_seq_no == highest_cur_seq_no - 1 &&
1983 highest_cur_seq_no < pls->start_seq_no + pls->n_segments) {
1984 pls->cur_seq_no = highest_cur_seq_no;
1987 pls->read_buffer = av_malloc(INITIAL_BUFFER_SIZE);
1988 if (!pls->read_buffer){
1989 ret = AVERROR(ENOMEM);
1990 avformat_free_context(pls->ctx);
1994 ffio_init_context(&pls->pb, pls->read_buffer, INITIAL_BUFFER_SIZE, 0, pls,
1995 read_data, NULL, NULL);
1996 pls->ctx->probesize = s->probesize > 0 ? s->probesize : 1024 * 4;
1997 pls->ctx->max_analyze_duration = s->max_analyze_duration > 0 ? s->max_analyze_duration : 4 * AV_TIME_BASE;
1998 pls->ctx->interrupt_callback = s->interrupt_callback;
1999 url = av_strdup(pls->segments[0]->url);
2000 ret = av_probe_input_buffer(&pls->pb, &in_fmt, url, NULL, 0, 0);
2002 /* Free the ctx - it isn't initialized properly at this point,
2003 * so avformat_close_input shouldn't be called. If
2004 * avformat_open_input fails below, it frees and zeros the
2005 * context, so it doesn't need any special treatment like this. */
2006 av_log(s, AV_LOG_ERROR, "Error when loading first segment '%s'\n", url);
2007 avformat_free_context(pls->ctx);
2013 pls->ctx->pb = &pls->pb;
2014 pls->ctx->io_open = nested_io_open;
2015 pls->ctx->flags |= s->flags & ~AVFMT_FLAG_CUSTOM_IO;
2017 if ((ret = ff_copy_whiteblacklists(pls->ctx, s)) < 0)
2020 ret = avformat_open_input(&pls->ctx, pls->segments[0]->url, in_fmt, NULL);
2024 if (pls->id3_deferred_extra && pls->ctx->nb_streams == 1) {
2025 ff_id3v2_parse_apic(pls->ctx, pls->id3_deferred_extra);
2026 avformat_queue_attached_pictures(pls->ctx);
2027 ff_id3v2_parse_priv(pls->ctx, pls->id3_deferred_extra);
2028 ff_id3v2_free_extra_meta(&pls->id3_deferred_extra);
2031 if (pls->is_id3_timestamped == -1)
2032 av_log(s, AV_LOG_WARNING, "No expected HTTP requests have been made\n");
2035 * For ID3 timestamped raw audio streams we need to detect the packet
2036 * durations to calculate timestamps in fill_timing_for_id3_timestamped_stream(),
2037 * but for other streams we can rely on our user calling avformat_find_stream_info()
2038 * on us if they want to.
2040 if (pls->is_id3_timestamped || (pls->n_renditions > 0 && pls->renditions[0]->type == AVMEDIA_TYPE_AUDIO)) {
2041 ret = avformat_find_stream_info(pls->ctx, NULL);
2046 pls->has_noheader_flag = !!(pls->ctx->ctx_flags & AVFMTCTX_NOHEADER);
2048 /* Create new AVStreams for each stream in this playlist */
2049 ret = update_streams_from_subdemuxer(s, pls);
2054 * Copy any metadata from playlist to main streams, but do not set
2057 if (pls->n_main_streams)
2058 av_dict_copy(&pls->main_streams[0]->metadata, pls->ctx->metadata, 0);
2060 add_metadata_from_renditions(s, pls, AVMEDIA_TYPE_AUDIO);
2061 add_metadata_from_renditions(s, pls, AVMEDIA_TYPE_VIDEO);
2062 add_metadata_from_renditions(s, pls, AVMEDIA_TYPE_SUBTITLE);
2065 update_noheader_flag(s);
2073 static int recheck_discard_flags(AVFormatContext *s, int first)
2075 HLSContext *c = s->priv_data;
2079 /* Check if any new streams are needed */
2080 for (i = 0; i < c->n_playlists; i++) {
2081 struct playlist *pls = c->playlists[i];
2083 cur_needed = playlist_needed(c->playlists[i]);
2088 if (cur_needed && !pls->needed) {
2091 pls->cur_seq_no = select_cur_seq_no(c, pls);
2092 pls->pb.eof_reached = 0;
2093 if (c->cur_timestamp != AV_NOPTS_VALUE) {
2095 pls->seek_timestamp = c->cur_timestamp;
2096 pls->seek_flags = AVSEEK_FLAG_ANY;
2097 pls->seek_stream_index = -1;
2099 av_log(s, AV_LOG_INFO, "Now receiving playlist %d, segment %"PRId64"\n", i, pls->cur_seq_no);
2100 } else if (first && !cur_needed && pls->needed) {
2101 ff_format_io_close(pls->parent, &pls->input);
2102 pls->input_read_done = 0;
2103 ff_format_io_close(pls->parent, &pls->input_next);
2104 pls->input_next_requested = 0;
2107 av_log(s, AV_LOG_INFO, "No longer receiving playlist %d\n", i);
2113 static void fill_timing_for_id3_timestamped_stream(struct playlist *pls)
2115 if (pls->id3_offset >= 0) {
2116 pls->pkt->dts = pls->id3_mpegts_timestamp +
2117 av_rescale_q(pls->id3_offset,
2118 pls->ctx->streams[pls->pkt->stream_index]->time_base,
2120 if (pls->pkt->duration)
2121 pls->id3_offset += pls->pkt->duration;
2123 pls->id3_offset = -1;
2125 /* there have been packets with unknown duration
2126 * since the last id3 tag, should not normally happen */
2127 pls->pkt->dts = AV_NOPTS_VALUE;
2130 if (pls->pkt->duration)
2131 pls->pkt->duration = av_rescale_q(pls->pkt->duration,
2132 pls->ctx->streams[pls->pkt->stream_index]->time_base,
2135 pls->pkt->pts = AV_NOPTS_VALUE;
2138 static AVRational get_timebase(struct playlist *pls)
2140 if (pls->is_id3_timestamped)
2141 return MPEG_TIME_BASE_Q;
2143 return pls->ctx->streams[pls->pkt->stream_index]->time_base;
2146 static int compare_ts_with_wrapdetect(int64_t ts_a, struct playlist *pls_a,
2147 int64_t ts_b, struct playlist *pls_b)
2149 int64_t scaled_ts_a = av_rescale_q(ts_a, get_timebase(pls_a), MPEG_TIME_BASE_Q);
2150 int64_t scaled_ts_b = av_rescale_q(ts_b, get_timebase(pls_b), MPEG_TIME_BASE_Q);
2152 return av_compare_mod(scaled_ts_a, scaled_ts_b, 1LL << 33);
2155 static int hls_read_packet(AVFormatContext *s, AVPacket *pkt)
2157 HLSContext *c = s->priv_data;
2158 int ret, i, minplaylist = -1;
2160 recheck_discard_flags(s, c->first_packet);
2161 c->first_packet = 0;
2163 for (i = 0; i < c->n_playlists; i++) {
2164 struct playlist *pls = c->playlists[i];
2165 /* Make sure we've got one buffered packet from each open playlist
2167 if (pls->needed && !pls->pkt->data) {
2171 ret = av_read_frame(pls->ctx, pls->pkt);
2173 if (!avio_feof(&pls->pb) && ret != AVERROR_EOF)
2177 /* stream_index check prevents matching picture attachments etc. */
2178 if (pls->is_id3_timestamped && pls->pkt->stream_index == 0) {
2179 /* audio elementary streams are id3 timestamped */
2180 fill_timing_for_id3_timestamped_stream(pls);
2183 if (c->first_timestamp == AV_NOPTS_VALUE &&
2184 pls->pkt->dts != AV_NOPTS_VALUE)
2185 c->first_timestamp = av_rescale_q(pls->pkt->dts,
2186 get_timebase(pls), AV_TIME_BASE_Q);
2189 if (pls->seek_timestamp == AV_NOPTS_VALUE)
2192 if (pls->seek_stream_index < 0 ||
2193 pls->seek_stream_index == pls->pkt->stream_index) {
2195 if (pls->pkt->dts == AV_NOPTS_VALUE) {
2196 pls->seek_timestamp = AV_NOPTS_VALUE;
2200 tb = get_timebase(pls);
2201 ts_diff = av_rescale_rnd(pls->pkt->dts, AV_TIME_BASE,
2202 tb.den, AV_ROUND_DOWN) -
2203 pls->seek_timestamp;
2204 if (ts_diff >= 0 && (pls->seek_flags & AVSEEK_FLAG_ANY ||
2205 pls->pkt->flags & AV_PKT_FLAG_KEY)) {
2206 pls->seek_timestamp = AV_NOPTS_VALUE;
2210 av_packet_unref(pls->pkt);
2213 /* Check if this stream has the packet with the lowest dts */
2214 if (pls->pkt->data) {
2215 struct playlist *minpls = minplaylist < 0 ?
2216 NULL : c->playlists[minplaylist];
2217 if (minplaylist < 0) {
2220 int64_t dts = pls->pkt->dts;
2221 int64_t mindts = minpls->pkt->dts;
2223 if (dts == AV_NOPTS_VALUE ||
2224 (mindts != AV_NOPTS_VALUE && compare_ts_with_wrapdetect(dts, pls, mindts, minpls) < 0))
2230 /* If we got a packet, return it */
2231 if (minplaylist >= 0) {
2232 struct playlist *pls = c->playlists[minplaylist];
2236 ret = update_streams_from_subdemuxer(s, pls);
2238 av_packet_unref(pls->pkt);
2242 // If sub-demuxer reports updated metadata, copy it to the first stream
2243 // and set its AVSTREAM_EVENT_FLAG_METADATA_UPDATED flag.
2244 if (pls->ctx->event_flags & AVFMT_EVENT_FLAG_METADATA_UPDATED) {
2245 if (pls->n_main_streams) {
2246 st = pls->main_streams[0];
2247 av_dict_copy(&st->metadata, pls->ctx->metadata, 0);
2248 st->event_flags |= AVSTREAM_EVENT_FLAG_METADATA_UPDATED;
2250 pls->ctx->event_flags &= ~AVFMT_EVENT_FLAG_METADATA_UPDATED;
2253 /* check if noheader flag has been cleared by the subdemuxer */
2254 if (pls->has_noheader_flag && !(pls->ctx->ctx_flags & AVFMTCTX_NOHEADER)) {
2255 pls->has_noheader_flag = 0;
2256 update_noheader_flag(s);
2259 if (pls->pkt->stream_index >= pls->n_main_streams) {
2260 av_log(s, AV_LOG_ERROR, "stream index inconsistency: index %d, %d main streams, %d subdemuxer streams\n",
2261 pls->pkt->stream_index, pls->n_main_streams, pls->ctx->nb_streams);
2262 av_packet_unref(pls->pkt);
2266 ist = pls->ctx->streams[pls->pkt->stream_index];
2267 st = pls->main_streams[pls->pkt->stream_index];
2269 av_packet_move_ref(pkt, pls->pkt);
2270 pkt->stream_index = st->index;
2272 if (pkt->dts != AV_NOPTS_VALUE)
2273 c->cur_timestamp = av_rescale_q(pkt->dts,
2277 /* There may be more situations where this would be useful, but this at least
2278 * handles newly probed codecs properly (i.e. request_probe by mpegts). */
2279 if (ist->codecpar->codec_id != st->codecpar->codec_id) {
2280 ret = set_stream_info_from_input_stream(st, pls, ist);
2291 static int hls_read_seek(AVFormatContext *s, int stream_index,
2292 int64_t timestamp, int flags)
2294 HLSContext *c = s->priv_data;
2295 struct playlist *seek_pls = NULL;
2297 int stream_subdemuxer_index;
2298 int64_t first_timestamp, seek_timestamp, duration;
2301 if ((flags & AVSEEK_FLAG_BYTE) || (c->ctx->ctx_flags & AVFMTCTX_UNSEEKABLE))
2302 return AVERROR(ENOSYS);
2304 first_timestamp = c->first_timestamp == AV_NOPTS_VALUE ?
2305 0 : c->first_timestamp;
2307 seek_timestamp = av_rescale_rnd(timestamp, AV_TIME_BASE,
2308 s->streams[stream_index]->time_base.den,
2309 flags & AVSEEK_FLAG_BACKWARD ?
2310 AV_ROUND_DOWN : AV_ROUND_UP);
2312 duration = s->duration == AV_NOPTS_VALUE ?
2315 if (0 < duration && duration < seek_timestamp - first_timestamp)
2316 return AVERROR(EIO);
2318 /* find the playlist with the specified stream */
2319 for (i = 0; i < c->n_playlists; i++) {
2320 struct playlist *pls = c->playlists[i];
2321 for (j = 0; j < pls->n_main_streams; j++) {
2322 if (pls->main_streams[j] == s->streams[stream_index]) {
2324 stream_subdemuxer_index = j;
2329 /* check if the timestamp is valid for the playlist with the
2330 * specified stream index */
2331 if (!seek_pls || !find_timestamp_in_playlist(c, seek_pls, seek_timestamp, &seq_no))
2332 return AVERROR(EIO);
2334 /* set segment now so we do not need to search again below */
2335 seek_pls->cur_seq_no = seq_no;
2336 seek_pls->seek_stream_index = stream_subdemuxer_index;
2338 for (i = 0; i < c->n_playlists; i++) {
2340 struct playlist *pls = c->playlists[i];
2341 ff_format_io_close(pls->parent, &pls->input);
2342 pls->input_read_done = 0;
2343 ff_format_io_close(pls->parent, &pls->input_next);
2344 pls->input_next_requested = 0;
2345 av_packet_unref(pls->pkt);
2346 pls->pb.eof_reached = 0;
2347 /* Clear any buffered data */
2348 pls->pb.buf_end = pls->pb.buf_ptr = pls->pb.buffer;
2349 /* Reset the pos, to let the mpegts demuxer know we've seeked. */
2351 /* Flush the packet queue of the subdemuxer. */
2352 ff_read_frame_flush(pls->ctx);
2354 pls->seek_timestamp = seek_timestamp;
2355 pls->seek_flags = flags;
2357 if (pls != seek_pls) {
2358 /* set closest segment seq_no for playlists not handled above */
2359 find_timestamp_in_playlist(c, pls, seek_timestamp, &pls->cur_seq_no);
2360 /* seek the playlist to the given position without taking
2361 * keyframes into account since this playlist does not have the
2362 * specified stream where we should look for the keyframes */
2363 pls->seek_stream_index = -1;
2364 pls->seek_flags |= AVSEEK_FLAG_ANY;
2368 c->cur_timestamp = seek_timestamp;
2373 static int hls_probe(const AVProbeData *p)
2375 /* Require #EXTM3U at the start, and either one of the ones below
2376 * somewhere for a proper match. */
2377 if (strncmp(p->buf, "#EXTM3U", 7))
2380 if (strstr(p->buf, "#EXT-X-STREAM-INF:") ||
2381 strstr(p->buf, "#EXT-X-TARGETDURATION:") ||
2382 strstr(p->buf, "#EXT-X-MEDIA-SEQUENCE:"))
2383 return AVPROBE_SCORE_MAX;
2387 #define OFFSET(x) offsetof(HLSContext, x)
2388 #define FLAGS AV_OPT_FLAG_DECODING_PARAM
2389 static const AVOption hls_options[] = {
2390 {"live_start_index", "segment index to start live streams at (negative values are from the end)",
2391 OFFSET(live_start_index), AV_OPT_TYPE_INT, {.i64 = -3}, INT_MIN, INT_MAX, FLAGS},
2392 {"allowed_extensions", "List of file extensions that hls is allowed to access",
2393 OFFSET(allowed_extensions), AV_OPT_TYPE_STRING,
2394 {.str = "3gp,aac,avi,ac3,eac3,flac,mkv,m3u8,m4a,m4s,m4v,mpg,mov,mp2,mp3,mp4,mpeg,mpegts,ogg,ogv,oga,ts,vob,wav"},
2395 INT_MIN, INT_MAX, FLAGS},
2396 {"max_reload", "Maximum number of times a insufficient list is attempted to be reloaded",
2397 OFFSET(max_reload), AV_OPT_TYPE_INT, {.i64 = 1000}, 0, INT_MAX, FLAGS},
2398 {"m3u8_hold_counters", "The maximum number of times to load m3u8 when it refreshes without new segments",
2399 OFFSET(m3u8_hold_counters), AV_OPT_TYPE_INT, {.i64 = 1000}, 0, INT_MAX, FLAGS},
2400 {"http_persistent", "Use persistent HTTP connections",
2401 OFFSET(http_persistent), AV_OPT_TYPE_BOOL, {.i64 = 1}, 0, 1, FLAGS },
2402 {"http_multiple", "Use multiple HTTP connections for fetching segments",
2403 OFFSET(http_multiple), AV_OPT_TYPE_BOOL, {.i64 = -1}, -1, 1, FLAGS},
2404 {"http_seekable", "Use HTTP partial requests, 0 = disable, 1 = enable, -1 = auto",
2405 OFFSET(http_seekable), AV_OPT_TYPE_BOOL, { .i64 = -1}, -1, 1, FLAGS},
2409 static const AVClass hls_class = {
2410 .class_name = "hls demuxer",
2411 .item_name = av_default_item_name,
2412 .option = hls_options,
2413 .version = LIBAVUTIL_VERSION_INT,
2416 AVInputFormat ff_hls_demuxer = {
2418 .long_name = NULL_IF_CONFIG_SMALL("Apple HTTP Live Streaming"),
2419 .priv_class = &hls_class,
2420 .priv_data_size = sizeof(HLSContext),
2421 .flags = AVFMT_NOGENSEARCH | AVFMT_TS_DISCONT,
2422 .read_probe = hls_probe,
2423 .read_header = hls_read_header,
2424 .read_packet = hls_read_packet,
2425 .read_close = hls_close,
2426 .read_seek = hls_read_seek,