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 #include "rtsp-session.h"
23 #define GST_RTSP_SESSION_MEDIA_GET_PRIVATE(obj) \
24 (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GST_TYPE_RTSP_SESSION_MEDIA, GstRTSPSessionMediaPrivate))
26 struct _GstRTSPSessionMediaPrivate
34 GPtrArray *transports;
43 GST_DEBUG_CATEGORY_STATIC (rtsp_session_media_debug);
44 #define GST_CAT_DEFAULT rtsp_session_media_debug
46 static void gst_rtsp_session_media_finalize (GObject * obj);
48 G_DEFINE_TYPE (GstRTSPSessionMedia, gst_rtsp_session_media, G_TYPE_OBJECT);
51 gst_rtsp_session_media_class_init (GstRTSPSessionMediaClass * klass)
53 GObjectClass *gobject_class;
55 g_type_class_add_private (klass, sizeof (GstRTSPSessionMediaPrivate));
57 gobject_class = G_OBJECT_CLASS (klass);
59 gobject_class->finalize = gst_rtsp_session_media_finalize;
61 GST_DEBUG_CATEGORY_INIT (rtsp_session_media_debug, "rtspsessionmedia", 0,
62 "GstRTSPSessionMedia");
66 gst_rtsp_session_media_init (GstRTSPSessionMedia * media)
68 GstRTSPSessionMediaPrivate *priv = GST_RTSP_SESSION_MEDIA_GET_PRIVATE (media);
72 g_mutex_init (&priv->lock);
73 priv->state = GST_RTSP_STATE_INIT;
77 gst_rtsp_session_media_finalize (GObject * obj)
79 GstRTSPSessionMedia *media;
80 GstRTSPSessionMediaPrivate *priv;
82 media = GST_RTSP_SESSION_MEDIA (obj);
85 GST_INFO ("free session media %p", media);
87 gst_rtsp_session_media_set_state (media, GST_STATE_NULL);
89 g_ptr_array_unref (priv->transports);
91 gst_rtsp_url_free (priv->url);
92 g_object_unref (priv->media);
93 g_mutex_clear (&priv->lock);
95 G_OBJECT_CLASS (gst_rtsp_session_media_parent_class)->finalize (obj);
99 free_session_media (gpointer data)
102 g_object_unref (data);
106 * gst_rtsp_session_media_new:
107 * @url: the #GstRTSPUrl
108 * @media: the #GstRTSPMedia
110 * Create a new #GstRTPSessionMedia that manages the streams
111 * in @media for @url. @media should be prepared.
113 * Ownership is taken of @media.
115 * Returns: a new #GstRTSPSessionMedia.
117 GstRTSPSessionMedia *
118 gst_rtsp_session_media_new (const GstRTSPUrl * url, GstRTSPMedia * media)
120 GstRTSPSessionMediaPrivate *priv;
121 GstRTSPSessionMedia *result;
124 g_return_val_if_fail (url != NULL, NULL);
125 g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
126 g_return_val_if_fail (gst_rtsp_media_get_status (media) ==
127 GST_RTSP_MEDIA_STATUS_PREPARED, NULL);
129 result = g_object_new (GST_TYPE_RTSP_SESSION_MEDIA, NULL);
132 priv->url = gst_rtsp_url_copy ((GstRTSPUrl *) url);
135 /* prealloc the streams now, filled with NULL */
136 n_streams = gst_rtsp_media_n_streams (media);
137 priv->transports = g_ptr_array_new_full (n_streams, free_session_media);
138 g_ptr_array_set_size (priv->transports, n_streams);
144 * gst_rtsp_session_media_matches_url:
145 * @media: a #GstRTSPSessionMedia
146 * @url: a #GstRTSPUrl
148 * Check if the url of @media matches @url.
150 * Returns: %TRUE when @url matches the url of @media.
153 gst_rtsp_session_media_matches_url (GstRTSPSessionMedia * media,
154 const GstRTSPUrl * url)
156 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media), FALSE);
157 g_return_val_if_fail (url != NULL, FALSE);
159 return g_str_equal (media->priv->url->abspath, url->abspath);
163 * gst_rtsp_session_media_get_media:
164 * @media: a #GstRTSPSessionMedia
166 * Get the #GstRTSPMedia that was used when constructing @media
168 * Returns: (transfer none): the #GstRTSPMedia of @media. Remains valid as long
169 * as @media is valid.
172 gst_rtsp_session_media_get_media (GstRTSPSessionMedia * media)
174 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media), NULL);
176 return media->priv->media;
180 * gst_rtsp_session_media_set_transport:
181 * @media: a #GstRTSPSessionMedia
182 * @stream: a #GstRTSPStream
183 * @tr: a #GstRTSPTransport
185 * Configure the transport for @stream to @tr in @media.
187 * Returns: (transfer none): the new or updated #GstRTSPStreamTransport for @stream.
189 GstRTSPStreamTransport *
190 gst_rtsp_session_media_set_transport (GstRTSPSessionMedia * media,
191 GstRTSPStream * stream, GstRTSPTransport * tr)
193 GstRTSPSessionMediaPrivate *priv;
194 GstRTSPStreamTransport *result;
197 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media), NULL);
198 g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
199 g_return_val_if_fail (tr != NULL, NULL);
201 idx = gst_rtsp_stream_get_index (stream);
202 g_return_val_if_fail (idx < priv->transports->len, NULL);
204 g_mutex_lock (&priv->lock);
205 result = g_ptr_array_index (priv->transports, idx);
206 if (result == NULL) {
207 result = gst_rtsp_stream_transport_new (stream, tr);
208 g_ptr_array_index (priv->transports, idx) = result;
209 g_mutex_unlock (&priv->lock);
211 gst_rtsp_stream_transport_set_transport (result, tr);
212 g_mutex_unlock (&priv->lock);
219 * gst_rtsp_session_media_get_transport:
220 * @media: a #GstRTSPSessionMedia
221 * @idx: the stream index
223 * Get a previously created #GstRTSPStreamTransport for the stream at @idx.
225 * Returns: (transfer none): a #GstRTSPStreamTransport that is valid until the
226 * session of @media is unreffed.
228 GstRTSPStreamTransport *
229 gst_rtsp_session_media_get_transport (GstRTSPSessionMedia * media, guint idx)
231 GstRTSPSessionMediaPrivate *priv;
232 GstRTSPStreamTransport *result;
234 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media), NULL);
236 g_return_val_if_fail (idx < priv->transports->len, NULL);
238 g_mutex_lock (&priv->lock);
239 result = g_ptr_array_index (priv->transports, idx);
240 g_mutex_unlock (&priv->lock);
246 * gst_rtsp_session_media_alloc_channels:
247 * @media: a #GstRTSPSessionMedia
248 * @range: a #GstRTSPRange
250 * Fill @range with the next available min and max channels for
251 * interleaved transport.
253 * Returns: %TRUE on success.
256 gst_rtsp_session_media_alloc_channels (GstRTSPSessionMedia * media,
257 GstRTSPRange * range)
259 GstRTSPSessionMediaPrivate *priv;
261 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media), FALSE);
265 g_mutex_lock (&priv->lock);
266 range->min = priv->counter++;
267 range->max = priv->counter++;
268 g_mutex_unlock (&priv->lock);
274 * gst_rtsp_session_media_set_state:
275 * @media: a #GstRTSPSessionMedia
276 * @state: the new state
278 * Tell the media object @media to change to @state.
280 * Returns: %TRUE on success.
283 gst_rtsp_session_media_set_state (GstRTSPSessionMedia * media, GstState state)
285 GstRTSPSessionMediaPrivate *priv;
288 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media), FALSE);
292 g_mutex_lock (&priv->lock);
293 ret = gst_rtsp_media_set_state (priv->media, state, priv->transports);
294 g_mutex_unlock (&priv->lock);
300 * gst_rtsp_session_media_set_rtsp_state:
301 * @media: a #GstRTSPSessionMedia
302 * @state: a #GstRTSPState
304 * Set the RTSP state of @media to @state.
307 gst_rtsp_session_media_set_rtsp_state (GstRTSPSessionMedia * media,
310 GstRTSPSessionMediaPrivate *priv;
312 g_return_if_fail (GST_IS_RTSP_SESSION_MEDIA (media));
316 g_mutex_lock (&priv->lock);
318 g_mutex_unlock (&priv->lock);
322 * gst_rtsp_session_media_set_rtsp_state:
323 * @media: a #GstRTSPSessionMedia
325 * Get the current RTSP state of @media.
327 * Returns: the current RTSP state of @media.
330 gst_rtsp_session_media_get_rtsp_state (GstRTSPSessionMedia * media)
332 GstRTSPSessionMediaPrivate *priv;
335 g_return_val_if_fail (GST_IS_RTSP_SESSION_MEDIA (media),
336 GST_RTSP_STATE_INVALID);
340 g_mutex_lock (&priv->lock);
342 g_mutex_unlock (&priv->lock);