2 * Copyright (C) 2008 Wim Taymans <wim.taymans at gmail.com>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
17 * Boston, MA 02110-1301, USA.
21 * @short_description: The main server object
22 * @see_also: #GstRTSPClient, #GstRTSPThreadPool
24 * The server object is the object listening for connections on a port and
25 * creating #GstRTSPClient objects to handle those connections.
27 * The server will listen on the address set with gst_rtsp_server_set_address()
28 * and the port or service configured with gst_rtsp_server_set_service().
29 * Use gst_rtsp_server_set_backlog() to configure the amount of pending requests
30 * that the server will keep. By default the server listens on the current
31 * network (0.0.0.0) and port 8554.
33 * The server will require an SSL connection when a TLS certificate has been
34 * set in the auth object with gst_rtsp_auth_set_tls_certificate().
36 * To start the server, use gst_rtsp_server_attach() to attach it to a
37 * #GMainContext. For more control, gst_rtsp_server_create_source() and
38 * gst_rtsp_server_create_socket() can be used to get a #GSource and #GSocket
41 * gst_rtsp_server_transfer_connection() can be used to transfer an existing
42 * socket to the RTSP server, for example from an HTTP server.
44 * Once the server socket is attached to a mainloop, it will start accepting
45 * connections. When a new connection is received, a new #GstRTSPClient object
46 * is created to handle the connection. The new client will be configured with
47 * the server #GstRTSPAuth, #GstRTSPMountPoints, #GstRTSPSessionPool and
50 * The server uses the configured #GstRTSPThreadPool object to handle the
51 * remainder of the communication with this client.
53 * Last reviewed on 2013-07-11 (1.0.0)
58 #include "rtsp-server-wfd.h"
59 #include "rtsp-client-wfd.h"
61 #define GST_RTSP_WFD_SERVER_GET_PRIVATE(obj) \
62 (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GST_TYPE_RTSP_WFD_SERVER, GstRTSPWFDServerPrivate))
64 #define GST_RTSP_WFD_SERVER_GET_LOCK(server) (&(GST_RTSP_WFD_SERVER_CAST(server)->priv->lock))
65 #define GST_RTSP_WFD_SERVER_LOCK(server) (g_mutex_lock(GST_RTSP_WFD_SERVER_GET_LOCK(server)))
66 #define GST_RTSP_WFD_SERVER_UNLOCK(server) (g_mutex_unlock(GST_RTSP_WFD_SERVER_GET_LOCK(server)))
68 struct _GstRTSPWFDServerPrivate
70 GMutex lock; /* protects everything in this struct */
72 /* the clients that are connected */
74 guint64 supported_resolution;
77 G_DEFINE_TYPE (GstRTSPWFDServer, gst_rtsp_wfd_server, GST_TYPE_RTSP_SERVER);
79 GST_DEBUG_CATEGORY_STATIC (rtsp_wfd_server_debug);
80 #define GST_CAT_DEFAULT rtsp_wfd_server_debug
82 static void gst_rtsp_wfd_server_get_property (GObject * object, guint propid,
83 GValue * value, GParamSpec * pspec);
84 static void gst_rtsp_wfd_server_set_property (GObject * object, guint propid,
85 const GValue * value, GParamSpec * pspec);
86 static void gst_rtsp_wfd_server_finalize (GObject * object);
88 static GstRTSPClient *create_client_wfd (GstRTSPServer * server);
89 static void client_connected_wfd (GstRTSPServer * server,
90 GstRTSPClient * client);
93 gst_rtsp_wfd_server_class_init (GstRTSPWFDServerClass * klass)
95 GObjectClass *gobject_class;
96 GstRTSPServerClass *rtsp_server_class;
98 g_type_class_add_private (klass, sizeof (GstRTSPWFDServerPrivate));
100 gobject_class = G_OBJECT_CLASS (klass);
101 rtsp_server_class = GST_RTSP_SERVER_CLASS (klass);
103 gobject_class->get_property = gst_rtsp_wfd_server_get_property;
104 gobject_class->set_property = gst_rtsp_wfd_server_set_property;
105 gobject_class->finalize = gst_rtsp_wfd_server_finalize;
107 rtsp_server_class->create_client = create_client_wfd;
108 rtsp_server_class->client_connected = client_connected_wfd;
111 GST_DEBUG_CATEGORY_INIT (rtsp_wfd_server_debug, "rtspwfdserver", 0,
116 gst_rtsp_wfd_server_init (GstRTSPWFDServer * server)
118 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE (server);
121 server->priv->supported_resolution = 1;
122 GST_INFO_OBJECT (server, "New server is initialized");
126 gst_rtsp_wfd_server_finalize (GObject * object)
128 GstRTSPWFDServer *server = GST_RTSP_WFD_SERVER (object);
129 //GstRTSPWFDServerPrivate *priv = server->priv;
131 GST_DEBUG_OBJECT (server, "finalize server");
133 G_OBJECT_CLASS (gst_rtsp_wfd_server_parent_class)->finalize (object);
137 * gst_rtsp_server_new:
139 * Create a new #GstRTSPWFDServer instance.
142 gst_rtsp_wfd_server_new (void)
144 GstRTSPWFDServer *result;
146 result = g_object_new (GST_TYPE_RTSP_WFD_SERVER, NULL);
152 gst_rtsp_wfd_server_get_property (GObject * object, guint propid,
153 GValue * value, GParamSpec * pspec)
155 //GstRTSPWFDServer *server = GST_RTSP_WFD_SERVER (object);
159 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
164 gst_rtsp_wfd_server_set_property (GObject * object, guint propid,
165 const GValue * value, GParamSpec * pspec)
167 //GstRTSPWFDServer *server = GST_RTSP_WFD_SERVER (object);
171 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
176 _start_wfd (gpointer data)
178 GstRTSPWFDClient *client = (GstRTSPWFDClient *) data;
180 GST_INFO_OBJECT (client, "WFD client is STARTing");
182 gst_rtsp_wfd_client_start_wfd (client);
187 client_connected_wfd (GstRTSPServer * server, GstRTSPClient * client)
189 GST_INFO_OBJECT (server, "Client is connected");
191 g_idle_add (_start_wfd, client);
195 static GstRTSPClient *
196 create_client_wfd (GstRTSPServer * server)
198 GstRTSPWFDClient *client;
199 GstRTSPThreadPool *thread_pool = NULL;
200 GstRTSPSessionPool *session_pool = NULL;
201 GstRTSPMountPoints *mount_points = NULL;
202 GstRTSPAuth *auth = NULL;
203 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE(server);
205 GST_INFO_OBJECT (server, "New Client is being created");
207 /* a new client connected, create a session to handle the client. */
208 client = gst_rtsp_wfd_client_new ();
210 thread_pool = gst_rtsp_server_get_thread_pool (server);
211 session_pool = gst_rtsp_server_get_session_pool (server);
212 mount_points = gst_rtsp_server_get_mount_points (server);
213 auth = gst_rtsp_server_get_auth (server);
215 /* set the session pool that this client should use */
216 GST_RTSP_WFD_SERVER_LOCK (server);
217 gst_rtsp_client_set_session_pool (GST_RTSP_CLIENT_CAST (client),
219 /* set the mount points that this client should use */
220 gst_rtsp_client_set_mount_points (GST_RTSP_CLIENT_CAST (client),
222 /* set authentication manager */
223 gst_rtsp_client_set_auth (GST_RTSP_CLIENT_CAST (client), auth);
225 gst_rtsp_client_set_thread_pool (GST_RTSP_CLIENT_CAST (client), thread_pool);
227 gst_rtsp_wfd_client_set_video_supported_resolution (client,
228 priv->supported_resolution);
230 GST_RTSP_WFD_SERVER_UNLOCK (server);
232 return GST_RTSP_CLIENT (client);
236 gst_rtsp_wfd_server_trigger_request (GstRTSPServer * server,
237 GstWFDTriggerType type)
239 GstRTSPResult res = GST_RTSP_OK;
240 GList *clients, *walk, *next;
242 g_return_val_if_fail (GST_IS_RTSP_SERVER (server), GST_RTSP_ERROR);
244 clients = gst_rtsp_server_client_filter (server, NULL, NULL);
245 if (clients == NULL) {
246 GST_ERROR_OBJECT (server, "There is no client in this server");
249 for (walk = clients; walk; walk = next) {
250 GstRTSPClient *client = walk->data;
252 next = g_list_next (walk);
255 gst_rtsp_wfd_client_trigger_request (GST_RTSP_WFD_CLIENT (client),
257 if (res != GST_RTSP_OK) {
258 GST_ERROR_OBJECT (server, "Failed to send trigger request %d", type);
260 g_object_unref (client);
268 gst_rtsp_wfd_server_set_supported_reso(GstRTSPWFDServer *server, guint64 supported_reso)
270 GstRTSPResult res = GST_RTSP_OK;
271 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE(server);
273 g_return_val_if_fail (GST_IS_RTSP_WFD_SERVER (server), GST_RTSP_ERROR);
275 GST_RTSP_WFD_SERVER_LOCK (server);
277 priv->supported_resolution = supported_reso;
279 GST_RTSP_WFD_SERVER_UNLOCK (server);