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

158 lines
7.6 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-factory: add methods to configure authorisation
2011-01-12 11:07:40 +00:00
#include "rtsp-auth.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-server: port to new thread API
2012-05-11 07:42:47 +00:00
#define GST_RTSP_MEDIA_FACTORY_GET_LOCK(f) (&(GST_RTSP_MEDIA_FACTORY_CAST(f)->lock))
media-factory: make lock macro
2010-12-11 12:41:24 +00:00
#define GST_RTSP_MEDIA_FACTORY_LOCK(f) (g_mutex_lock(GST_RTSP_MEDIA_FACTORY_GET_LOCK(f)))
#define GST_RTSP_MEDIA_FACTORY_UNLOCK(f) (g_mutex_unlock(GST_RTSP_MEDIA_FACTORY_GET_LOCK(f)))
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
/**
* GstRTSPMediaFactory:
docs: update docs
2012-10-26 10:33:21 +00:00
* @parent: the parent GObject
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
* @lock: mutex protecting the datastructure.
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
* @launch: the launch description
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
* @shared: if media from this factory can be shared between clients
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
* @eos_shutdown: if shutdown should first send EOS to the pipeline
* @protocols: allowed transport protocols
* @auth: the authentication manager
* @buffer_size: the kernel udp buffer size
* @multicast_group: the multicast group to send to
* @medias_lock: mutex protecting the medias.
* @medias: hashtable of shared media
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
* 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
rtsp-server: port to new thread API
2012-05-11 07:42:47 +00:00
GMutex lock;
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
gchar *launch;
gboolean shared;
gboolean eos_shutdown;
GstRTSPLowerTrans protocols;
GstRTSPAuth *auth;
guint buffer_size;
gchar *multicast_group;
rtsp-server: port to new thread API
2012-05-11 07:42:47 +00:00
GMutex medias_lock;
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
GHashTable *medias;
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
* payloaders pay%d for each stream. The default implementation of this
* 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
Make element creation more extendible Add get_element vmethod to the default MediaFactory so that subclasses can just override that method and still use the default logic for making a MediaBin from that.
2009-01-22 15:51:08 +00:00
* pay%d to create the streams.
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
* @configure: configure the media created with @construct. The default
* implementation will configure the 'shared' property of the media.
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.
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
* @media_constructed: signal emited when a media was cunstructed
* @media_configure: signal emited 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);
void (*configure) (GstRTSPMediaFactory *factory, GstRTSPMedia *media);
GstElement * (*create_pipeline) (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);
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 */
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 */
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
void gst_rtsp_media_factory_set_launch (GstRTSPMediaFactory *factory,
const gchar *launch);
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
gchar * gst_rtsp_media_factory_get_launch (GstRTSPMediaFactory *factory);
Add media factory to map urls to media pipeline objects.
2009-01-20 18:44:45 +00:00
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
void gst_rtsp_media_factory_set_shared (GstRTSPMediaFactory *factory,
gboolean shared);
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
void gst_rtsp_media_factory_set_eos_shutdown (GstRTSPMediaFactory *factory,
gboolean eos_shutdown);
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
void gst_rtsp_media_factory_set_protocols (GstRTSPMediaFactory *factory, GstRTSPLowerTrans protocols);
GstRTSPLowerTrans gst_rtsp_media_factory_get_protocols (GstRTSPMediaFactory *factory);
media-factory: add methods to configure authorisation
2011-01-12 11:07:40 +00:00
void gst_rtsp_media_factory_set_auth (GstRTSPMediaFactory *factory, GstRTSPAuth *auth);
GstRTSPAuth * gst_rtsp_media_factory_get_auth (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
void gst_rtsp_media_factory_set_buffer_size (GstRTSPMediaFactory * factory, guint size);
guint gst_rtsp_media_factory_get_buffer_size (GstRTSPMediaFactory * factory);
media-factory: add property for multicast group Add a property to configure the multicast group in the media factory. Based on patches from Marc Leeman and Robert Krakora.
2011-08-16 11:13:36 +00:00
void gst_rtsp_media_factory_set_multicast_group (GstRTSPMediaFactory * factory, const gchar *mc);
gchar * gst_rtsp_media_factory_get_multicast_group (GstRTSPMediaFactory * factory);
media-factory: add methods to configure authorisation
2011-01-12 11:07:40 +00:00
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 */
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
GstRTSPMedia * gst_rtsp_media_factory_construct (GstRTSPMediaFactory *factory,
const GstRTSPUrl *url);
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
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