mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-10 03:19:40 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/subprojects/gst-rtsp-server/gst/rtsp-server/rtsp-media-factory.h

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

300 lines
13 KiB
C
Raw Normal View History

Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
/* GStreamer
* Copyright (C) 2008 Wim Taymans <wim.taymans at gmail.com>
*
* 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
Fix FSF address
2012-11-04 00:14:25 +00:00
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
*/
#include <gst/gst.h>
#include <gst/rtsp/gstrtspurl.h>
#include "rtsp-media.h"
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
#include "rtsp-permissions.h"
rtsp: use AddressPool Remove the multicast_group property. Use the configured addresspool to allocate multicast addresses.
2012-11-14 16:23:59 +00:00
#include "rtsp-address-pool.h"
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
#ifndef __GST_RTSP_MEDIA_FACTORY_H__
#define __GST_RTSP_MEDIA_FACTORY_H__
G_BEGIN_DECLS
Make the server handle arbitrary pipelines Make GstMediaFactory an object that can instantiate GstMediaBin objects. The GstMediaBin object has a handle to a bin with elements and to a list of GstMediaStream objects that this bin produces. Add GstMediaMapper that can map url mountpoints to GstMediaFactory objects along with methods to register and remove those mappings. Add methods and a property to GstRTSPServer to manage the GstMediaMapper object used by the server instance. Modify the example application so that it shows how to create custom pipelines attached to a specific mount point. Various misc cleanps.
2009-01-22 14:33:29 +00:00
/* types for the media factory */
#define GST_TYPE_RTSP_MEDIA_FACTORY (gst_rtsp_media_factory_get_type ())
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
#define GST_IS_RTSP_MEDIA_FACTORY(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_RTSP_MEDIA_FACTORY))
#define GST_IS_RTSP_MEDIA_FACTORY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_RTSP_MEDIA_FACTORY))
#define GST_RTSP_MEDIA_FACTORY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GST_TYPE_RTSP_MEDIA_FACTORY, GstRTSPMediaFactoryClass))
#define GST_RTSP_MEDIA_FACTORY(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_RTSP_MEDIA_FACTORY, GstRTSPMediaFactory))
#define GST_RTSP_MEDIA_FACTORY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_RTSP_MEDIA_FACTORY, GstRTSPMediaFactoryClass))
#define GST_RTSP_MEDIA_FACTORY_CAST(obj) ((GstRTSPMediaFactory*)(obj))
#define GST_RTSP_MEDIA_FACTORY_CLASS_CAST(klass) ((GstRTSPMediaFactoryClass*)(klass))
typedef struct _GstRTSPMediaFactory GstRTSPMediaFactory;
typedef struct _GstRTSPMediaFactoryClass GstRTSPMediaFactoryClass;
rtsp: make object details private Make all object details private Add methods to access private bits
2012-11-29 10:11:05 +00:00
typedef struct _GstRTSPMediaFactoryPrivate GstRTSPMediaFactoryPrivate;
media-factory: make lock macro
2010-12-11 12:41:24 +00:00
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
/**
* GstRTSPMediaFactory:
*
Make the server handle arbitrary pipelines Make GstMediaFactory an object that can instantiate GstMediaBin objects. The GstMediaBin object has a handle to a bin with elements and to a list of GstMediaStream objects that this bin produces. Add GstMediaMapper that can map url mountpoints to GstMediaFactory objects along with methods to register and remove those mappings. Add methods and a property to GstRTSPServer to manage the GstMediaMapper object used by the server instance. Modify the example application so that it shows how to create custom pipelines attached to a specific mount point. Various misc cleanps.
2009-01-22 14:33:29 +00:00
* The definition and logic for constructing the pipeline for a media. The media
* can contain multiple streams like audio and video.
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
*/
struct _GstRTSPMediaFactory {
rtsp-server: port to new thread API
2012-05-11 07:42:47 +00:00
GObject parent;
media-factory: add protocols property Add a property to configure the allowed protocols in the media created from the factory.
2011-08-16 13:15:19 +00:00
docs: update docs
2013-07-11 10:18:26 +00:00
/*< private >*/
rtsp: make object details private Make all object details private Add methods to access private bits
2012-11-29 10:11:05 +00:00
GstRTSPMediaFactoryPrivate *priv;
rtsp-server: add padding to many public structures Not mini objects though, since they are not subclassable anyway, nor kept on the stack or inlined in a structure.
2013-12-12 00:36:07 +00:00
gpointer _gst_reserved[GST_PADDING];
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
};
Make the server handle arbitrary pipelines Make GstMediaFactory an object that can instantiate GstMediaBin objects. The GstMediaBin object has a handle to a bin with elements and to a list of GstMediaStream objects that this bin produces. Add GstMediaMapper that can map url mountpoints to GstMediaFactory objects along with methods to register and remove those mappings. Add methods and a property to GstRTSPServer to manage the GstMediaMapper object used by the server instance. Modify the example application so that it shows how to create custom pipelines attached to a specific mount point. Various misc cleanps.
2009-01-22 14:33:29 +00:00
/**
* GstRTSPMediaFactoryClass:
More docs and small cleanups Add some more docs and update the README Cleanup some method names. Remove an unneeded idx field in the GstRTSPMediaStream
2009-01-30 13:53:28 +00:00
* @gen_key: convert @url to a key for caching shared #GstRTSPMedia objects.
* The default implementation of this function will use the complete URL
* including the query parameters to return a key.
rtsp: massive refactoring Make GObjects from the remaining simple structures. Remove GstRTSPSessionStream, it's not needed. Rename GstRTSPMediaStream -> GstRTSPStream: It is shorter Rename GstRTSPMediaTrans -> GstRTSPStreamTransport: It describes how a GstRTSPStream should be transported to a client. Rename GstRTSPMediaFactory::get_element -> create_element because that more accurately describes what it does. Make nice methods instead of poking in the structures. Move some methods inside the relevant object source code. Use GPtrArray to store objects instead of plain arrays, it is more natural and allows us to more easily clean up. Move the allocation of udp ports to the Stream object. The Stream object contains the elements needed to stream the media to a client. Improve the prepare and unprepare methods. Unprepare should now undo everything prepare did. Improve also async unprepare when doing EOS on shutdown. Make sure we always unprepare correctly.
2012-10-25 19:29:58 +00:00
* @create_element: Construct and return a #GstElement that is a #GstBin containing
More docs and small cleanups Add some more docs and update the README Cleanup some method names. Remove an unneeded idx field in the GstRTSPMediaStream
2009-01-30 13:53:28 +00:00
* the elements to use for streaming the media. The bin should contain
rtsp-media/-factory: Fix request pad name comments These must be escaped for gtk-doc to parse the comments without warnings.
2013-11-22 00:30:53 +00:00
* payloaders pay\%d for each stream. The default implementation of this
More docs and small cleanups Add some more docs and update the README Cleanup some method names. Remove an unneeded idx field in the GstRTSPMediaStream
2009-01-30 13:53:28 +00:00
* function returns the bin created from the launch parameter.
Make the server handle arbitrary pipelines Make GstMediaFactory an object that can instantiate GstMediaBin objects. The GstMediaBin object has a handle to a bin with elements and to a list of GstMediaStream objects that this bin produces. Add GstMediaMapper that can map url mountpoints to GstMediaFactory objects along with methods to register and remove those mappings. Add methods and a property to GstRTSPServer to manage the GstMediaMapper object used by the server instance. Modify the example application so that it shows how to create custom pipelines attached to a specific mount point. Various misc cleanps.
2009-01-22 14:33:29 +00:00
* @construct: the vmethod that will be called when the factory has to create the
More improvements Rename GstRTSPMediaBin to GstRTSPMedia Parse the request url into a GstRTSPUri object and pass this object to the various handlers and methods that require the uri.
2009-01-22 16:58:19 +00:00
* #GstRTSPMedia for @url. The default implementation of this
rtsp: massive refactoring Make GObjects from the remaining simple structures. Remove GstRTSPSessionStream, it's not needed. Rename GstRTSPMediaStream -> GstRTSPStream: It is shorter Rename GstRTSPMediaTrans -> GstRTSPStreamTransport: It describes how a GstRTSPStream should be transported to a client. Rename GstRTSPMediaFactory::get_element -> create_element because that more accurately describes what it does. Make nice methods instead of poking in the structures. Move some methods inside the relevant object source code. Use GPtrArray to store objects instead of plain arrays, it is more natural and allows us to more easily clean up. Move the allocation of udp ports to the Stream object. The Stream object contains the elements needed to stream the media to a client. Improve the prepare and unprepare methods. Unprepare should now undo everything prepare did. Improve also async unprepare when doing EOS on shutdown. Make sure we always unprepare correctly.
2012-10-25 19:29:58 +00:00
* function calls create_element to retrieve an element and then looks for
rtsp-media/-factory: Fix request pad name comments These must be escaped for gtk-doc to parse the comments without warnings.
2013-11-22 00:30:53 +00:00
* pay\%d to create the streams.
Added vmethod create_pipeline to GstRTSPMediaFactory The pipeline is created in this method and the GstRTSPMedia's element is added to it
2009-06-12 15:45:29 +00:00
* @create_pipeline: create a new pipeline or re-use an existing one and
* add the #GstRTSPMedia's element created by @construct to the pipeline.
docs: improve docs
2013-07-11 14:57:14 +00:00
* @configure: configure the media created with @construct. The default
* implementation will configure the 'shared' property of the media.
docs: fix some typos
2016-06-07 19:44:42 +00:00
* @media_constructed: signal emitted when a media was constructed
* @media_configure: signal emitted when a media should be configured
Reorganize things, prepare for media sharing Added various other test server examples Move the SDP message generation to a separate helper. Refactor common code for finding the session. Add content-base for realplayer compatibility Clean up request uris before processing for better vlc compatibility. Move prerolling and pipeline construction to the RTSPMedia object. Use multiudpsink for future pipeline reuse.
2009-01-29 12:31:27 +00:00
*
More docs and small cleanups Add some more docs and update the README Cleanup some method names. Remove an unneeded idx field in the GstRTSPMediaStream
2009-01-30 13:53:28 +00:00
* The #GstRTSPMediaFactory class structure.
Make the server handle arbitrary pipelines Make GstMediaFactory an object that can instantiate GstMediaBin objects. The GstMediaBin object has a handle to a bin with elements and to a list of GstMediaStream objects that this bin produces. Add GstMediaMapper that can map url mountpoints to GstMediaFactory objects along with methods to register and remove those mappings. Add methods and a property to GstRTSPServer to manage the GstMediaMapper object used by the server instance. Modify the example application so that it shows how to create custom pipelines attached to a specific mount point. Various misc cleanps.
2009-01-22 14:33:29 +00:00
*/
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
struct _GstRTSPMediaFactoryClass {
GObjectClass parent_class;
retab some .h
2011-08-16 11:37:50 +00:00
gchar * (*gen_key) (GstRTSPMediaFactory *factory, const GstRTSPUrl *url);
Add shared properties to media and factory Add the shared property to media. Implement some simple caching in the factory depending on if the media is shared or not.
2009-01-29 16:20:27 +00:00
rtsp: massive refactoring Make GObjects from the remaining simple structures. Remove GstRTSPSessionStream, it's not needed. Rename GstRTSPMediaStream -> GstRTSPStream: It is shorter Rename GstRTSPMediaTrans -> GstRTSPStreamTransport: It describes how a GstRTSPStream should be transported to a client. Rename GstRTSPMediaFactory::get_element -> create_element because that more accurately describes what it does. Make nice methods instead of poking in the structures. Move some methods inside the relevant object source code. Use GPtrArray to store objects instead of plain arrays, it is more natural and allows us to more easily clean up. Move the allocation of udp ports to the Stream object. The Stream object contains the elements needed to stream the media to a client. Improve the prepare and unprepare methods. Unprepare should now undo everything prepare did. Improve also async unprepare when doing EOS on shutdown. Make sure we always unprepare correctly.
2012-10-25 19:29:58 +00:00
GstElement * (*create_element) (GstRTSPMediaFactory *factory, const GstRTSPUrl *url);
retab some .h
2011-08-16 11:37:50 +00:00
GstRTSPMedia * (*construct) (GstRTSPMediaFactory *factory, const GstRTSPUrl *url);
GstElement * (*create_pipeline) (GstRTSPMediaFactory *factory, GstRTSPMedia *media);
docs: improve docs
2013-07-11 14:57:14 +00:00
void (*configure) (GstRTSPMediaFactory *factory, GstRTSPMedia *media);
media-factory: add a "media-constructed" signal to GstRTSPMediaFactory For example, it can be used to retrieve source elements like appsrc, in a more convenient way than subclassing get_element.
2011-06-30 08:13:59 +00:00
/* signals */
retab some .h
2011-08-16 11:37:50 +00:00
void (*media_constructed) (GstRTSPMediaFactory *factory, GstRTSPMedia *media);
media-factory: add media-configure signal Add signal to allow the application to configure the media after it was created from the factory.
2011-08-16 13:03:06 +00:00
void (*media_configure) (GstRTSPMediaFactory *factory, GstRTSPMedia *media);
rtsp-server: add padding to many public structures Not mini objects though, since they are not subclassable anyway, nor kept on the stack or inlined in a structure.
2013-12-12 00:36:07 +00:00
/*< private >*/
gpointer _gst_reserved[GST_PADDING_LARGE];
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
};
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
GType gst_rtsp_media_factory_get_type (void);
Add shared properties to media and factory Add the shared property to media. Implement some simple caching in the factory depending on if the media is shared or not.
2009-01-29 16:20:27 +00:00
/* creating the factory */
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
GstRTSPMediaFactory * gst_rtsp_media_factory_new (void);
Add shared properties to media and factory Add the shared property to media. Implement some simple caching in the factory depending on if the media is shared or not.
2009-01-29 16:20:27 +00:00
/* configuring the factory */
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
void gst_rtsp_media_factory_set_launch (GstRTSPMediaFactory *factory,
const gchar *launch);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
gchar * gst_rtsp_media_factory_get_launch (GstRTSPMediaFactory *factory);
More improvements Rename GstRTSPMediaBin to GstRTSPMedia Parse the request url into a GstRTSPUri object and pass this object to the various handlers and methods that require the uri.
2009-01-22 16:58:19 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
docs: improve docs
2013-07-11 14:57:14 +00:00
void gst_rtsp_media_factory_set_permissions (GstRTSPMediaFactory *factory,
GstRTSPPermissions *permissions);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
docs: improve docs
2013-07-11 14:57:14 +00:00
GstRTSPPermissions * gst_rtsp_media_factory_get_permissions (GstRTSPMediaFactory *factory);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media-factory: add convenience API for factory
2013-07-12 14:17:57 +00:00
void gst_rtsp_media_factory_add_role (GstRTSPMediaFactory *factory,
const gchar *role,
const gchar *fieldname, ...);
docs: improve docs
2013-07-11 14:57:14 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
permissions: more bindings-friendly API https://bugzilla.gnome.org/show_bug.cgi?id=793975
2018-03-02 00:36:23 +00:00
void gst_rtsp_media_factory_add_role_from_structure (GstRTSPMediaFactory * factory,
GstStructure *structure);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
void gst_rtsp_media_factory_set_shared (GstRTSPMediaFactory *factory,
gboolean shared);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
gboolean gst_rtsp_media_factory_is_shared (GstRTSPMediaFactory *factory);
media-factory: add eos-shutdown property Add an eos-shutdown property that will send an EOS to the pipeline before shutting it down. This allows for nice cleanup in case of a muxer. Fixes #625597
2010-08-20 16:17:08 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Add property to decide if sending media should be stopped when a client disconnects without TEARDOWN Without TEARDOWN it might be desireable to keep the media running and continue sending data to the client, even if the RTSP connection itself is disconnected. Only do this for session medias that have only UDP transports. If there's at least on TCP transport, it will stop working and cause problems when the connection is disconnected. https://bugzilla.gnome.org/show_bug.cgi?id=758999
2015-12-09 16:24:24 +00:00
void gst_rtsp_media_factory_set_stop_on_disconnect (GstRTSPMediaFactory *factory,
gboolean stop_on_disconnect);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Add property to decide if sending media should be stopped when a client disconnects without TEARDOWN Without TEARDOWN it might be desireable to keep the media running and continue sending data to the client, even if the RTSP connection itself is disconnected. Only do this for session medias that have only UDP transports. If there's at least on TCP transport, it will stop working and cause problems when the connection is disconnected. https://bugzilla.gnome.org/show_bug.cgi?id=758999
2015-12-09 16:24:24 +00:00
gboolean gst_rtsp_media_factory_is_stop_on_disonnect (GstRTSPMediaFactory *factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: add suspend modes Add support for different suspend modes. The stream is suspended right after producing the SDP and after PAUSE. Different suspend modes are available that affect the state of the pipeline. NONE leaves the pipeline state unchanged and is the current and old behaviour, PAUSE will set the pipeline to the PAUSED state and RESET will bring the pipeline to the NULL state. A stream is also unsuspended when it goes back to PLAYING, for RESET streams, this means that the pipeline needs to be prerolled again. Base on patches by Ognyan Tonchev <ognyan@axis.com> See https://bugzilla.gnome.org/show_bug.cgi?id=711257
2013-11-28 13:10:19 +00:00
void gst_rtsp_media_factory_set_suspend_mode (GstRTSPMediaFactory *factory,
GstRTSPSuspendMode mode);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: add suspend modes Add support for different suspend modes. The stream is suspended right after producing the SDP and after PAUSE. Different suspend modes are available that affect the state of the pipeline. NONE leaves the pipeline state unchanged and is the current and old behaviour, PAUSE will set the pipeline to the PAUSED state and RESET will bring the pipeline to the NULL state. A stream is also unsuspended when it goes back to PLAYING, for RESET streams, this means that the pipeline needs to be prerolled again. Base on patches by Ognyan Tonchev <ognyan@axis.com> See https://bugzilla.gnome.org/show_bug.cgi?id=711257
2013-11-28 13:10:19 +00:00
GstRTSPSuspendMode gst_rtsp_media_factory_get_suspend_mode (GstRTSPMediaFactory *factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
void gst_rtsp_media_factory_set_eos_shutdown (GstRTSPMediaFactory *factory,
gboolean eos_shutdown);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
gboolean gst_rtsp_media_factory_is_eos_shutdown (GstRTSPMediaFactory *factory);
media-factory: add protocols property Add a property to configure the allowed protocols in the media created from the factory.
2011-08-16 13:15:19 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
factory: add profile property and pass to media and streams
2014-03-03 15:55:48 +00:00
void gst_rtsp_media_factory_set_profiles (GstRTSPMediaFactory *factory,
GstRTSPProfile profiles);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
factory: add profile property and pass to media and streams
2014-03-03 15:55:48 +00:00
GstRTSPProfile gst_rtsp_media_factory_get_profiles (GstRTSPMediaFactory *factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
void gst_rtsp_media_factory_set_protocols (GstRTSPMediaFactory *factory,
GstRTSPLowerTrans protocols);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
GstRTSPLowerTrans gst_rtsp_media_factory_get_protocols (GstRTSPMediaFactory *factory);
rtsp: use AddressPool Remove the multicast_group property. Use the configured addresspool to allocate multicast addresses.
2012-11-14 16:23:59 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
void gst_rtsp_media_factory_set_address_pool (GstRTSPMediaFactory * factory,
GstRTSPAddressPool * pool);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
GstRTSPAddressPool * gst_rtsp_media_factory_get_address_pool (GstRTSPMediaFactory * factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Add support for setting the multicast interface https://bugzilla.gnome.org/show_bug.cgi?id=763000
2016-03-02 17:42:13 +00:00
void gst_rtsp_media_factory_set_multicast_iface (GstRTSPMediaFactory *factory, const gchar *multicast_iface);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Add support for setting the multicast interface https://bugzilla.gnome.org/show_bug.cgi?id=763000
2016-03-02 17:42:13 +00:00
gchar * gst_rtsp_media_factory_get_multicast_iface (GstRTSPMediaFactory *factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
void gst_rtsp_media_factory_set_buffer_size (GstRTSPMediaFactory * factory,
guint size);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
guint gst_rtsp_media_factory_get_buffer_size (GstRTSPMediaFactory * factory);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: Add new ensure-keyunit-on-start property While the suspend modes NONE and PAUSED provided a low startup latency for connecting clients they did not ensure that streams started on fresh data. With this property we can maintain the low startup latency of those suspend modes while also ensuring that a stream starts on a key unit. Furthermore, by modifying the value of a new property, ensure-keyunit-on-start-timeout, it is possible to accept a keyunit of a certain age but discard it if too much time has passed and instead force a new keyunit. Fixes #2443 Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/4334>
2023-06-26 06:25:36 +00:00
GST_RTSP_SERVER_API
void gst_rtsp_media_factory_set_ensure_keyunit_on_start (GstRTSPMediaFactory * factory,
gboolean ensure_keyunit_on_start);
GST_RTSP_SERVER_API
gboolean gst_rtsp_media_factory_get_ensure_keyunit_on_start (GstRTSPMediaFactory * factory);
GST_RTSP_SERVER_API
void gst_rtsp_media_factory_set_ensure_keyunit_on_start_timeout (GstRTSPMediaFactory * factory,
guint timeout);
GST_RTSP_SERVER_API
guint gst_rtsp_media_factory_get_ensure_keyunit_on_start_timeout (GstRTSPMediaFactory * factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: implement ssrc-multiplexed retransmission support based off RFC 4588 and the server-rtpaux example in -good
2014-11-26 14:12:36 +00:00
void gst_rtsp_media_factory_set_retransmission_time (GstRTSPMediaFactory * factory,
GstClockTime time);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: implement ssrc-multiplexed retransmission support based off RFC 4588 and the server-rtpaux example in -good
2014-11-26 14:12:36 +00:00
GstClockTime gst_rtsp_media_factory_get_retransmission_time (GstRTSPMediaFactory * factory);
media-factory: add property to configure the buffer-size Add a property to configure the kernel UDP buffer size.
2011-01-31 16:37:02 +00:00
rtsp-server: add API to enable retransmission requests "do-retransmission" was previously set when rtx-time != 0, which made no sense as do-retransmission is used to enable the sending of retransmission requests, where as rtx-time is used by the peer to enable storing of buffers in order to respond to retransmission requests. rtsp-media now also provides a callback for the request-aux-receiver signal. https://bugzilla.gnome.org/show_bug.cgi?id=794822
2018-03-29 20:49:26 +00:00
GST_RTSP_SERVER_API
void gst_rtsp_media_factory_set_do_retransmission (GstRTSPMediaFactory * factory,
gboolean do_retransmission);
GST_RTSP_SERVER_API
gboolean gst_rtsp_media_factory_get_do_retransmission (GstRTSPMediaFactory * factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Expose latency setting for setting the rtpbin latency
2015-01-19 12:20:39 +00:00
void gst_rtsp_media_factory_set_latency (GstRTSPMediaFactory * factory,
guint latency);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Expose latency setting for setting the rtpbin latency
2015-01-19 12:20:39 +00:00
guint gst_rtsp_media_factory_get_latency (GstRTSPMediaFactory * factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Use flags to distinguish between PLAY and RECORD media
2015-01-28 17:54:01 +00:00
void gst_rtsp_media_factory_set_transport_mode (GstRTSPMediaFactory *factory,
GstRTSPTransportMode mode);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Use flags to distinguish between PLAY and RECORD media
2015-01-28 17:54:01 +00:00
GstRTSPTransportMode gst_rtsp_media_factory_get_transport_mode (GstRTSPMediaFactory *factory);
Add initial support for RECORD We currently only support media that is RECORD or PLAY only, not both at once. https://bugzilla.gnome.org/show_bug.cgi?id=743175
2015-01-09 11:40:47 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media-factory: Add functions to set/get the media gtype Allow specifying the GType of a GstRtspMedia subclass to create as a simpler way to get the factory to create a custom GstRtspMedia sub-class, without subclassing GstRtspMediaFactory.
2015-03-02 14:49:42 +00:00
void gst_rtsp_media_factory_set_media_gtype (GstRTSPMediaFactory * factory,
GType media_gtype);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media-factory: Add functions to set/get the media gtype Allow specifying the GType of a GstRtspMedia subclass to create as a simpler way to get the factory to create a custom GstRtspMedia sub-class, without subclassing GstRtspMediaFactory.
2015-03-02 14:49:42 +00:00
GType gst_rtsp_media_factory_get_media_gtype (GstRTSPMediaFactory * factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Add API to directly configure a clock on the media pipelines
2015-12-30 14:31:13 +00:00
void gst_rtsp_media_factory_set_clock (GstRTSPMediaFactory *factory,
GstClock * clock);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-media: Add API to directly configure a clock on the media pipelines
2015-12-30 14:31:13 +00:00
GstClock * gst_rtsp_media_factory_get_clock (GstRTSPMediaFactory *factory);
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-server: Implement clock signalling according to RFC7273 For NTP and PTP clocks we signal the actual clock that is used and signal the direct media clock offset. For all other clocks we at least signal that it's the local sender clock. This allows receivers to know which clock was used to generate the media and its RTP timestamps. Receivers can then implement network synchronization, either absolute or at least relative by getting the sender clock rate directly via NTP/PTP instead of estimating it from RTP timestamps and packet receive times. https://bugzilla.gnome.org/show_bug.cgi?id=760005
2015-12-30 16:39:05 +00:00
void gst_rtsp_media_factory_set_publish_clock_mode (GstRTSPMediaFactory * factory, GstRTSPPublishClockMode mode);
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
rtsp-server: Implement clock signalling according to RFC7273 For NTP and PTP clocks we signal the actual clock that is used and signal the direct media clock offset. For all other clocks we at least signal that it's the local sender clock. This allows receivers to know which clock was used to generate the media and its RTP timestamps. Receivers can then implement network synchronization, either absolute or at least relative by getting the sender clock rate directly via NTP/PTP instead of estimating it from RTP timestamps and packet receive times. https://bugzilla.gnome.org/show_bug.cgi?id=760005
2015-12-30 16:39:05 +00:00
GstRTSPPublishClockMode gst_rtsp_media_factory_get_publish_clock_mode (GstRTSPMediaFactory * factory);
Add new API for setting/getting maximum multicast ttl value Change-Id: I5ef4758188c14785e17fb8fbf42a3dc0cb054233 https://bugzilla.gnome.org/show_bug.cgi?id=793441
2018-07-24 07:35:46 +00:00
GST_RTSP_SERVER_API
gboolean gst_rtsp_media_factory_set_max_mcast_ttl (GstRTSPMediaFactory * factory,
guint ttl);
GST_RTSP_SERVER_API
guint gst_rtsp_media_factory_get_max_mcast_ttl (GstRTSPMediaFactory * factory);
New property for socket binding to mcast addresses By default the multicast sockets are bound to INADDR_ANY, as it's not allowed to bind sockets to multicast addresses in Windows. This default behaviour can be changed by setting bind-mcast-address property on the media-factory object. https://bugzilla.gnome.org/show_bug.cgi?id=797059
2018-09-06 14:17:33 +00:00
GST_RTSP_SERVER_API
void gst_rtsp_media_factory_set_bind_mcast_address (GstRTSPMediaFactory * factory,
gboolean bind_mcast_addr);
GST_RTSP_SERVER_API
gboolean gst_rtsp_media_factory_is_bind_mcast_address (GstRTSPMediaFactory * factory);
media-factory: complete DSCP QoS setting support add dscp_qos setting support at factory and media level to setup IP DSCP field of bounded UDP sinks. Fixes https://gitlab.freedesktop.org/gstreamer/gst-rtsp-server/-/issues/6 Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-rtsp-server/-/merge_requests/120>
2015-03-03 13:42:07 +00:00
GST_RTSP_SERVER_API
void gst_rtsp_media_factory_set_dscp_qos (GstRTSPMediaFactory * factory,
gint dscp_qos);
GST_RTSP_SERVER_API
gint gst_rtsp_media_factory_get_dscp_qos (GstRTSPMediaFactory * factory);
rtsp-media-factory: expose API to disable RTCP This is supported by the RFC, and can be useful on systems where allocating two consecutive ports is problematic, and RTCP is not necessary. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-rtsp-server/-/merge_requests/159>
2020-09-04 19:14:35 +00:00
GST_RTSP_SERVER_API
void gst_rtsp_media_factory_set_enable_rtcp (GstRTSPMediaFactory * factory,
gboolean enable);
GST_RTSP_SERVER_API
gboolean gst_rtsp_media_factory_is_enable_rtcp (GstRTSPMediaFactory * factory);
Add shared properties to media and factory Add the shared property to media. Implement some simple caching in the factory depending on if the media is shared or not.
2009-01-29 16:20:27 +00:00
/* creating the media from the factory and a url */
Mark symbols explicitly for export with GST_EXPORT
2017-05-18 09:35:18 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
GstRTSPMedia * gst_rtsp_media_factory_construct (GstRTSPMediaFactory *factory,
const GstRTSPUrl *url);
rtsp: massive refactoring Make GObjects from the remaining simple structures. Remove GstRTSPSessionStream, it's not needed. Rename GstRTSPMediaStream -> GstRTSPStream: It is shorter Rename GstRTSPMediaTrans -> GstRTSPStreamTransport: It describes how a GstRTSPStream should be transported to a client. Rename GstRTSPMediaFactory::get_element -> create_element because that more accurately describes what it does. Make nice methods instead of poking in the structures. Move some methods inside the relevant object source code. Use GPtrArray to store objects instead of plain arrays, it is more natural and allows us to more easily clean up. Move the allocation of udp ports to the Stream object. The Stream object contains the elements needed to stream the media to a client. Improve the prepare and unprepare methods. Unprepare should now undo everything prepare did. Improve also async unprepare when doing EOS on shutdown. Make sure we always unprepare correctly.
2012-10-25 19:29:58 +00:00
rtsp-server: GST_EXPORT -> GST_RTSP_SERVER_API We need different export decorators for the different libs. For now no actual change though, just rename before the release, and add prelude headers to define the new decorator to GST_EXPORT.
2018-03-13 13:30:41 +00:00
GST_RTSP_SERVER_API
media: make it possible to set permissions Make it possible to set permissions on media and media factory objects
2013-07-09 12:33:43 +00:00
GstElement * gst_rtsp_media_factory_create_element (GstRTSPMediaFactory *factory,
const GstRTSPUrl *url);
Made collect_streams function public
2009-06-12 15:51:44 +00:00
rtsp-server: Add g_autoptr() support to all types https://bugzilla.gnome.org/show_bug.cgi?id=754464
2015-11-10 19:17:18 +00:00
#ifdef G_DEFINE_AUTOPTR_CLEANUP_FUNC
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstRTSPMediaFactory, gst_object_unref)
#endif
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
G_END_DECLS
#endif /* __GST_RTSP_MEDIA_FACTORY_H__ */
Reference in a new issue Copy permalink