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

143 lines
7.2 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;
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.
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.
media-factory: fix typo
2013-06-26 14:31:39 +00:00
* @media_constructed: signal emited when a media was constructed
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_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);
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);
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 */
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);
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
docs: improve docs
2013-07-11 14:57:14 +00:00
void gst_rtsp_media_factory_set_permissions (GstRTSPMediaFactory *factory,
GstRTSPPermissions *permissions);
GstRTSPPermissions * gst_rtsp_media_factory_get_permissions (GstRTSPMediaFactory *factory);
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
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);
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
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);
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
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);
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
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);
GstRTSPAddressPool * gst_rtsp_media_factory_get_address_pool (GstRTSPMediaFactory * factory);
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 to configure the buffer-size Add a property to configure the kernel UDP buffer size.
2011-01-31 16:37:02 +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 */
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
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
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