1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
|
/* GStreamer
* Copyright (C) 2010 Marc-Andre Lureau <marcandre.lureau@gmail.com>
* Copyright (C) 2010 Andoni Morales Alastruey <ylatuya@gmail.com>
* Copyright (C) 2015 Tim-Philipp Müller <tim@centricular.com>
*
* m3u8.h:
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __M3U8_H__
#define __M3U8_H__
#include <glib.h>
G_BEGIN_DECLS
typedef struct _GstM3U8 GstM3U8;
typedef struct _GstM3U8MediaFile GstM3U8MediaFile;
typedef struct _GstM3U8InitFile GstM3U8InitFile;
typedef struct _GstHLSMedia GstHLSMedia;
typedef struct _GstM3U8Client GstM3U8Client;
typedef struct _GstHLSVariantStream GstHLSVariantStream;
typedef struct _GstHLSMasterPlaylist GstHLSMasterPlaylist;
#define GST_M3U8(m) ((GstM3U8*)m)
#define GST_M3U8_MEDIA_FILE(f) ((GstM3U8MediaFile*)f)
#define GST_M3U8_LOCK(m) g_mutex_lock (&m->lock);
#define GST_M3U8_UNLOCK(m) g_mutex_unlock (&m->lock);
#define GST_M3U8_IS_LIVE(m) ((m)->endlist == FALSE)
/* hlsdemux must not get closer to the end of a live stream than
GST_M3U8_LIVE_MIN_FRAGMENT_DISTANCE fragments. Section 6.3.3
"Playing the Playlist file" of the HLS draft states that this
value is three fragments */
#define GST_M3U8_LIVE_MIN_FRAGMENT_DISTANCE 3
struct _GstM3U8
{
gchar *uri; /* actually downloaded URI */
gchar *base_uri; /* URI to use as base for resolving relative URIs.
* This will be different to uri in case of redirects */
gchar *name; /* This will be the "name" of the playlist, the original
* relative/absolute uri in a variant playlist */
/* parsed info */
gboolean endlist; /* if ENDLIST has been reached */
gint version; /* last EXT-X-VERSION */
GstClockTime targetduration; /* last EXT-X-TARGETDURATION */
gboolean allowcache; /* last EXT-X-ALLOWCACHE */
GList *files;
/* state */
GList *current_file;
GstClockTime current_file_duration; /* Duration of current fragment */
gint64 sequence; /* the next sequence for this client */
GstClockTime sequence_position; /* position of this sequence */
gint64 highest_sequence_number; /* largest seen sequence number */
GstClockTime first_file_start; /* timecode of the start of the first fragment in the current media playlist */
GstClockTime last_file_end; /* timecode of the end of the last fragment in the current media playlist */
GstClockTime duration; /* cached total duration */
gint discont_sequence; /* currently expected EXT-X-DISCONTINUITY-SEQUENCE */
/*< private > */
gchar *last_data;
GMutex lock;
gint ref_count; /* ATOMIC */
};
GstM3U8 * gst_m3u8_ref (GstM3U8 * m3u8);
void gst_m3u8_unref (GstM3U8 * m3u8);
struct _GstM3U8MediaFile
{
gchar *title;
GstClockTime duration;
gchar *uri;
gint64 sequence; /* the sequence nb of this file */
gboolean discont; /* this file marks a discontinuity */
gchar *key;
guint8 iv[16];
gint64 offset, size;
gint ref_count; /* ATOMIC */
GstM3U8InitFile *init_file; /* Media Initialization (hold ref) */
};
struct _GstM3U8InitFile
{
gchar *uri;
gint64 offset, size;
guint ref_count; /* ATOMIC */
};
GstM3U8MediaFile * gst_m3u8_media_file_ref (GstM3U8MediaFile * mfile);
void gst_m3u8_media_file_unref (GstM3U8MediaFile * mfile);
GstM3U8 * gst_m3u8_new (void);
gboolean gst_m3u8_update (GstM3U8 * m3u8,
gchar * data);
void gst_m3u8_set_uri (GstM3U8 * m3u8,
const gchar * uri,
const gchar * base_uri,
const gchar * name);
GstM3U8MediaFile * gst_m3u8_get_next_fragment (GstM3U8 * m3u8,
gboolean forward,
GstClockTime * sequence_position,
gboolean * discont);
gboolean gst_m3u8_has_next_fragment (GstM3U8 * m3u8,
gboolean forward);
void gst_m3u8_advance_fragment (GstM3U8 * m3u8,
gboolean forward);
GstClockTime gst_m3u8_get_duration (GstM3U8 * m3u8);
GstClockTime gst_m3u8_get_target_duration (GstM3U8 * m3u8);
gchar * gst_m3u8_get_uri (GstM3U8 * m3u8);
gboolean gst_m3u8_is_live (GstM3U8 * m3u8);
gboolean gst_m3u8_get_seek_range (GstM3U8 * m3u8,
gint64 * start,
gint64 * stop);
typedef enum
{
GST_HLS_MEDIA_TYPE_INVALID = -1,
GST_HLS_MEDIA_TYPE_AUDIO,
GST_HLS_MEDIA_TYPE_VIDEO,
GST_HLS_MEDIA_TYPE_SUBTITLES,
GST_HLS_MEDIA_TYPE_CLOSED_CAPTIONS,
GST_HLS_N_MEDIA_TYPES
} GstHLSMediaType;
struct _GstHLSMedia {
GstHLSMediaType mtype;
gchar *group_id;
gchar *name;
gchar *lang;
gchar *uri;
gboolean is_default;
gboolean autoselect;
gboolean forced;
GstM3U8 *playlist; /* media playlist */
gint ref_count; /* ATOMIC */
};
GstHLSMedia * gst_hls_media_ref (GstHLSMedia * media);
void gst_hls_media_unref (GstHLSMedia * media);
const gchar * gst_hls_media_type_get_name (GstHLSMediaType mtype);
struct _GstHLSVariantStream {
gchar *name; /* This will be the "name" of the playlist, the original
* relative/absolute uri in a variant playlist */
gchar *uri;
gchar *codecs;
gint bandwidth;
gint program_id;
gint width;
gint height;
gboolean iframe;
gint refcount; /* ATOMIC */
GstM3U8 *m3u8; /* media playlist */
/* alternative renditions */
gchar *media_groups[GST_HLS_N_MEDIA_TYPES];
GList *media[GST_HLS_N_MEDIA_TYPES];
};
GstHLSVariantStream * gst_hls_variant_stream_ref (GstHLSVariantStream * stream);
void gst_hls_variant_stream_unref (GstHLSVariantStream * stream);
gboolean gst_hls_variant_stream_is_live (GstHLSVariantStream * stream);
GstHLSMedia * gst_hls_variant_find_matching_media (GstHLSVariantStream * stream,
GstHLSMedia *media);
struct _GstHLSMasterPlaylist
{
/* Available variant streams, sorted by bitrate (low -> high) */
GList *variants;
GList *iframe_variants;
GstHLSVariantStream *default_variant; /* first in the list */
gint version; /* EXT-X-VERSION */
gint refcount; /* ATOMIC */
gboolean is_simple; /* TRUE if simple main media playlist,
* FALSE if variant playlist (either
* way the variants list will be set) */
/*< private > */
gchar *last_data;
};
GstHLSMasterPlaylist * gst_hls_master_playlist_new_from_data (gchar * data,
const gchar * base_uri);
GstHLSVariantStream * gst_hls_master_playlist_get_variant_for_bitrate (GstHLSMasterPlaylist * playlist,
GstHLSVariantStream * current_variant,
guint bitrate);
GstHLSVariantStream * gst_hls_master_playlist_get_matching_variant (GstHLSMasterPlaylist * playlist,
GstHLSVariantStream * current_variant);
void gst_hls_master_playlist_unref (GstHLSMasterPlaylist * playlist);
G_END_DECLS
#endif /* __M3U8_H__ */
|
