FFmpeg
hlsplaylist.c
Go to the documentation of this file.
1 /*
2  * Apple HTTP Live Streaming segmenter
3  * Copyright (c) 2012, Luca Barbato
4  * Copyright (c) 2017 Akamai Technologies, Inc.
5  *
6  * This file is part of FFmpeg.
7  *
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.
12  *
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.
17  *
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
21  */
22 
23 #include "config.h"
24 #include <stdint.h>
25 #include <time.h>
26 
27 #include "libavutil/time_internal.h"
28 
29 #include "avformat.h"
30 #include "hlsplaylist.h"
31 
32 void ff_hls_write_playlist_version(AVIOContext *out, int version)
33 {
34  if (!out)
35  return;
36  avio_printf(out, "#EXTM3U\n");
37  avio_printf(out, "#EXT-X-VERSION:%d\n", version);
38 }
39 
40 void ff_hls_write_audio_rendition(AVIOContext *out, const char *agroup,
41  const char *filename, const char *language,
42  int name_id, int is_default)
43 {
44  if (!out || !agroup || !filename)
45  return;
46 
47  avio_printf(out, "#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID=\"group_%s\"", agroup);
48  avio_printf(out, ",NAME=\"audio_%d\",DEFAULT=%s,", name_id, is_default ? "YES" : "NO");
49  if (language) {
50  avio_printf(out, "LANGUAGE=\"%s\",", language);
51  }
52  avio_printf(out, "URI=\"%s\"\n", filename);
53 }
54 
55 void ff_hls_write_subtitle_rendition(AVIOContext *out, const char *sgroup,
56  const char *filename, const char *language,
57  int name_id, int is_default)
58 {
59  if (!out || !filename)
60  return;
61 
62  avio_printf(out, "#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID=\"%s\"", sgroup);
63  avio_printf(out, ",NAME=\"subtitle_%d\",DEFAULT=%s,", name_id, is_default ? "YES" : "NO");
64  if (language) {
65  avio_printf(out, "LANGUAGE=\"%s\",", language);
66  }
67  avio_printf(out, "URI=\"%s\"\n", filename);
68 }
69 
70 void ff_hls_write_stream_info(AVStream *st, AVIOContext *out, int bandwidth,
71  const char *filename, const char *agroup,
72  const char *codecs, const char *ccgroup,
73  const char *sgroup)
74 {
75  if (!out || !filename)
76  return;
77 
78  if (!bandwidth) {
79  av_log(NULL, AV_LOG_WARNING,
80  "Bandwidth info not available, set audio and video bitrates\n");
81  return;
82  }
83 
84  avio_printf(out, "#EXT-X-STREAM-INF:BANDWIDTH=%d", bandwidth);
85  if (st && st->codecpar->width > 0 && st->codecpar->height > 0)
86  avio_printf(out, ",RESOLUTION=%dx%d", st->codecpar->width,
87  st->codecpar->height);
88  if (codecs && codecs[0])
89  avio_printf(out, ",CODECS=\"%s\"", codecs);
90  if (agroup && agroup[0])
91  avio_printf(out, ",AUDIO=\"group_%s\"", agroup);
92  if (ccgroup && ccgroup[0])
93  avio_printf(out, ",CLOSED-CAPTIONS=\"%s\"", ccgroup);
94  if (sgroup && sgroup[0])
95  avio_printf(out, ",SUBTITLES=\"%s\"", sgroup);
96  avio_printf(out, "\n%s\n\n", filename);
97 }
98 
99 void ff_hls_write_playlist_header(AVIOContext *out, int version, int allowcache,
100  int target_duration, int64_t sequence,
101  uint32_t playlist_type, int iframe_mode)
102 {
103  if (!out)
104  return;
105  ff_hls_write_playlist_version(out, version);
106  if (allowcache == 0 || allowcache == 1) {
107  avio_printf(out, "#EXT-X-ALLOW-CACHE:%s\n", allowcache == 0 ? "NO" : "YES");
108  }
109  avio_printf(out, "#EXT-X-TARGETDURATION:%d\n", target_duration);
110  avio_printf(out, "#EXT-X-MEDIA-SEQUENCE:%"PRId64"\n", sequence);
111  av_log(NULL, AV_LOG_VERBOSE, "EXT-X-MEDIA-SEQUENCE:%"PRId64"\n", sequence);
112 
113  if (playlist_type == PLAYLIST_TYPE_EVENT) {
114  avio_printf(out, "#EXT-X-PLAYLIST-TYPE:EVENT\n");
115  } else if (playlist_type == PLAYLIST_TYPE_VOD) {
116  avio_printf(out, "#EXT-X-PLAYLIST-TYPE:VOD\n");
117  }
118  if (iframe_mode) {
119  avio_printf(out, "#EXT-X-I-FRAMES-ONLY\n");
120  }
121 }
122 
123 void ff_hls_write_init_file(AVIOContext *out, const char *filename,
124  int byterange_mode, int64_t size, int64_t pos)
125 {
126  avio_printf(out, "#EXT-X-MAP:URI=\"%s\"", filename);
127  if (byterange_mode) {
128  avio_printf(out, ",BYTERANGE=\"%"PRId64"@%"PRId64"\"", size, pos);
129  }
130  avio_printf(out, "\n");
131 }
132 
133 int ff_hls_write_file_entry(AVIOContext *out, int insert_discont,
134  int byterange_mode, double duration,
135  int round_duration, int64_t size,
136  int64_t pos /* Used only if HLS_SINGLE_FILE flag is set */,
137  const char *baseurl /* Ignored if NULL */,
138  const char *filename, double *prog_date_time,
139  int64_t video_keyframe_size, int64_t video_keyframe_pos,
140  int iframe_mode)
141 {
142  if (!out || !filename)
143  return AVERROR(EINVAL);
144 
145  if (insert_discont) {
146  avio_printf(out, "#EXT-X-DISCONTINUITY\n");
147  }
148  if (round_duration)
149  avio_printf(out, "#EXTINF:%ld,\n", lrint(duration));
150  else
151  avio_printf(out, "#EXTINF:%f,\n", duration);
152  if (byterange_mode)
153  avio_printf(out, "#EXT-X-BYTERANGE:%"PRId64"@%"PRId64"\n", iframe_mode ? video_keyframe_size : size,
154  iframe_mode ? video_keyframe_pos : pos);
155 
156  if (prog_date_time) {
157  time_t tt, wrongsecs;
158  int milli;
159  struct tm *tm, tmpbuf;
160  char buf0[128], buf1[128];
161  tt = (int64_t)*prog_date_time;
162  milli = av_clip(lrint(1000*(*prog_date_time - tt)), 0, 999);
163  tm = localtime_r(&tt, &tmpbuf);
164  if (!strftime(buf0, sizeof(buf0), "%Y-%m-%dT%H:%M:%S", tm)) {
165  av_log(NULL, AV_LOG_DEBUG, "strftime error in ff_hls_write_file_entry\n");
166  return AVERROR_UNKNOWN;
167  }
168  if (!strftime(buf1, sizeof(buf1), "%z", tm) || buf1[1]<'0' ||buf1[1]>'2') {
169  int tz_min, dst = tm->tm_isdst;
170  tm = gmtime_r(&tt, &tmpbuf);
171  tm->tm_isdst = dst;
172  wrongsecs = mktime(tm);
173  tz_min = (FFABS(wrongsecs - tt) + 30) / 60;
174  snprintf(buf1, sizeof(buf1),
175  "%c%02d%02d",
176  wrongsecs <= tt ? '+' : '-',
177  tz_min / 60,
178  tz_min % 60);
179  }
180  avio_printf(out, "#EXT-X-PROGRAM-DATE-TIME:%s.%03d%s\n", buf0, milli, buf1);
181  *prog_date_time += duration;
182  }
183  if (baseurl)
184  avio_printf(out, "%s", baseurl);
185  avio_printf(out, "%s\n", filename);
186 
187  return 0;
188 }
189 
190 void ff_hls_write_end_list(AVIOContext *out)
191 {
192  if (!out)
193  return;
194  avio_printf(out, "#EXT-X-ENDLIST\n");
195 }
196 
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
av_clip
#define av_clip
Definition: common.h:96
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
out
FILE * out
Definition: movenc.c:54
ff_hls_write_end_list
void ff_hls_write_end_list(AVIOContext *out)
Definition: hlsplaylist.c:190
PLAYLIST_TYPE_VOD
@ PLAYLIST_TYPE_VOD
Definition: hlsplaylist.h:34
PLAYLIST_TYPE_EVENT
@ PLAYLIST_TYPE_EVENT
Definition: hlsplaylist.h:33
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:196
AVERROR_UNKNOWN
#define AVERROR_UNKNOWN
Unknown error, typically from an external library.
Definition: error.h:73
hlsplaylist.h
ff_hls_write_playlist_header
void ff_hls_write_playlist_header(AVIOContext *out, int version, int allowcache, int target_duration, int64_t sequence, uint32_t playlist_type, int iframe_mode)
Definition: hlsplaylist.c:99
gmtime_r
#define gmtime_r
Definition: time_internal.h:34
ff_hls_write_audio_rendition
void ff_hls_write_audio_rendition(AVIOContext *out, const char *agroup, const char *filename, const char *language, int name_id, int is_default)
Definition: hlsplaylist.c:40
lrint
#define lrint
Definition: tablegen.h:53
ff_hls_write_subtitle_rendition
void ff_hls_write_subtitle_rendition(AVIOContext *out, const char *sgroup, const char *filename, const char *language, int name_id, int is_default)
Definition: hlsplaylist.c:55
duration
int64_t duration
Definition: movenc.c:64
AVCodecParameters::width
int width
Video only.
Definition: codec_par.h:121
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:201
FFABS
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition: common.h:65
time_internal.h
AVStream::codecpar
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:864
NULL
#define NULL
Definition: coverity.c:32
codecs
static const struct codec_string codecs[]
time.h
ff_hls_write_playlist_version
void ff_hls_write_playlist_version(AVIOContext *out, int version)
Definition: hlsplaylist.c:32
AVIOContext
Bytestream IO Context.
Definition: avio.h:166
localtime_r
#define localtime_r
Definition: time_internal.h:46
size
int size
Definition: twinvq_data.h:10344
ff_hls_write_init_file
void ff_hls_write_init_file(AVIOContext *out, const char *filename, int byterange_mode, int64_t size, int64_t pos)
Definition: hlsplaylist.c:123
version
version
Definition: libkvazaar.c:321
AVCodecParameters::height
int height
Definition: codec_par.h:122
language
Undefined Behavior In the C language
Definition: undefined.txt:3
AVStream
Stream structure.
Definition: avformat.h:841
ff_hls_write_file_entry
int ff_hls_write_file_entry(AVIOContext *out, int insert_discont, int byterange_mode, double duration, int round_duration, int64_t size, int64_t pos, const char *baseurl, const char *filename, double *prog_date_time, int64_t video_keyframe_size, int64_t video_keyframe_pos, int iframe_mode)
Definition: hlsplaylist.c:133
pos
unsigned int pos
Definition: spdifenc.c:413
avformat.h
avio_printf
int avio_printf(AVIOContext *s, const char *fmt,...) av_printf_format(2
Writes a formatted string to the context.
ff_hls_write_stream_info
void ff_hls_write_stream_info(AVStream *st, AVIOContext *out, int bandwidth, const char *filename, const char *agroup, const char *codecs, const char *ccgroup, const char *sgroup)
Definition: hlsplaylist.c:70
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
snprintf
#define snprintf
Definition: snprintf.h:34
Generated on Thu Apr 18 2024 22:42:35 for FFmpeg by   doxygen 1.8.17