2 * Copyright (C) 2015 Samsung Electronics Hyunjun Ko <zzoon.ko@samsung.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 native_resolution;
75 guint64 supported_resolution;
79 G_DEFINE_TYPE (GstRTSPWFDServer, gst_rtsp_wfd_server, GST_TYPE_RTSP_SERVER);
81 GST_DEBUG_CATEGORY_STATIC (rtsp_wfd_server_debug);
82 #define GST_CAT_DEFAULT rtsp_wfd_server_debug
84 static void gst_rtsp_wfd_server_get_property (GObject * object, guint propid,
85 GValue * value, GParamSpec * pspec);
86 static void gst_rtsp_wfd_server_set_property (GObject * object, guint propid,
87 const GValue * value, GParamSpec * pspec);
88 static void gst_rtsp_wfd_server_finalize (GObject * object);
90 static GstRTSPClient *create_client_wfd (GstRTSPServer * server);
91 static void client_connected_wfd (GstRTSPServer * server,
92 GstRTSPClient * client);
95 gst_rtsp_wfd_server_class_init (GstRTSPWFDServerClass * klass)
97 GObjectClass *gobject_class;
98 GstRTSPServerClass *rtsp_server_class;
100 g_type_class_add_private (klass, sizeof (GstRTSPWFDServerPrivate));
102 gobject_class = G_OBJECT_CLASS (klass);
103 rtsp_server_class = GST_RTSP_SERVER_CLASS (klass);
105 gobject_class->get_property = gst_rtsp_wfd_server_get_property;
106 gobject_class->set_property = gst_rtsp_wfd_server_set_property;
107 gobject_class->finalize = gst_rtsp_wfd_server_finalize;
109 rtsp_server_class->create_client = create_client_wfd;
110 rtsp_server_class->client_connected = client_connected_wfd;
113 GST_DEBUG_CATEGORY_INIT (rtsp_wfd_server_debug, "rtspwfdserver", 0,
118 gst_rtsp_wfd_server_init (GstRTSPWFDServer * server)
120 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE (server);
122 g_return_if_fail (priv != NULL);
125 server->priv->native_resolution = 0;
126 server->priv->supported_resolution = 1;
127 server->priv->audio_codec = 2;
128 GST_INFO_OBJECT (server, "New server is initialized");
132 gst_rtsp_wfd_server_finalize (GObject * object)
134 GstRTSPWFDServer *server = GST_RTSP_WFD_SERVER (object);
135 //GstRTSPWFDServerPrivate *priv = server->priv;
137 GST_DEBUG_OBJECT (server, "finalize server");
139 G_OBJECT_CLASS (gst_rtsp_wfd_server_parent_class)->finalize (object);
143 * gst_rtsp_server_new:
145 * Create a new #GstRTSPWFDServer instance.
148 gst_rtsp_wfd_server_new (void)
150 GstRTSPWFDServer *result;
152 result = g_object_new (GST_TYPE_RTSP_WFD_SERVER, NULL);
158 gst_rtsp_wfd_server_get_property (GObject * object, guint propid,
159 GValue * value, GParamSpec * pspec)
161 //GstRTSPWFDServer *server = GST_RTSP_WFD_SERVER (object);
165 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
170 gst_rtsp_wfd_server_set_property (GObject * object, guint propid,
171 const GValue * value, GParamSpec * pspec)
173 //GstRTSPWFDServer *server = GST_RTSP_WFD_SERVER (object);
177 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
182 _start_wfd (gpointer data)
184 GstRTSPWFDClient *client = (GstRTSPWFDClient *) data;
186 GST_INFO_OBJECT (client, "WFD client is STARTing");
188 gst_rtsp_wfd_client_start_wfd (client);
193 client_connected_wfd (GstRTSPServer * server, GstRTSPClient * client)
195 GST_INFO_OBJECT (server, "Client is connected");
197 gst_rtsp_wfd_client_set_host_address (GST_RTSP_WFD_CLIENT_CAST (client),
198 gst_rtsp_server_get_address (server));
199 g_idle_add (_start_wfd, client);
203 static GstRTSPClient *
204 create_client_wfd (GstRTSPServer * server)
206 GstRTSPWFDClient *client;
207 GstRTSPThreadPool *thread_pool = NULL;
208 GstRTSPSessionPool *session_pool = NULL;
209 GstRTSPMountPoints *mount_points = NULL;
210 GstRTSPAuth *auth = NULL;
211 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE(server);
213 g_return_val_if_fail (priv != NULL, NULL);
215 GST_INFO_OBJECT (server, "New Client is being created");
217 /* a new client connected, create a session to handle the client. */
218 client = gst_rtsp_wfd_client_new ();
220 thread_pool = gst_rtsp_server_get_thread_pool (server);
221 session_pool = gst_rtsp_server_get_session_pool (server);
222 mount_points = gst_rtsp_server_get_mount_points (server);
223 auth = gst_rtsp_server_get_auth (server);
225 /* set the session pool that this client should use */
226 GST_RTSP_WFD_SERVER_LOCK (server);
227 gst_rtsp_client_set_session_pool (GST_RTSP_CLIENT_CAST (client),
229 /* set the mount points that this client should use */
230 gst_rtsp_client_set_mount_points (GST_RTSP_CLIENT_CAST (client),
232 /* set authentication manager */
233 gst_rtsp_client_set_auth (GST_RTSP_CLIENT_CAST (client), auth);
235 gst_rtsp_client_set_thread_pool (GST_RTSP_CLIENT_CAST (client), thread_pool);
237 gst_rtsp_wfd_client_set_video_supported_resolution (client,
238 priv->supported_resolution);
240 gst_rtsp_wfd_client_set_video_native_resolution (client,
241 priv->native_resolution);
243 gst_rtsp_wfd_client_set_audio_codec (client,
246 GST_RTSP_WFD_SERVER_UNLOCK (server);
248 return GST_RTSP_CLIENT (client);
252 gst_rtsp_wfd_server_trigger_request (GstRTSPServer * server,
253 GstWFDTriggerType type)
255 GstRTSPResult res = GST_RTSP_OK;
256 GList *clients, *walk, *next;
258 g_return_val_if_fail (GST_IS_RTSP_SERVER (server), GST_RTSP_ERROR);
260 clients = gst_rtsp_server_client_filter (server, NULL, NULL);
261 if (clients == NULL) {
262 GST_ERROR_OBJECT (server, "There is no client in this server");
265 for (walk = clients; walk; walk = next) {
266 GstRTSPClient *client = walk->data;
268 next = g_list_next (walk);
271 gst_rtsp_wfd_client_trigger_request (GST_RTSP_WFD_CLIENT (client),
273 if (res != GST_RTSP_OK) {
274 GST_ERROR_OBJECT (server, "Failed to send trigger request %d", type);
276 g_object_unref (client);
284 gst_rtsp_wfd_server_set_supported_reso(GstRTSPWFDServer *server, guint64 supported_reso)
286 GstRTSPResult res = GST_RTSP_OK;
287 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE(server);
289 g_return_val_if_fail (GST_IS_RTSP_WFD_SERVER (server), GST_RTSP_ERROR);
290 g_return_val_if_fail (priv != NULL, GST_RTSP_ERROR);
292 GST_RTSP_WFD_SERVER_LOCK (server);
294 priv->supported_resolution = supported_reso;
296 GST_RTSP_WFD_SERVER_UNLOCK (server);
301 gst_rtsp_wfd_server_set_video_native_reso (GstRTSPWFDServer *server, guint64 native_reso)
303 GstRTSPResult res = GST_RTSP_OK;
304 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE(server);
306 g_return_val_if_fail (GST_IS_RTSP_WFD_SERVER (server), GST_RTSP_ERROR);
307 g_return_val_if_fail (priv != NULL, GST_RTSP_ERROR);
309 GST_RTSP_WFD_SERVER_LOCK (server);
311 priv->native_resolution = native_reso;
313 GST_RTSP_WFD_SERVER_UNLOCK (server);
318 gst_rtsp_wfd_server_set_audio_codec (GstRTSPWFDServer *server, guint8 audio_codec)
320 GstRTSPResult res = GST_RTSP_OK;
321 GstRTSPWFDServerPrivate *priv = GST_RTSP_WFD_SERVER_GET_PRIVATE(server);
323 g_return_val_if_fail (GST_IS_RTSP_WFD_SERVER (server), GST_RTSP_ERROR);
324 g_return_val_if_fail (priv != NULL, GST_RTSP_ERROR);
326 GST_RTSP_WFD_SERVER_LOCK (server);
328 priv->audio_codec = audio_codec;
330 GST_RTSP_WFD_SERVER_UNLOCK (server);