mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-09 10:59:39 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/subprojects/gst-plugins-bad/ext/smoothstreaming/gstmssmanifest.h

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

86 lines
4.2 KiB
C
Raw Normal View History

smoothstreaming: stubs for mssdemux Just the stubs for mssdemux element. Also add some useful code from hlsdemux that we intend to reuse
2012-11-08 19:06:44 +00:00
/* GStreamer
* Copyright (C) 2012 Smart TV Alliance
* Author: Thiago Sousa Santos <thiago.sousa.santos@collabora.com>, Collabora Ltd.
*
* gstmssmanifest.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., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifndef __GST_MSS_MANIFEST_H__
#define __GST_MSS_MANIFEST_H__
#include <glib.h>
#include <gio/gio.h>
#include <gst/gst.h>
mssdemux: improved live playback support When a MSS server hosts a live stream the fragments listed in the manifest usually don't have accurate timestamps and duration, except for the first fragment, which additionally stores timing information for the few upcoming fragments. In this scenario it is useless to periodically fetch and update the manifest and the fragments list can be incrementally built by parsing the first/current fragment. https://bugzilla.gnome.org/show_bug.cgi?id=755036
2016-11-29 13:43:41 +00:00
#include <gst/base/gstadapter.h>
smoothstreaming: stubs for mssdemux Just the stubs for mssdemux element. Also add some useful code from hlsdemux that we intend to reuse
2012-11-08 19:06:44 +00:00
G_BEGIN_DECLS
typedef struct _GstMssManifest GstMssManifest;
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
typedef struct _GstMssStream GstMssStream;
smoothstreaming: stubs for mssdemux Just the stubs for mssdemux element. Also add some useful code from hlsdemux that we intend to reuse
2012-11-08 19:06:44 +00:00
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
typedef enum _GstMssStreamType {
mssdemux: add manifest parsing Continued implementing: 1) parse the manifest with libxml2 2) detect stream types
2012-11-09 19:47:54 +00:00
MSS_STREAM_TYPE_UNKNOWN = 0,
MSS_STREAM_TYPE_VIDEO = 1,
MSS_STREAM_TYPE_AUDIO = 2
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
} GstMssStreamType;
mssdemux: add manifest parsing Continued implementing: 1) parse the manifest with libxml2 2) detect stream types
2012-11-09 19:47:54 +00:00
smoothstreaming: port to 1.0
2013-04-16 22:35:03 +00:00
GstMssManifest * gst_mss_manifest_new (GstBuffer * data);
smoothstreaming: stubs for mssdemux Just the stubs for mssdemux element. Also add some useful code from hlsdemux that we intend to reuse
2012-11-08 19:06:44 +00:00
void gst_mss_manifest_free (GstMssManifest * manifest);
mssdemux: add manifest parsing Continued implementing: 1) parse the manifest with libxml2 2) detect stream types
2012-11-09 19:47:54 +00:00
GSList * gst_mss_manifest_get_streams (GstMssManifest * manifest);
mssdemux: handle src pad queries fir duration and latency Add a src pad query handler to get the duration from the manifest and report it upstream. Also adds a simple handler for latency queries
2012-12-26 19:19:14 +00:00
guint64 gst_mss_manifest_get_timescale (GstMssManifest * manifest);
guint64 gst_mss_manifest_get_duration (GstMssManifest * manifest);
mssdemux: initial implementation of seek event handling Adds basic handling for seek in time events. Needs to cooperate with the downstream qtdemux so that it forwards the seeks and the corresponding newsegments
2012-12-28 03:48:33 +00:00
GstClockTime gst_mss_manifest_get_gst_duration (GstMssManifest * manifest);
mssdemux: implement snap seeking Implement snap seek flags handling in stream_seek to allow the parent class to handle it for us https://bugzilla.gnome.org/show_bug.cgi?id=759158
2016-02-02 19:54:10 +00:00
void gst_mss_manifest_seek (GstMssManifest * manifest, gboolean forward, guint64 time);
mssdemux: add connection-speed property This speed limits the maximum bitrate of streams. Currently it is only read when starting the pipeline, but it should be used for switching bitrates during playback to adapt to network changes.
2013-01-08 21:01:17 +00:00
gboolean gst_mss_manifest_change_bitrate (GstMssManifest *manifest, guint64 bitrate);
guint64 gst_mss_manifest_get_current_bitrate (GstMssManifest * manifest);
mssdemux: implement live streams handling Live streams force the demuxer to keep reloading the Manifest from time to time, as the new fragments are being added as they are recorded. The demuxer should also try to keep up and detect when it had to skip fragments, marking the discont flag when that happens. Curiously, the spec doesn't seem to mention when/how a live stream is supposed to end, so keep trying downloads until the demuxer errors out.
2013-01-17 19:20:10 +00:00
gboolean gst_mss_manifest_is_live (GstMssManifest * manifest);
mssdemux: add live support Implement the functions of adaptivedemux to have live support enabled. This allows mssdemux to refresh the Manifest periodically
2014-12-04 04:46:43 +00:00
gint64 gst_mss_manifest_get_dvr_window_length (GstMssManifest * manifest);
gint gst_mss_manifest_get_look_ahead_fragments_count (GstMssManifest * manifest);
mssdemux: implement live streams handling Live streams force the demuxer to keep reloading the Manifest from time to time, as the new fragments are being added as they are recorded. The demuxer should also try to keep up and detect when it had to skip fragments, marking the discont flag when that happens. Curiously, the spec doesn't seem to mention when/how a live stream is supposed to end, so keep trying downloads until the demuxer errors out.
2013-01-17 19:20:10 +00:00
void gst_mss_manifest_reload_fragments (GstMssManifest * manifest, GstBuffer * data);
mssdemux: add live support Implement the functions of adaptivedemux to have live support enabled. This allows mssdemux to refresh the Manifest periodically
2014-12-04 04:46:43 +00:00
GstClockTime gst_mss_manifest_get_min_fragment_duration (GstMssManifest * manifest);
mssdemux: PlayReady WRM parsing support If the manifest has a ProtectionHeader node then parse it and emit protection events according to the specified protection SystemID. https://bugzilla.gnome.org/show_bug.cgi?id=753613
2015-06-08 13:33:22 +00:00
const gchar * gst_mss_manifest_get_protection_system_id (GstMssManifest * manifest);
const gchar * gst_mss_manifest_get_protection_data (GstMssManifest * manifest);
smoothstreaming: implement adaptivedemux's get_live_seek_range() Allows seeking through the available fragments that are still available on the server as specified by the DVRWindowLength attribute in the manifest. https://bugzilla.gnome.org/show_bug.cgi?id=774178
2016-11-10 06:18:36 +00:00
gboolean gst_mss_manifest_get_live_seek_range (GstMssManifest * manifest, gint64 * start, gint64 * stop);
mssdemux: add manifest parsing Continued implementing: 1) parse the manifest with libxml2 2) detect stream types
2012-11-09 19:47:54 +00:00
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
GstMssStreamType gst_mss_stream_get_type (GstMssStream *stream);
GstCaps * gst_mss_stream_get_caps (GstMssStream * stream);
mssdemux: use streams bitrate individually connection setup times seem to matter when measuring the download rate of different streams. Streams with longer fragments have a *relatively* lower connection setup time and achieve higher bitrates. Using the average seems unfair here, so use each stream's measured bitrate to select its best quality option.
2013-02-06 11:48:55 +00:00
gboolean gst_mss_stream_select_bitrate (GstMssStream * stream, guint64 bitrate);
guint64 gst_mss_stream_get_current_bitrate (GstMssStream * stream);
mssdemux: add an 'active' flag to manifest stream mssdemux should set the streams it has exposed as active so that the manifest won't use the non-active streams to compute total bitrates or providing fragments
2013-01-08 20:55:49 +00:00
void gst_mss_stream_set_active (GstMssStream * stream, gboolean active);
mssdemux: add timescale to the caps This is important for downstream to properly timestamp the samples The default value is 10000000, but this can be set in the stream or at the top-level manifest entry
2012-12-20 18:30:06 +00:00
guint64 gst_mss_stream_get_timescale (GstMssStream * stream);
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
GstFlowReturn gst_mss_stream_get_fragment_url (GstMssStream * stream, gchar ** url);
mssdemux: set timestamp and duration to fragment buffers We can get those from the manifest and helps downstream to know the fragment start time after a seeking operation
2013-01-04 18:49:02 +00:00
GstClockTime gst_mss_stream_get_fragment_gst_timestamp (GstMssStream * stream);
GstClockTime gst_mss_stream_get_fragment_gst_duration (GstMssStream * stream);
mssdemux: add live support Implement the functions of adaptivedemux to have live support enabled. This allows mssdemux to refresh the Manifest periodically
2014-12-04 04:46:43 +00:00
gboolean gst_mss_stream_has_next_fragment (GstMssStream * stream);
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
GstFlowReturn gst_mss_stream_advance_fragment (GstMssStream * stream);
mssdemux: port to adaptivedemux base class
2014-11-22 04:01:50 +00:00
GstFlowReturn gst_mss_stream_regress_fragment (GstMssStream * stream);
mssdemux: implement snap seeking Implement snap seek flags handling in stream_seek to allow the parent class to handle it for us https://bugzilla.gnome.org/show_bug.cgi?id=759158
2016-02-02 19:54:10 +00:00
void gst_mss_stream_seek (GstMssStream * stream, gboolean forward, GstSeekFlags flags, guint64 time, guint64 * final_time);
mssmanifest: store the language of the stream https://bugzilla.gnome.org/show_bug.cgi?id=712358
2013-11-14 14:14:18 +00:00
const gchar * gst_mss_stream_get_lang (GstMssStream * stream);
mssdemux: add manifest parsing Continued implementing: 1) parse the manifest with libxml2 2) detect stream types
2012-11-09 19:47:54 +00:00
smoothstreaming: refactor structure names and implement url fetching Use shorter names for the MSS manifest helper structure and functions. Also continues the implementation of the stream fetching and pushing loop. Now it uses the base url correctly and already fetches and pushes the fragments downstream
2012-11-19 20:53:16 +00:00
const gchar * gst_mss_stream_type_name (GstMssStreamType streamtype);
smoothstreaming: stubs for mssdemux Just the stubs for mssdemux element. Also add some useful code from hlsdemux that we intend to reuse
2012-11-08 19:06:44 +00:00
mssdemux: improved live playback support When a MSS server hosts a live stream the fragments listed in the manifest usually don't have accurate timestamps and duration, except for the first fragment, which additionally stores timing information for the few upcoming fragments. In this scenario it is useless to periodically fetch and update the manifest and the fragments list can be incrementally built by parsing the first/current fragment. https://bugzilla.gnome.org/show_bug.cgi?id=755036
2016-11-29 13:43:41 +00:00
void gst_mss_manifest_live_adapter_push(GstMssStream * stream, GstBuffer * buffer);
gsize gst_mss_manifest_live_adapter_available(GstMssStream * stream);
GstBuffer * gst_mss_manifest_live_adapter_take_buffer(GstMssStream * stream, gsize nbytes);
smoothstreaming: clear live adapter on seek In live streaming, buffers sent by souphttpsrc are pushed to the live adapter. The buffers in the adapter are sent out of mssdemux when it is greater than 4096 bytes. Occasionally, when seeking in live streams, if seek occurs just after the last data chunk was received, and if this data chunk is smaller than 4096 bytes, it will be kept in the live adapter. This remaining data in the live adapter will be erroneously prepended to the new data that is downloaded after seek and pushed out. When qtdemux receives this data, since it does not start with a moof box, it is impossible to demux the fragment, and bogus size error will occur. Clear out the live adapter on seek so that no unnecessary remaining data is pushed out together with the new fragment after seeking. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1345>
2020-06-16 02:16:37 +00:00
void gst_mss_manifest_live_adapter_clear (GstMssStream * stream);
mssdemux: improved live playback support When a MSS server hosts a live stream the fragments listed in the manifest usually don't have accurate timestamps and duration, except for the first fragment, which additionally stores timing information for the few upcoming fragments. In this scenario it is useless to periodically fetch and update the manifest and the fragments list can be incrementally built by parsing the first/current fragment. https://bugzilla.gnome.org/show_bug.cgi?id=755036
2016-11-29 13:43:41 +00:00
gboolean gst_mss_stream_fragment_parsing_needed(GstMssStream * stream);
void gst_mss_stream_parse_fragment(GstMssStream * stream, GstBuffer * buffer);
smoothstreaming: stubs for mssdemux Just the stubs for mssdemux element. Also add some useful code from hlsdemux that we intend to reuse
2012-11-08 19:06:44 +00:00
G_END_DECLS
#endif /* __GST_MSS_MANIFEST_H__ */
Reference in a new issue Copy permalink