2
* Copyright (C) <2007> Wim Taymans <wim.taymans@gmail.com>
6
* This library is free software; you can redistribute it and/or
7
* modify it under the terms of the GNU Library General Public
8
* License as published by the Free Software Foundation; either
9
* version 2 of the License, or (at your option) any later version.
11
* This library is distributed in the hope that it will be useful,
12
* but WITHOUT ANY WARRANTY; without even the implied warranty of
13
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14
* Library General Public License for more details.
16
* You should have received a copy of the GNU Library General Public
17
* License along with this library; if not, write to the
18
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19
* Boston, MA 02111-1307, USA.
23
* SECTION:element-gstrtpssrcdemux
25
* gstrtpssrcdemux acts as a demuxer for RTP packets based on the SSRC of the
26
* packets. Its main purpose is to allow an application to easily receive and
27
* decode an RTP stream with multiple SSRCs.
29
* For each SSRC that is detected, a new pad will be created and the
30
* #GstRtpSsrcDemux::new-ssrc-pad signal will be emitted.
33
* <title>Example pipelines</title>
35
* gst-launch udpsrc caps="application/x-rtp" ! gstrtpssrcdemux ! fakesink
36
* ]| Takes an RTP stream and send the RTP packets with the first detected SSRC
37
* to fakesink, discarding the other SSRCs.
40
* Last reviewed on 2007-05-28 (0.10.5)
48
#include <gst/rtp/gstrtpbuffer.h>
49
#include <gst/rtp/gstrtcpbuffer.h>
51
#include "gstrtpbin-marshal.h"
52
#include "gstrtpssrcdemux.h"
54
GST_DEBUG_CATEGORY_STATIC (gst_rtp_ssrc_demux_debug);
55
#define GST_CAT_DEFAULT gst_rtp_ssrc_demux_debug
57
/* generic templates */
58
static GstStaticPadTemplate rtp_ssrc_demux_sink_template =
59
GST_STATIC_PAD_TEMPLATE ("sink",
62
GST_STATIC_CAPS ("application/x-rtp")
65
static GstStaticPadTemplate rtp_ssrc_demux_rtcp_sink_template =
66
GST_STATIC_PAD_TEMPLATE ("rtcp_sink",
69
GST_STATIC_CAPS ("application/x-rtcp")
72
static GstStaticPadTemplate rtp_ssrc_demux_src_template =
73
GST_STATIC_PAD_TEMPLATE ("src_%d",
76
GST_STATIC_CAPS ("application/x-rtp")
79
static GstStaticPadTemplate rtp_ssrc_demux_rtcp_src_template =
80
GST_STATIC_PAD_TEMPLATE ("rtcp_src_%d",
83
GST_STATIC_CAPS ("application/x-rtcp")
86
static GstElementDetails gst_rtp_ssrc_demux_details = {
89
"Splits RTP streams based on the SSRC",
90
"Wim Taymans <wim.taymans@gmail.com>"
93
#define GST_PAD_LOCK(obj) (g_mutex_lock ((obj)->padlock))
94
#define GST_PAD_UNLOCK(obj) (g_mutex_unlock ((obj)->padlock))
103
GST_BOILERPLATE (GstRtpSsrcDemux, gst_rtp_ssrc_demux, GstElement,
107
/* GObject vmethods */
108
static void gst_rtp_ssrc_demux_dispose (GObject * object);
109
static void gst_rtp_ssrc_demux_finalize (GObject * object);
111
/* GstElement vmethods */
112
static GstStateChangeReturn gst_rtp_ssrc_demux_change_state (GstElement *
113
element, GstStateChange transition);
116
static GstFlowReturn gst_rtp_ssrc_demux_chain (GstPad * pad, GstBuffer * buf);
117
static gboolean gst_rtp_ssrc_demux_sink_event (GstPad * pad, GstEvent * event);
119
static GstFlowReturn gst_rtp_ssrc_demux_rtcp_chain (GstPad * pad,
121
static gboolean gst_rtp_ssrc_demux_rtcp_sink_event (GstPad * pad,
125
static gboolean gst_rtp_ssrc_demux_src_event (GstPad * pad, GstEvent * event);
126
static GList *gst_rtp_ssrc_demux_internal_links (GstPad * pad);
127
static gboolean gst_rtp_ssrc_demux_src_query (GstPad * pad, GstQuery * query);
129
static guint gst_rtp_ssrc_demux_signals[LAST_SIGNAL] = { 0 };
132
* Item for storing GstPad <-> SSRC pairs.
134
struct _GstRtpSsrcDemuxPad
142
/* find a src pad for a given SSRC, returns NULL if the SSRC was not found
144
static GstRtpSsrcDemuxPad *
145
find_demux_pad_for_ssrc (GstRtpSsrcDemux * demux, guint32 ssrc)
149
for (walk = demux->srcpads; walk; walk = g_slist_next (walk)) {
150
GstRtpSsrcDemuxPad *pad = (GstRtpSsrcDemuxPad *) walk->data;
152
if (pad->ssrc == ssrc)
159
static GstRtpSsrcDemuxPad *
160
create_demux_pad_for_ssrc (GstRtpSsrcDemux * demux, guint32 ssrc,
161
GstClockTime timestamp)
163
GstPad *rtp_pad, *rtcp_pad;
164
GstElementClass *klass;
165
GstPadTemplate *templ;
167
GstRtpSsrcDemuxPad *demuxpad;
169
GST_DEBUG_OBJECT (demux, "creating pad for SSRC %08x", ssrc);
171
klass = GST_ELEMENT_GET_CLASS (demux);
172
templ = gst_element_class_get_pad_template (klass, "src_%d");
173
padname = g_strdup_printf ("src_%d", ssrc);
174
rtp_pad = gst_pad_new_from_template (templ, padname);
177
templ = gst_element_class_get_pad_template (klass, "rtcp_src_%d");
178
padname = g_strdup_printf ("rtcp_src_%d", ssrc);
179
rtcp_pad = gst_pad_new_from_template (templ, padname);
182
/* we use the first timestamp received to calculate the difference between
183
* timestamps on all streams */
184
GST_DEBUG_OBJECT (demux, "SSRC %08x, first timestamp %" GST_TIME_FORMAT,
185
ssrc, GST_TIME_ARGS (timestamp));
187
/* wrap in structure and add to list */
188
demuxpad = g_new0 (GstRtpSsrcDemuxPad, 1);
189
demuxpad->ssrc = ssrc;
190
demuxpad->rtp_pad = rtp_pad;
191
demuxpad->rtcp_pad = rtcp_pad;
193
GST_DEBUG_OBJECT (demux, "first timestamp %" GST_TIME_FORMAT,
194
GST_TIME_ARGS (timestamp));
196
gst_pad_set_element_private (rtp_pad, demuxpad);
197
gst_pad_set_element_private (rtcp_pad, demuxpad);
199
demux->srcpads = g_slist_prepend (demux->srcpads, demuxpad);
201
/* copy caps from input */
202
gst_pad_set_caps (rtp_pad, GST_PAD_CAPS (demux->rtp_sink));
203
gst_pad_use_fixed_caps (rtp_pad);
204
gst_pad_set_caps (rtcp_pad, GST_PAD_CAPS (demux->rtcp_sink));
205
gst_pad_use_fixed_caps (rtcp_pad);
207
gst_pad_set_event_function (rtp_pad, gst_rtp_ssrc_demux_src_event);
208
gst_pad_set_query_function (rtp_pad, gst_rtp_ssrc_demux_src_query);
209
gst_pad_set_internal_link_function (rtp_pad,
210
gst_rtp_ssrc_demux_internal_links);
211
gst_pad_set_active (rtp_pad, TRUE);
213
gst_pad_set_internal_link_function (rtcp_pad,
214
gst_rtp_ssrc_demux_internal_links);
215
gst_pad_set_active (rtcp_pad, TRUE);
217
gst_element_add_pad (GST_ELEMENT_CAST (demux), rtp_pad);
218
gst_element_add_pad (GST_ELEMENT_CAST (demux), rtcp_pad);
220
g_signal_emit (G_OBJECT (demux),
221
gst_rtp_ssrc_demux_signals[SIGNAL_NEW_SSRC_PAD], 0, ssrc, rtp_pad);
227
gst_rtp_ssrc_demux_base_init (gpointer g_class)
229
GstElementClass *gstelement_klass = GST_ELEMENT_CLASS (g_class);
231
gst_element_class_add_pad_template (gstelement_klass,
232
gst_static_pad_template_get (&rtp_ssrc_demux_sink_template));
233
gst_element_class_add_pad_template (gstelement_klass,
234
gst_static_pad_template_get (&rtp_ssrc_demux_rtcp_sink_template));
235
gst_element_class_add_pad_template (gstelement_klass,
236
gst_static_pad_template_get (&rtp_ssrc_demux_src_template));
237
gst_element_class_add_pad_template (gstelement_klass,
238
gst_static_pad_template_get (&rtp_ssrc_demux_rtcp_src_template));
240
gst_element_class_set_details (gstelement_klass, &gst_rtp_ssrc_demux_details);
244
gst_rtp_ssrc_demux_class_init (GstRtpSsrcDemuxClass * klass)
246
GObjectClass *gobject_klass;
247
GstElementClass *gstelement_klass;
249
gobject_klass = (GObjectClass *) klass;
250
gstelement_klass = (GstElementClass *) klass;
252
gobject_klass->dispose = GST_DEBUG_FUNCPTR (gst_rtp_ssrc_demux_dispose);
253
gobject_klass->finalize = GST_DEBUG_FUNCPTR (gst_rtp_ssrc_demux_finalize);
256
* GstRtpSsrcDemux::new-ssrc-pad:
257
* @demux: the object which received the signal
258
* @ssrc: the SSRC of the pad
261
* Emited when a new SSRC pad has been created.
263
gst_rtp_ssrc_demux_signals[SIGNAL_NEW_SSRC_PAD] =
264
g_signal_new ("new-ssrc-pad",
265
G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
266
G_STRUCT_OFFSET (GstRtpSsrcDemuxClass, new_ssrc_pad),
267
NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_OBJECT,
268
G_TYPE_NONE, 2, G_TYPE_UINT, GST_TYPE_PAD);
270
gstelement_klass->change_state =
271
GST_DEBUG_FUNCPTR (gst_rtp_ssrc_demux_change_state);
273
GST_DEBUG_CATEGORY_INIT (gst_rtp_ssrc_demux_debug,
274
"rtpssrcdemux", 0, "RTP SSRC demuxer");
278
gst_rtp_ssrc_demux_init (GstRtpSsrcDemux * demux,
279
GstRtpSsrcDemuxClass * g_class)
281
GstElementClass *klass = GST_ELEMENT_GET_CLASS (demux);
284
gst_pad_new_from_template (gst_element_class_get_pad_template (klass,
286
gst_pad_set_chain_function (demux->rtp_sink, gst_rtp_ssrc_demux_chain);
287
gst_pad_set_event_function (demux->rtp_sink, gst_rtp_ssrc_demux_sink_event);
288
gst_element_add_pad (GST_ELEMENT_CAST (demux), demux->rtp_sink);
291
gst_pad_new_from_template (gst_element_class_get_pad_template (klass,
292
"rtcp_sink"), "rtcp_sink");
293
gst_pad_set_chain_function (demux->rtcp_sink, gst_rtp_ssrc_demux_rtcp_chain);
294
gst_pad_set_event_function (demux->rtcp_sink,
295
gst_rtp_ssrc_demux_rtcp_sink_event);
296
gst_element_add_pad (GST_ELEMENT_CAST (demux), demux->rtcp_sink);
298
demux->padlock = g_mutex_new ();
300
gst_segment_init (&demux->segment, GST_FORMAT_UNDEFINED);
304
gst_rtp_ssrc_demux_reset (GstRtpSsrcDemux * demux)
308
for (walk = demux->srcpads; walk; walk = g_slist_next (walk)) {
309
GstRtpSsrcDemuxPad *dpad = (GstRtpSsrcDemuxPad *) walk->data;
311
gst_pad_set_active (dpad->rtp_pad, FALSE);
312
gst_pad_set_active (dpad->rtcp_pad, FALSE);
314
gst_element_remove_pad (GST_ELEMENT_CAST (demux), dpad->rtp_pad);
315
gst_element_remove_pad (GST_ELEMENT_CAST (demux), dpad->rtcp_pad);
318
g_slist_free (demux->srcpads);
319
demux->srcpads = NULL;
323
gst_rtp_ssrc_demux_dispose (GObject * object)
325
GstRtpSsrcDemux *demux;
327
demux = GST_RTP_SSRC_DEMUX (object);
329
gst_rtp_ssrc_demux_reset (demux);
331
G_OBJECT_CLASS (parent_class)->dispose (object);
335
gst_rtp_ssrc_demux_finalize (GObject * object)
337
GstRtpSsrcDemux *demux;
339
demux = GST_RTP_SSRC_DEMUX (object);
340
g_mutex_free (demux->padlock);
342
G_OBJECT_CLASS (parent_class)->finalize (object);
346
gst_rtp_ssrc_demux_sink_event (GstPad * pad, GstEvent * event)
348
GstRtpSsrcDemux *demux;
349
gboolean res = FALSE;
351
demux = GST_RTP_SSRC_DEMUX (gst_pad_get_parent (pad));
353
switch (GST_EVENT_TYPE (event)) {
354
case GST_EVENT_FLUSH_STOP:
355
gst_segment_init (&demux->segment, GST_FORMAT_UNDEFINED);
356
case GST_EVENT_NEWSEGMENT:
362
GST_PAD_LOCK (demux);
363
for (walk = demux->srcpads; walk; walk = g_slist_next (walk)) {
364
GstRtpSsrcDemuxPad *pad = (GstRtpSsrcDemuxPad *) walk->data;
366
gst_event_ref (event);
367
res &= gst_pad_push_event (pad->rtp_pad, event);
369
GST_PAD_UNLOCK (demux);
370
gst_event_unref (event);
375
gst_object_unref (demux);
380
gst_rtp_ssrc_demux_rtcp_sink_event (GstPad * pad, GstEvent * event)
382
GstRtpSsrcDemux *demux;
383
gboolean res = FALSE;
385
demux = GST_RTP_SSRC_DEMUX (gst_pad_get_parent (pad));
387
switch (GST_EVENT_TYPE (event)) {
388
case GST_EVENT_NEWSEGMENT:
394
GST_PAD_LOCK (demux);
395
for (walk = demux->srcpads; walk; walk = g_slist_next (walk)) {
396
GstRtpSsrcDemuxPad *pad = (GstRtpSsrcDemuxPad *) walk->data;
398
gst_event_ref (event);
399
res &= gst_pad_push_event (pad->rtcp_pad, event);
401
GST_PAD_UNLOCK (demux);
402
gst_event_unref (event);
406
gst_object_unref (demux);
411
gst_rtp_ssrc_demux_chain (GstPad * pad, GstBuffer * buf)
414
GstRtpSsrcDemux *demux;
416
GstRtpSsrcDemuxPad *dpad;
418
demux = GST_RTP_SSRC_DEMUX (GST_OBJECT_PARENT (pad));
420
if (!gst_rtp_buffer_validate (buf))
421
goto invalid_payload;
423
ssrc = gst_rtp_buffer_get_ssrc (buf);
425
GST_DEBUG_OBJECT (demux, "received buffer of SSRC %08x", ssrc);
427
GST_PAD_LOCK (demux);
428
dpad = find_demux_pad_for_ssrc (demux, ssrc);
431
create_demux_pad_for_ssrc (demux, ssrc,
432
GST_BUFFER_TIMESTAMP (buf))))
435
GST_PAD_UNLOCK (demux);
438
ret = gst_pad_push (dpad->rtp_pad, buf);
445
/* this is fatal and should be filtered earlier */
446
GST_ELEMENT_ERROR (demux, STREAM, DECODE, (NULL),
447
("Dropping invalid RTP payload"));
448
gst_buffer_unref (buf);
449
return GST_FLOW_ERROR;
453
GST_ELEMENT_ERROR (demux, STREAM, DECODE, (NULL),
454
("Could not create new pad"));
455
GST_PAD_UNLOCK (demux);
456
gst_buffer_unref (buf);
457
return GST_FLOW_ERROR;
462
gst_rtp_ssrc_demux_rtcp_chain (GstPad * pad, GstBuffer * buf)
465
GstRtpSsrcDemux *demux;
467
GstRtpSsrcDemuxPad *dpad;
468
GstRTCPPacket packet;
470
demux = GST_RTP_SSRC_DEMUX (GST_OBJECT_PARENT (pad));
472
if (!gst_rtcp_buffer_validate (buf))
475
if (!gst_rtcp_buffer_get_first_packet (buf, &packet))
478
/* first packet must be SR or RR or else the validate would have failed */
479
switch (gst_rtcp_packet_get_type (&packet)) {
480
case GST_RTCP_TYPE_SR:
481
/* get the ssrc so that we can route it to the right source pad */
482
gst_rtcp_packet_sr_get_sender_info (&packet, &ssrc, NULL, NULL, NULL,
489
GST_DEBUG_OBJECT (demux, "received RTCP of SSRC %08x", ssrc);
491
GST_PAD_LOCK (demux);
492
dpad = find_demux_pad_for_ssrc (demux, ssrc);
494
GST_DEBUG_OBJECT (demux, "creating pad for SSRC %08x", ssrc);
495
if (!(dpad = create_demux_pad_for_ssrc (demux, ssrc, -1)))
498
GST_PAD_UNLOCK (demux);
501
ret = gst_pad_push (dpad->rtcp_pad, buf);
508
/* this is fatal and should be filtered earlier */
509
GST_ELEMENT_ERROR (demux, STREAM, DECODE, (NULL),
510
("Dropping invalid RTCP packet"));
511
gst_buffer_unref (buf);
512
return GST_FLOW_ERROR;
516
GST_ELEMENT_ERROR (demux, STREAM, DECODE, (NULL),
517
("Could not create new pad"));
518
GST_PAD_UNLOCK (demux);
519
gst_buffer_unref (buf);
520
return GST_FLOW_ERROR;
525
gst_rtp_ssrc_demux_src_event (GstPad * pad, GstEvent * event)
527
GstRtpSsrcDemux *demux;
528
gboolean res = FALSE;
530
demux = GST_RTP_SSRC_DEMUX (gst_pad_get_parent (pad));
532
switch (GST_EVENT_TYPE (event)) {
535
res = gst_pad_event_default (pad, event);
538
gst_object_unref (demux);
543
gst_rtp_ssrc_demux_internal_links (GstPad * pad)
545
GstRtpSsrcDemux *demux;
549
demux = GST_RTP_SSRC_DEMUX (gst_pad_get_parent (pad));
551
GST_PAD_LOCK (demux);
552
for (walk = demux->srcpads; walk; walk = g_slist_next (walk)) {
553
GstRtpSsrcDemuxPad *dpad = (GstRtpSsrcDemuxPad *) walk->data;
555
if (pad == demux->rtp_sink) {
556
res = g_list_prepend (res, dpad->rtp_pad);
557
} else if (pad == demux->rtcp_sink) {
558
res = g_list_prepend (res, dpad->rtcp_pad);
559
} else if (pad == dpad->rtp_pad) {
560
res = g_list_prepend (res, demux->rtp_sink);
562
} else if (pad == dpad->rtcp_pad) {
563
res = g_list_prepend (res, demux->rtcp_sink);
567
GST_PAD_UNLOCK (demux);
569
gst_object_unref (demux);
574
gst_rtp_ssrc_demux_src_query (GstPad * pad, GstQuery * query)
576
GstRtpSsrcDemux *demux;
577
gboolean res = FALSE;
579
demux = GST_RTP_SSRC_DEMUX (gst_pad_get_parent (pad));
581
switch (GST_QUERY_TYPE (query)) {
582
case GST_QUERY_LATENCY:
585
if ((res = gst_pad_peer_query (demux->rtp_sink, query))) {
587
GstClockTime min_latency, max_latency;
588
GstRtpSsrcDemuxPad *demuxpad;
590
demuxpad = gst_pad_get_element_private (pad);
592
gst_query_parse_latency (query, &live, &min_latency, &max_latency);
594
GST_DEBUG_OBJECT (demux, "peer min latency %" GST_TIME_FORMAT,
595
GST_TIME_ARGS (min_latency));
597
GST_DEBUG_OBJECT (demux, "latency for SSRC %08x", demuxpad->ssrc);
599
gst_query_set_latency (query, live, min_latency, max_latency);
604
res = gst_pad_query_default (pad, query);
607
gst_object_unref (demux);
612
static GstStateChangeReturn
613
gst_rtp_ssrc_demux_change_state (GstElement * element,
614
GstStateChange transition)
616
GstStateChangeReturn ret;
617
GstRtpSsrcDemux *demux;
619
demux = GST_RTP_SSRC_DEMUX (element);
621
switch (transition) {
622
case GST_STATE_CHANGE_NULL_TO_READY:
623
case GST_STATE_CHANGE_READY_TO_PAUSED:
624
case GST_STATE_CHANGE_PAUSED_TO_PLAYING:
629
ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
631
switch (transition) {
632
case GST_STATE_CHANGE_PLAYING_TO_PAUSED:
634
case GST_STATE_CHANGE_PAUSED_TO_READY:
635
gst_rtp_ssrc_demux_reset (demux);
637
case GST_STATE_CHANGE_READY_TO_NULL: