2 * WebM DASH Manifest XML muxer
3 * Copyright (c) 2014 Vignesh Venkatasubramanian
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 * WebM DASH Specification:
24 * https://sites.google.com/a/webmproject.org/wiki/adaptive-streaming/webm-dash-specification
25 * ISO DASH Specification:
26 * http://standards.iso.org/ittf/PubliclyAvailableStandards/c065274_ISO_IEC_23009-1_2014.zip
36 #include "libavutil/avstring.h"
37 #include "libavutil/dict.h"
38 #include "libavutil/opt.h"
39 #include "libavutil/time_internal.h"
41 typedef struct AdaptationSet {
47 typedef struct WebMDashMuxContext {
49 char *adaptation_sets;
52 int representation_id;
54 int chunk_start_index;
57 double time_shift_buffer_depth;
58 int minimum_update_period;
61 static const char *get_codec_name(int codec_id)
63 return avcodec_descriptor_get(codec_id)->name;
66 static double get_duration(AVFormatContext *s)
70 for (i = 0; i < s->nb_streams; i++) {
71 AVDictionaryEntry *duration = av_dict_get(s->streams[i]->metadata,
73 if (!duration || atof(duration->value) < 0) continue;
74 if (atof(duration->value) > max) max = atof(duration->value);
79 static int write_header(AVFormatContext *s)
81 WebMDashMuxContext *w = s->priv_data;
82 double min_buffer_time = 1.0;
83 avio_printf(s->pb, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
84 avio_printf(s->pb, "<MPD\n");
85 avio_printf(s->pb, " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n");
86 avio_printf(s->pb, " xmlns=\"urn:mpeg:DASH:schema:MPD:2011\"\n");
87 avio_printf(s->pb, " xsi:schemaLocation=\"urn:mpeg:DASH:schema:MPD:2011\"\n");
88 avio_printf(s->pb, " type=\"%s\"\n", w->is_live ? "dynamic" : "static");
90 avio_printf(s->pb, " mediaPresentationDuration=\"PT%gS\"\n",
93 avio_printf(s->pb, " minBufferTime=\"PT%gS\"\n", min_buffer_time);
94 avio_printf(s->pb, " profiles=\"%s\"%s",
95 w->is_live ? "urn:mpeg:dash:profile:isoff-live:2011" : "urn:webm:dash:profile:webm-on-demand:2012",
96 w->is_live ? "\n" : ">\n");
98 time_t local_time = time(NULL);
100 struct tm *gmt = gmtime_r(&local_time, &gmt_buffer);
102 if (!strftime(gmt_iso, 21, "%Y-%m-%dT%H:%M:%SZ", gmt)) {
103 return AVERROR_UNKNOWN;
105 if (s->flags & AVFMT_FLAG_BITEXACT) {
106 av_strlcpy(gmt_iso, "", 1);
108 avio_printf(s->pb, " availabilityStartTime=\"%s\"\n", gmt_iso);
109 avio_printf(s->pb, " timeShiftBufferDepth=\"PT%gS\"\n", w->time_shift_buffer_depth);
110 avio_printf(s->pb, " minimumUpdatePeriod=\"PT%dS\"", w->minimum_update_period);
111 avio_printf(s->pb, ">\n");
112 if (w->utc_timing_url) {
113 avio_printf(s->pb, "<UTCTiming\n");
114 avio_printf(s->pb, " schemeIdUri=\"urn:mpeg:dash:utc:http-iso:2014\"\n");
115 avio_printf(s->pb, " value=\"%s\"/>\n", w->utc_timing_url);
121 static void write_footer(AVFormatContext *s)
123 avio_printf(s->pb, "</MPD>\n");
126 static int subsegment_alignment(AVFormatContext *s, AdaptationSet *as) {
128 AVDictionaryEntry *gold = av_dict_get(s->streams[as->streams[0]]->metadata,
129 CUE_TIMESTAMPS, NULL, 0);
131 for (i = 1; i < as->nb_streams; i++) {
132 AVDictionaryEntry *ts = av_dict_get(s->streams[as->streams[i]]->metadata,
133 CUE_TIMESTAMPS, NULL, 0);
134 if (!ts || strncmp(gold->value, ts->value, strlen(gold->value))) return 0;
139 static int bitstream_switching(AVFormatContext *s, AdaptationSet *as) {
141 AVDictionaryEntry *gold_track_num = av_dict_get(s->streams[as->streams[0]]->metadata,
142 TRACK_NUMBER, NULL, 0);
143 AVCodecParameters *gold_par = s->streams[as->streams[0]]->codecpar;
144 if (!gold_track_num) return 0;
145 for (i = 1; i < as->nb_streams; i++) {
146 AVDictionaryEntry *track_num = av_dict_get(s->streams[as->streams[i]]->metadata,
147 TRACK_NUMBER, NULL, 0);
148 AVCodecParameters *par = s->streams[as->streams[i]]->codecpar;
150 strncmp(gold_track_num->value, track_num->value, strlen(gold_track_num->value)) ||
151 gold_par->codec_id != par->codec_id ||
152 gold_par->extradata_size != par->extradata_size ||
153 memcmp(gold_par->extradata, par->extradata, par->extradata_size)) {
161 * Writes a Representation within an Adaptation Set. Returns 0 on success and
164 static int write_representation(AVFormatContext *s, AVStream *stream, char *id,
165 int output_width, int output_height,
166 int output_sample_rate) {
167 WebMDashMuxContext *w = s->priv_data;
168 AVDictionaryEntry *irange = av_dict_get(stream->metadata, INITIALIZATION_RANGE, NULL, 0);
169 AVDictionaryEntry *cues_start = av_dict_get(stream->metadata, CUES_START, NULL, 0);
170 AVDictionaryEntry *cues_end = av_dict_get(stream->metadata, CUES_END, NULL, 0);
171 AVDictionaryEntry *filename = av_dict_get(stream->metadata, FILENAME, NULL, 0);
172 AVDictionaryEntry *bandwidth = av_dict_get(stream->metadata, BANDWIDTH, NULL, 0);
173 const char *bandwidth_str;
174 if (!w->is_live && (!irange || !cues_start || !cues_end || !filename || !bandwidth)) {
175 return AVERROR_INVALIDDATA;
177 avio_printf(s->pb, "<Representation id=\"%s\"", id);
178 // if bandwidth for live was not provided, use a default
179 if (w->is_live && !bandwidth) {
180 bandwidth_str = (stream->codecpar->codec_type == AVMEDIA_TYPE_AUDIO) ? "128000" : "1000000";
182 bandwidth_str = bandwidth->value;
184 avio_printf(s->pb, " bandwidth=\"%s\"", bandwidth_str);
185 if (stream->codecpar->codec_type == AVMEDIA_TYPE_VIDEO && output_width)
186 avio_printf(s->pb, " width=\"%d\"", stream->codecpar->width);
187 if (stream->codecpar->codec_type == AVMEDIA_TYPE_VIDEO && output_height)
188 avio_printf(s->pb, " height=\"%d\"", stream->codecpar->height);
189 if (stream->codecpar->codec_type == AVMEDIA_TYPE_AUDIO && output_sample_rate)
190 avio_printf(s->pb, " audioSamplingRate=\"%d\"", stream->codecpar->sample_rate);
192 // For live streams, Codec and Mime Type always go in the Representation tag.
193 avio_printf(s->pb, " codecs=\"%s\"", get_codec_name(stream->codecpar->codec_id));
194 avio_printf(s->pb, " mimeType=\"%s/webm\"",
195 stream->codecpar->codec_type == AVMEDIA_TYPE_VIDEO ? "video" : "audio");
196 // For live streams, subsegments always start with key frames. So this
198 avio_printf(s->pb, " startsWithSAP=\"1\"");
199 avio_printf(s->pb, ">");
201 avio_printf(s->pb, ">\n");
202 avio_printf(s->pb, "<BaseURL>%s</BaseURL>\n", filename->value);
203 avio_printf(s->pb, "<SegmentBase\n");
204 avio_printf(s->pb, " indexRange=\"%s-%s\">\n", cues_start->value, cues_end->value);
205 avio_printf(s->pb, "<Initialization\n");
206 avio_printf(s->pb, " range=\"0-%s\" />\n", irange->value);
207 avio_printf(s->pb, "</SegmentBase>\n");
209 avio_printf(s->pb, "</Representation>\n");
214 * Checks if width of all streams are the same. Returns 1 if true, 0 otherwise.
216 static int check_matching_width(AVFormatContext *s, AdaptationSet *as) {
218 if (as->nb_streams < 2) return 1;
219 first_width = s->streams[as->streams[0]]->codecpar->width;
220 for (i = 1; i < as->nb_streams; i++)
221 if (first_width != s->streams[as->streams[i]]->codecpar->width)
227 * Checks if height of all streams are the same. Returns 1 if true, 0 otherwise.
229 static int check_matching_height(AVFormatContext *s, AdaptationSet *as) {
231 if (as->nb_streams < 2) return 1;
232 first_height = s->streams[as->streams[0]]->codecpar->height;
233 for (i = 1; i < as->nb_streams; i++)
234 if (first_height != s->streams[as->streams[i]]->codecpar->height)
240 * Checks if sample rate of all streams are the same. Returns 1 if true, 0 otherwise.
242 static int check_matching_sample_rate(AVFormatContext *s, AdaptationSet *as) {
243 int first_sample_rate, i;
244 if (as->nb_streams < 2) return 1;
245 first_sample_rate = s->streams[as->streams[0]]->codecpar->sample_rate;
246 for (i = 1; i < as->nb_streams; i++)
247 if (first_sample_rate != s->streams[as->streams[i]]->codecpar->sample_rate)
252 static void free_adaptation_sets(AVFormatContext *s) {
253 WebMDashMuxContext *w = s->priv_data;
255 for (i = 0; i < w->nb_as; i++) {
256 av_freep(&w->as[i].streams);
263 * Parses a live header filename and computes the representation id,
264 * initialization pattern and the media pattern. Pass NULL if you don't want to
265 * compute any of those 3. Returns 0 on success and non-zero on failure.
267 * Name of the header file should conform to the following pattern:
268 * <file_description>_<representation_id>.hdr where <file_description> can be
269 * anything. The chunks should be named according to the following pattern:
270 * <file_description>_<representation_id>_<chunk_number>.chk
272 static int parse_filename(char *filename, char **representation_id,
273 char **initialization_pattern, char **media_pattern) {
274 char *underscore_pos = NULL;
275 char *period_pos = NULL;
276 char *filename_str = av_strdup(filename);
280 ret = AVERROR(ENOMEM);
283 underscore_pos = strrchr(filename_str, '_');
284 if (!underscore_pos) {
285 ret = AVERROR_INVALIDDATA;
288 period_pos = strchr(++underscore_pos, '.');
290 ret = AVERROR_INVALIDDATA;
293 *(underscore_pos - 1) = 0;
294 if (representation_id) {
295 *representation_id = av_malloc(period_pos - underscore_pos + 1);
296 if (!(*representation_id)) {
297 ret = AVERROR(ENOMEM);
300 av_strlcpy(*representation_id, underscore_pos, period_pos - underscore_pos + 1);
302 if (initialization_pattern) {
303 *initialization_pattern = av_asprintf("%s_$RepresentationID$.hdr",
305 if (!(*initialization_pattern)) {
306 ret = AVERROR(ENOMEM);
311 *media_pattern = av_asprintf("%s_$RepresentationID$_$Number$.chk",
313 if (!(*media_pattern)) {
314 ret = AVERROR(ENOMEM);
320 av_freep(&filename_str);
325 * Writes an Adaptation Set. Returns 0 on success and < 0 on failure.
327 static int write_adaptation_set(AVFormatContext *s, int as_index)
329 WebMDashMuxContext *w = s->priv_data;
330 AdaptationSet *as = &w->as[as_index];
331 AVCodecParameters *par = s->streams[as->streams[0]]->codecpar;
332 AVDictionaryEntry *lang;
334 static const char boolean[2][6] = { "false", "true" };
335 int subsegmentStartsWithSAP = 1;
337 // Width, Height and Sample Rate will go in the AdaptationSet tag if they
338 // are the same for all contained Representations. otherwise, they will go
339 // on their respective Representation tag. For live streams, they always go
340 // in the Representation tag.
341 int width_in_as = 1, height_in_as = 1, sample_rate_in_as = 1;
342 if (par->codec_type == AVMEDIA_TYPE_VIDEO) {
343 width_in_as = !w->is_live && check_matching_width(s, as);
344 height_in_as = !w->is_live && check_matching_height(s, as);
346 sample_rate_in_as = !w->is_live && check_matching_sample_rate(s, as);
349 avio_printf(s->pb, "<AdaptationSet id=\"%s\"", as->id);
350 avio_printf(s->pb, " mimeType=\"%s/webm\"",
351 par->codec_type == AVMEDIA_TYPE_VIDEO ? "video" : "audio");
352 avio_printf(s->pb, " codecs=\"%s\"", get_codec_name(par->codec_id));
354 lang = av_dict_get(s->streams[as->streams[0]]->metadata, "language", NULL, 0);
355 if (lang) avio_printf(s->pb, " lang=\"%s\"", lang->value);
357 if (par->codec_type == AVMEDIA_TYPE_VIDEO && width_in_as)
358 avio_printf(s->pb, " width=\"%d\"", par->width);
359 if (par->codec_type == AVMEDIA_TYPE_VIDEO && height_in_as)
360 avio_printf(s->pb, " height=\"%d\"", par->height);
361 if (par->codec_type == AVMEDIA_TYPE_AUDIO && sample_rate_in_as)
362 avio_printf(s->pb, " audioSamplingRate=\"%d\"", par->sample_rate);
364 avio_printf(s->pb, " bitstreamSwitching=\"%s\"",
365 boolean[bitstream_switching(s, as)]);
366 avio_printf(s->pb, " subsegmentAlignment=\"%s\"",
367 boolean[w->is_live || subsegment_alignment(s, as)]);
369 for (i = 0; i < as->nb_streams; i++) {
370 AVDictionaryEntry *kf = av_dict_get(s->streams[as->streams[i]]->metadata,
371 CLUSTER_KEYFRAME, NULL, 0);
372 if (!w->is_live && (!kf || !strncmp(kf->value, "0", 1))) subsegmentStartsWithSAP = 0;
374 avio_printf(s->pb, " subsegmentStartsWithSAP=\"%d\"", subsegmentStartsWithSAP);
375 avio_printf(s->pb, ">\n");
378 AVDictionaryEntry *filename =
379 av_dict_get(s->streams[as->streams[0]]->metadata, FILENAME, NULL, 0);
380 char *initialization_pattern = NULL;
381 char *media_pattern = NULL;
384 return AVERROR(EINVAL);
385 ret = parse_filename(filename->value, NULL, &initialization_pattern,
388 avio_printf(s->pb, "<ContentComponent id=\"1\" type=\"%s\"/>\n",
389 par->codec_type == AVMEDIA_TYPE_VIDEO ? "video" : "audio");
390 avio_printf(s->pb, "<SegmentTemplate");
391 avio_printf(s->pb, " timescale=\"1000\"");
392 avio_printf(s->pb, " duration=\"%d\"", w->chunk_duration);
393 avio_printf(s->pb, " media=\"%s\"", media_pattern);
394 avio_printf(s->pb, " startNumber=\"%d\"", w->chunk_start_index);
395 avio_printf(s->pb, " initialization=\"%s\"", initialization_pattern);
396 avio_printf(s->pb, "/>\n");
397 av_free(initialization_pattern);
398 av_free(media_pattern);
401 for (i = 0; i < as->nb_streams; i++) {
402 char *representation_id = NULL;
405 AVDictionaryEntry *filename =
406 av_dict_get(s->streams[as->streams[i]]->metadata, FILENAME, NULL, 0);
408 return AVERROR(EINVAL);
409 if (ret = parse_filename(filename->value, &representation_id, NULL, NULL))
412 representation_id = av_asprintf("%d", w->representation_id++);
413 if (!representation_id) return AVERROR(ENOMEM);
415 ret = write_representation(s, s->streams[as->streams[i]],
416 representation_id, !width_in_as,
417 !height_in_as, !sample_rate_in_as);
418 av_free(representation_id);
421 avio_printf(s->pb, "</AdaptationSet>\n");
425 static int parse_adaptation_sets(AVFormatContext *s)
427 WebMDashMuxContext *w = s->priv_data;
428 char *p = w->adaptation_sets;
430 enum { new_set, parsed_id, parsing_streams } state;
431 if (!w->adaptation_sets) {
432 av_log(s, AV_LOG_ERROR, "The 'adaptation_sets' option must be set.\n");
433 return AVERROR(EINVAL);
435 // syntax id=0,streams=0,1,2 id=1,streams=3,4 and so on
439 if (state == new_set)
442 return AVERROR(EINVAL);
443 } else if (state == new_set && *p == ' ') {
446 } else if (state == new_set && !strncmp(p, "id=", 3)) {
447 void *mem = av_realloc(w->as, sizeof(*w->as) * (w->nb_as + 1));
450 return AVERROR(ENOMEM);
453 w->as[w->nb_as - 1].nb_streams = 0;
454 w->as[w->nb_as - 1].streams = NULL;
455 p += 3; // consume "id="
456 q = w->as[w->nb_as - 1].id;
457 comma = strchr(p, ',');
458 if (!comma || comma - p >= sizeof(w->as[w->nb_as - 1].id)) {
459 av_log(s, AV_LOG_ERROR, "'id' in 'adaptation_sets' is malformed.\n");
460 return AVERROR(EINVAL);
462 while (*p != ',') *q++ = *p++;
466 } else if (state == parsed_id && !strncmp(p, "streams=", 8)) {
467 p += 8; // consume "streams="
468 state = parsing_streams;
469 } else if (state == parsing_streams) {
470 struct AdaptationSet *as = &w->as[w->nb_as - 1];
472 int ret = av_reallocp_array(&as->streams, ++as->nb_streams,
473 sizeof(*as->streams));
476 num = strtoll(p, &q, 10);
477 if (!av_isdigit(*p) || (*q != ' ' && *q != '\0' && *q != ',') ||
478 num < 0 || num >= s->nb_streams) {
479 av_log(s, AV_LOG_ERROR, "Invalid value for 'streams' in adapation_sets.\n");
480 return AVERROR(EINVAL);
482 as->streams[as->nb_streams - 1] = num;
483 if (*q == '\0') break;
484 if (*q == ' ') state = new_set;
493 static int webm_dash_manifest_write_header(AVFormatContext *s)
498 WebMDashMuxContext *w = s->priv_data;
500 for (unsigned i = 0; i < s->nb_streams; i++) {
501 enum AVCodecID codec_id = s->streams[i]->codecpar->codec_id;
502 if (codec_id != AV_CODEC_ID_VP8 && codec_id != AV_CODEC_ID_VP9 &&
503 codec_id != AV_CODEC_ID_VORBIS && codec_id != AV_CODEC_ID_OPUS)
504 return AVERROR(EINVAL);
507 ret = parse_adaptation_sets(s);
511 ret = write_header(s);
515 avio_printf(s->pb, "<Period id=\"0\"");
516 avio_printf(s->pb, " start=\"PT%gS\"", start);
518 avio_printf(s->pb, " duration=\"PT%gS\"", get_duration(s));
520 avio_printf(s->pb, " >\n");
522 for (i = 0; i < w->nb_as; i++) {
523 ret = write_adaptation_set(s, i);
529 avio_printf(s->pb, "</Period>\n");
532 free_adaptation_sets(s);
533 return ret < 0 ? ret : 0;
536 static int webm_dash_manifest_write_packet(AVFormatContext *s, AVPacket *pkt)
541 #define OFFSET(x) offsetof(WebMDashMuxContext, x)
542 static const AVOption options[] = {
543 { "adaptation_sets", "Adaptation sets. Syntax: id=0,streams=0,1,2 id=1,streams=3,4 and so on", OFFSET(adaptation_sets), AV_OPT_TYPE_STRING, { 0 }, 0, 0, AV_OPT_FLAG_ENCODING_PARAM },
544 { "live", "create a live stream manifest", OFFSET(is_live), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, AV_OPT_FLAG_ENCODING_PARAM },
545 { "chunk_start_index", "start index of the chunk", OFFSET(chunk_start_index), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, AV_OPT_FLAG_ENCODING_PARAM },
546 { "chunk_duration_ms", "duration of each chunk (in milliseconds)", OFFSET(chunk_duration), AV_OPT_TYPE_INT, {.i64 = 1000}, 0, INT_MAX, AV_OPT_FLAG_ENCODING_PARAM },
547 { "utc_timing_url", "URL of the page that will return the UTC timestamp in ISO format", OFFSET(utc_timing_url), AV_OPT_TYPE_STRING, { 0 }, 0, 0, AV_OPT_FLAG_ENCODING_PARAM },
548 { "time_shift_buffer_depth", "Smallest time (in seconds) shifting buffer for which any Representation is guaranteed to be available.", OFFSET(time_shift_buffer_depth), AV_OPT_TYPE_DOUBLE, { .dbl = 60.0 }, 1.0, DBL_MAX, AV_OPT_FLAG_ENCODING_PARAM },
549 { "minimum_update_period", "Minimum Update Period (in seconds) of the manifest.", OFFSET(minimum_update_period), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, AV_OPT_FLAG_ENCODING_PARAM },
553 static const AVClass webm_dash_class = {
554 .class_name = "WebM DASH Manifest muxer",
555 .item_name = av_default_item_name,
557 .version = LIBAVUTIL_VERSION_INT,
560 AVOutputFormat ff_webm_dash_manifest_muxer = {
561 .name = "webm_dash_manifest",
562 .long_name = NULL_IF_CONFIG_SMALL("WebM DASH Manifest"),
563 .mime_type = "application/xml",
565 .priv_data_size = sizeof(WebMDashMuxContext),
566 .write_header = webm_dash_manifest_write_header,
567 .write_packet = webm_dash_manifest_write_packet,
568 .priv_class = &webm_dash_class,