gst/rtpmanager/gstrtpbin.c

   1 /* GStreamer
   2  * Copyright (C) <2007> Wim Taymans <wim.taymans@gmail.com>
   3  *
   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.
   8  *
   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.
  13  *
  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., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /**
  21  * SECTION:element-gstrtpbin
  22  * @see_also: gstrtpjitterbuffer, gstrtpsession, gstrtpptdemux, gstrtpssrcdemux
  23  *
  24  * RTP bin combines the functions of #GstRtpSession, #GstRtpSsrcDemux,
  25  * #GstRtpJitterBuffer and #GstRtpPtDemux in one element. It allows for multiple
  26  * RTP sessions that will be synchronized together using RTCP SR packets.
  27  *
  28  * #GstRtpBin is configured with a number of request pads that define the
  29  * functionality that is activated, similar to the #GstRtpSession element.
  30  *
  31  * To use #GstRtpBin as an RTP receiver, request a recv_rtp_sink_\%d pad. The session
  32  * number must be specified in the pad name.
  33  * Data received on the recv_rtp_sink_\%d pad will be processed in the #GstRtpSession
  34  * manager and after being validated forwarded on #GstRtpSsrcDemux element. Each
  35  * RTP stream is demuxed based on the SSRC and send to a #GstRtpJitterBuffer. After
  36  * the packets are released from the jitterbuffer, they will be forwarded to a
  37  * #GstRtpPtDemux element. The #GstRtpPtDemux element will demux the packets based
  38  * on the payload type and will create a unique pad recv_rtp_src_\%d_\%d_\%d on
  39  * gstrtpbin with the session number, SSRC and payload type respectively as the pad
  40  * name.
  41  *
  42  * To also use #GstRtpBin as an RTCP receiver, request a recv_rtcp_sink_\%d pad. The
  43  * session number must be specified in the pad name.
  44  *
  45  * If you want the session manager to generate and send RTCP packets, request
  46  * the send_rtcp_src_\%d pad with the session number in the pad name. Packet pushed
  47  * on this pad contain SR/RR RTCP reports that should be sent to all participants
  48  * in the session.
  49  *
  50  * To use #GstRtpBin as a sender, request a send_rtp_sink_\%d pad, which will
  51  * automatically create a send_rtp_src_\%d pad. If the session number is not provided,
  52  * the pad from the lowest available session will be returned. The session manager will modify the
  53  * SSRC in the RTP packets to its own SSRC and wil forward the packets on the
  54  * send_rtp_src_\%d pad after updating its internal state.
  55  *
  56  * The session manager needs the clock-rate of the payload types it is handling
  57  * and will signal the #GstRtpSession::request-pt-map signal when it needs such a
  58  * mapping. One can clear the cached values with the #GstRtpSession::clear-pt-map
  59  * signal.
  60  *
  61  * Access to the internal statistics of gstrtpbin is provided with the
  62  * get-internal-session property. This action signal gives access to the
  63  * RTPSession object which further provides action signals to retrieve the
  64  * internal source and other sources.
  65  *
  66  * <refsect2>
  67  * <title>Example pipelines</title>
  68  * |[
  69  * gst-launch udpsrc port=5000 caps="application/x-rtp, ..." ! .recv_rtp_sink_0 \
  70  *     gstrtpbin ! rtptheoradepay ! theoradec ! xvimagesink
  71  * ]| Receive RTP data from port 5000 and send to the session 0 in gstrtpbin.
  72  * |[
  73  * gst-launch gstrtpbin name=rtpbin \
  74  *         v4l2src ! ffmpegcolorspace ! ffenc_h263 ! rtph263ppay ! rtpbin.send_rtp_sink_0 \
  75  *                   rtpbin.send_rtp_src_0 ! udpsink port=5000                            \
  76  *                   rtpbin.send_rtcp_src_0 ! udpsink port=5001 sync=false async=false    \
  77  *                   udpsrc port=5005 ! rtpbin.recv_rtcp_sink_0                           \
  78  *         audiotestsrc ! amrnbenc ! rtpamrpay ! rtpbin.send_rtp_sink_1                   \
  79  *                   rtpbin.send_rtp_src_1 ! udpsink port=5002                            \
  80  *                   rtpbin.send_rtcp_src_1 ! udpsink port=5003 sync=false async=false    \
  81  *                   udpsrc port=5007 ! rtpbin.recv_rtcp_sink_1
  82  * ]| Encode and payload H263 video captured from a v4l2src. Encode and payload AMR
  83  * audio generated from audiotestsrc. The video is sent to session 0 in rtpbin
  84  * and the audio is sent to session 1. Video packets are sent on UDP port 5000
  85  * and audio packets on port 5002. The video RTCP packets for session 0 are sent
  86  * on port 5001 and the audio RTCP packets for session 0 are sent on port 5003.
  87  * RTCP packets for session 0 are received on port 5005 and RTCP for session 1
  88  * is received on port 5007. Since RTCP packets from the sender should be sent
  89  * as soon as possible and do not participate in preroll, sync=false and
  90  * async=false is configured on udpsink
  91  * |[
  92  * gst-launch -v gstrtpbin name=rtpbin                                          \
  93  *     udpsrc caps="application/x-rtp,media=(string)video,clock-rate=(int)90000,encoding-name=(string)H263-1998" \
  94  *             port=5000 ! rtpbin.recv_rtp_sink_0                                \
  95  *         rtpbin. ! rtph263pdepay ! ffdec_h263 ! xvimagesink                    \
  96  *      udpsrc port=5001 ! rtpbin.recv_rtcp_sink_0                               \
  97  *      rtpbin.send_rtcp_src_0 ! udpsink port=5005 sync=false async=false        \
  98  *     udpsrc caps="application/x-rtp,media=(string)audio,clock-rate=(int)8000,encoding-name=(string)AMR,encoding-params=(string)1,octet-align=(string)1" \
  99  *             port=5002 ! rtpbin.recv_rtp_sink_1                                \
 100  *         rtpbin. ! rtpamrdepay ! amrnbdec ! alsasink                           \
 101  *      udpsrc port=5003 ! rtpbin.recv_rtcp_sink_1                               \
 102  *      rtpbin.send_rtcp_src_1 ! udpsink port=5007 sync=false async=false
 103  * ]| Receive H263 on port 5000, send it through rtpbin in session 0, depayload,
 104  * decode and display the video.
 105  * Receive AMR on port 5002, send it through rtpbin in session 1, depayload,
 106  * decode and play the audio.
 107  * Receive server RTCP packets for session 0 on port 5001 and RTCP packets for
 108  * session 1 on port 5003. These packets will be used for session management and
 109  * synchronisation.
 110  * Send RTCP reports for session 0 on port 5005 and RTCP reports for session 1
 111  * on port 5007.
 112  * </refsect2>
 113  *
 114  * Last reviewed on 2007-08-30 (0.10.6)
 115  */
 116
 117 #ifdef HAVE_CONFIG_H
 118 #include "config.h"
 119 #endif
 120 #include <stdio.h>
 121 #include <string.h>
 122
 123 #include <gst/rtp/gstrtpbuffer.h>
 124 #include <gst/rtp/gstrtcpbuffer.h>
 125
 126 #include "gstrtpbin-marshal.h"
 127 #include "gstrtpbin.h"
 128 #include "rtpsession.h"
 129 #include "gstrtpsession.h"
 130 #include "gstrtpjitterbuffer.h"
 131
 132 GST_DEBUG_CATEGORY_STATIC (gst_rtp_bin_debug);
 133 #define GST_CAT_DEFAULT gst_rtp_bin_debug
 134
 135 /* sink pads */
 136 static GstStaticPadTemplate rtpbin_recv_rtp_sink_template =
 137 GST_STATIC_PAD_TEMPLATE ("recv_rtp_sink_%d",
 138     GST_PAD_SINK,
 139     GST_PAD_REQUEST,
 140     GST_STATIC_CAPS ("application/x-rtp")
 141     );
 142
 143 static GstStaticPadTemplate rtpbin_recv_rtcp_sink_template =
 144 GST_STATIC_PAD_TEMPLATE ("recv_rtcp_sink_%d",
 145     GST_PAD_SINK,
 146     GST_PAD_REQUEST,
 147     GST_STATIC_CAPS ("application/x-rtcp")
 148     );
 149
 150 static GstStaticPadTemplate rtpbin_send_rtp_sink_template =
 151 GST_STATIC_PAD_TEMPLATE ("send_rtp_sink_%d",
 152     GST_PAD_SINK,
 153     GST_PAD_REQUEST,
 154     GST_STATIC_CAPS ("application/x-rtp")
 155     );
 156
 157 /* src pads */
 158 static GstStaticPadTemplate rtpbin_recv_rtp_src_template =
 159 GST_STATIC_PAD_TEMPLATE ("recv_rtp_src_%d_%d_%d",
 160     GST_PAD_SRC,
 161     GST_PAD_SOMETIMES,
 162     GST_STATIC_CAPS ("application/x-rtp")
 163     );
 164
 165 static GstStaticPadTemplate rtpbin_send_rtcp_src_template =
 166 GST_STATIC_PAD_TEMPLATE ("send_rtcp_src_%d",
 167     GST_PAD_SRC,
 168     GST_PAD_REQUEST,
 169     GST_STATIC_CAPS ("application/x-rtcp")
 170     );
 171
 172 static GstStaticPadTemplate rtpbin_send_rtp_src_template =
 173 GST_STATIC_PAD_TEMPLATE ("send_rtp_src_%d",
 174     GST_PAD_SRC,
 175     GST_PAD_SOMETIMES,
 176     GST_STATIC_CAPS ("application/x-rtp")
 177     );
 178
 179 #define GST_RTP_BIN_GET_PRIVATE(obj)  \
 180    (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GST_TYPE_RTP_BIN, GstRtpBinPrivate))
 181
 182 #define GST_RTP_BIN_LOCK(bin)   g_mutex_lock ((bin)->priv->bin_lock)
 183 #define GST_RTP_BIN_UNLOCK(bin) g_mutex_unlock ((bin)->priv->bin_lock)
 184
 185 /* lock to protect dynamic callbacks, like pad-added and new ssrc. */
 186 #define GST_RTP_BIN_DYN_LOCK(bin)    g_mutex_lock ((bin)->priv->dyn_lock)
 187 #define GST_RTP_BIN_DYN_UNLOCK(bin)  g_mutex_unlock ((bin)->priv->dyn_lock)
 188
 189 /* lock for shutdown */
 190 #define GST_RTP_BIN_SHUTDOWN_LOCK(bin,label)     \
 191 G_STMT_START {                                   \
 192   if (g_atomic_int_get (&bin->priv->shutdown))   \
 193     goto label;                                  \
 194   GST_RTP_BIN_DYN_LOCK (bin);                    \
 195   if (g_atomic_int_get (&bin->priv->shutdown)) { \
 196     GST_RTP_BIN_DYN_UNLOCK (bin);                \
 197     goto label;                                  \
 198   }                                              \
 199 } G_STMT_END
 200
 201 /* unlock for shutdown */
 202 #define GST_RTP_BIN_SHUTDOWN_UNLOCK(bin)         \
 203   GST_RTP_BIN_DYN_UNLOCK (bin);                  \
 204
 205 struct _GstRtpBinPrivate
 206 {
 207   GMutex *bin_lock;
 208
 209   /* lock protecting dynamic adding/removing */
 210   GMutex *dyn_lock;
 211
 212   /* if we are shutting down or not */
 213   gint shutdown;
 214
 215   gboolean autoremove;
 216 };
 217
 218 /* signals and args */
 219 enum
 220 {
 221   SIGNAL_REQUEST_PT_MAP,
 222   SIGNAL_PAYLOAD_TYPE_CHANGE,
 223   SIGNAL_CLEAR_PT_MAP,
 224   SIGNAL_RESET_SYNC,
 225   SIGNAL_GET_INTERNAL_SESSION,
 226
 227   SIGNAL_ON_NEW_SSRC,
 228   SIGNAL_ON_SSRC_COLLISION,
 229   SIGNAL_ON_SSRC_VALIDATED,
 230   SIGNAL_ON_SSRC_ACTIVE,
 231   SIGNAL_ON_SSRC_SDES,
 232   SIGNAL_ON_BYE_SSRC,
 233   SIGNAL_ON_BYE_TIMEOUT,
 234   SIGNAL_ON_TIMEOUT,
 235   SIGNAL_ON_SENDER_TIMEOUT,
 236   SIGNAL_ON_NPT_STOP,
 237   LAST_SIGNAL
 238 };
 239
 240 #define DEFAULT_LATENCY_MS           200
 241 #define DEFAULT_SDES                 NULL
 242 #define DEFAULT_DO_LOST              FALSE
 243 #define DEFAULT_IGNORE_PT            FALSE
 244 #define DEFAULT_NTP_SYNC             FALSE
 245 #define DEFAULT_AUTOREMOVE           FALSE
 246 #define DEFAULT_BUFFER_MODE          RTP_JITTER_BUFFER_MODE_SLAVE
 247 #define DEFAULT_USE_PIPELINE_CLOCK   FALSE
 248
 249 enum
 250 {
 251   PROP_0,
 252   PROP_LATENCY,
 253   PROP_SDES,
 254   PROP_DO_LOST,
 255   PROP_IGNORE_PT,
 256   PROP_NTP_SYNC,
 257   PROP_AUTOREMOVE,
 258   PROP_BUFFER_MODE,
 259   PROP_USE_PIPELINE_CLOCK,
 260   PROP_LAST
 261 };
 262
 263 /* helper objects */
 264 typedef struct _GstRtpBinSession GstRtpBinSession;
 265 typedef struct _GstRtpBinStream GstRtpBinStream;
 266 typedef struct _GstRtpBinClient GstRtpBinClient;
 267
 268 static guint gst_rtp_bin_signals[LAST_SIGNAL] = { 0 };
 269
 270 static GstCaps *pt_map_requested (GstElement * element, guint pt,
 271     GstRtpBinSession * session);
 272 static void payload_type_change (GstElement * element, guint pt,
 273     GstRtpBinSession * session);
 274 static void free_client (GstRtpBinClient * client, GstRtpBin * bin);
 275 static void free_stream (GstRtpBinStream * stream);
 276
 277 /* Manages the RTP stream for one SSRC.
 278  *
 279  * We pipe the stream (comming from the SSRC demuxer) into a jitterbuffer.
 280  * If we see an SDES RTCP packet that links multiple SSRCs together based on a
 281  * common CNAME, we create a GstRtpBinClient structure to group the SSRCs
 282  * together (see below).
 283  */
 284 struct _GstRtpBinStream
 285 {
 286   /* the SSRC of this stream */
 287   guint32 ssrc;
 288
 289   /* parent bin */
 290   GstRtpBin *bin;
 291
 292   /* the session this SSRC belongs to */
 293   GstRtpBinSession *session;
 294
 295   /* the jitterbuffer of the SSRC */
 296   GstElement *buffer;
 297   gulong buffer_handlesync_sig;
 298   gulong buffer_ptreq_sig;
 299   gulong buffer_ntpstop_sig;
 300   gint percent;
 301
 302   /* the PT demuxer of the SSRC */
 303   GstElement *demux;
 304   gulong demux_newpad_sig;
 305   gulong demux_padremoved_sig;
 306   gulong demux_ptreq_sig;
 307   gulong demux_ptchange_sig;
 308
 309   /* if we have calculated a valid rt_delta for this stream */
 310   gboolean have_sync;
 311   /* mapping to local RTP and NTP time */
 312   gint64 rt_delta;
 313 };
 314
 315 #define GST_RTP_SESSION_LOCK(sess)   g_mutex_lock ((sess)->lock)
 316 #define GST_RTP_SESSION_UNLOCK(sess) g_mutex_unlock ((sess)->lock)
 317
 318 /* Manages the receiving end of the packets.
 319  *
 320  * There is one such structure for each RTP session (audio/video/...).
 321  * We get the RTP/RTCP packets and stuff them into the session manager. From
 322  * there they are pushed into an SSRC demuxer that splits the stream based on
 323  * SSRC. Each of the SSRC streams go into their own jitterbuffer (managed with
 324  * the GstRtpBinStream above).
 325  */
 326 struct _GstRtpBinSession
 327 {
 328   /* session id */
 329   gint id;
 330   /* the parent bin */
 331   GstRtpBin *bin;
 332   /* the session element */
 333   GstElement *session;
 334   /* the SSRC demuxer */
 335   GstElement *demux;
 336   gulong demux_newpad_sig;
 337   gulong demux_padremoved_sig;
 338
 339   GMutex *lock;
 340
 341   /* list of GstRtpBinStream */
 342   GSList *streams;
 343
 344   /* mapping of payload type to caps */
 345   GHashTable *ptmap;
 346
 347   /* the pads of the session */
 348   GstPad *recv_rtp_sink;
 349   GstPad *recv_rtp_sink_ghost;
 350   GstPad *recv_rtp_src;
 351   GstPad *recv_rtcp_sink;
 352   GstPad *recv_rtcp_sink_ghost;
 353   GstPad *sync_src;
 354   GstPad *send_rtp_sink;
 355   GstPad *send_rtp_sink_ghost;
 356   GstPad *send_rtp_src;
 357   GstPad *send_rtp_src_ghost;
 358   GstPad *send_rtcp_src;
 359   GstPad *send_rtcp_src_ghost;
 360 };
 361
 362 /* Manages the RTP streams that come from one client and should therefore be
 363  * synchronized.
 364  */
 365 struct _GstRtpBinClient
 366 {
 367   /* the common CNAME for the streams */
 368   gchar *cname;
 369   guint cname_len;
 370
 371   /* the streams */
 372   guint nstreams;
 373   GSList *streams;
 374 };
 375
 376 /* find a session with the given id. Must be called with RTP_BIN_LOCK */
 377 static GstRtpBinSession *
 378 find_session_by_id (GstRtpBin * rtpbin, gint id)
 379 {
 380   GSList *walk;
 381
 382   for (walk = rtpbin->sessions; walk; walk = g_slist_next (walk)) {
 383     GstRtpBinSession *sess = (GstRtpBinSession *) walk->data;
 384
 385     if (sess->id == id)
 386       return sess;
 387   }
 388   return NULL;
 389 }
 390
 391 /* find a session with the given request pad. Must be called with RTP_BIN_LOCK */
 392 static GstRtpBinSession *
 393 find_session_by_pad (GstRtpBin * rtpbin, GstPad * pad)
 394 {
 395   GSList *walk;
 396
 397   for (walk = rtpbin->sessions; walk; walk = g_slist_next (walk)) {
 398     GstRtpBinSession *sess = (GstRtpBinSession *) walk->data;
 399
 400     if ((sess->recv_rtp_sink_ghost == pad) ||
 401         (sess->recv_rtcp_sink_ghost == pad) ||
 402         (sess->send_rtp_sink_ghost == pad)
 403         || (sess->send_rtcp_src_ghost == pad))
 404       return sess;
 405   }
 406   return NULL;
 407 }
 408
 409 static void
 410 on_new_ssrc (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 411 {
 412   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_NEW_SSRC], 0,
 413       sess->id, ssrc);
 414 }
 415
 416 static void
 417 on_ssrc_collision (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 418 {
 419   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_SSRC_COLLISION], 0,
 420       sess->id, ssrc);
 421 }
 422
 423 static void
 424 on_ssrc_validated (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 425 {
 426   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_SSRC_VALIDATED], 0,
 427       sess->id, ssrc);
 428 }
 429
 430 static void
 431 on_ssrc_active (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 432 {
 433   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_SSRC_ACTIVE], 0,
 434       sess->id, ssrc);
 435 }
 436
 437 static void
 438 on_ssrc_sdes (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 439 {
 440   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_SSRC_SDES], 0,
 441       sess->id, ssrc);
 442 }
 443
 444 static void
 445 on_bye_ssrc (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 446 {
 447   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_BYE_SSRC], 0,
 448       sess->id, ssrc);
 449 }
 450
 451 static void
 452 on_bye_timeout (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 453 {
 454   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_BYE_TIMEOUT], 0,
 455       sess->id, ssrc);
 456
 457   if (sess->bin->priv->autoremove)
 458     g_signal_emit_by_name (sess->demux, "clear-ssrc", ssrc, NULL);
 459 }
 460
 461 static void
 462 on_timeout (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 463 {
 464   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_TIMEOUT], 0,
 465       sess->id, ssrc);
 466
 467   if (sess->bin->priv->autoremove)
 468     g_signal_emit_by_name (sess->demux, "clear-ssrc", ssrc, NULL);
 469 }
 470
 471 static void
 472 on_sender_timeout (GstElement * session, guint32 ssrc, GstRtpBinSession * sess)
 473 {
 474   g_signal_emit (sess->bin, gst_rtp_bin_signals[SIGNAL_ON_SENDER_TIMEOUT], 0,
 475       sess->id, ssrc);
 476 }
 477
 478 static void
 479 on_npt_stop (GstElement * jbuf, GstRtpBinStream * stream)
 480 {
 481   g_signal_emit (stream->bin, gst_rtp_bin_signals[SIGNAL_ON_NPT_STOP], 0,
 482       stream->session->id, stream->ssrc);
 483 }
 484
 485 /* must be called with the SESSION lock */
 486 static GstRtpBinStream *
 487 find_stream_by_ssrc (GstRtpBinSession * session, guint32 ssrc)
 488 {
 489   GSList *walk;
 490
 491   for (walk = session->streams; walk; walk = g_slist_next (walk)) {
 492     GstRtpBinStream *stream = (GstRtpBinStream *) walk->data;
 493
 494     if (stream->ssrc == ssrc)
 495       return stream;
 496   }
 497   return NULL;
 498 }
 499
 500 static void
 501 ssrc_demux_pad_removed (GstElement * element, guint ssrc, GstPad * pad,
 502     GstRtpBinSession * session)
 503 {
 504   GstRtpBinStream *stream = NULL;
 505
 506   GST_RTP_SESSION_LOCK (session);
 507   if ((stream = find_stream_by_ssrc (session, ssrc)))
 508     session->streams = g_slist_remove (session->streams, stream);
 509   GST_RTP_SESSION_UNLOCK (session);
 510
 511   if (stream)
 512     free_stream (stream);
 513 }
 514
 515 /* create a session with the given id.  Must be called with RTP_BIN_LOCK */
 516 static GstRtpBinSession *
 517 create_session (GstRtpBin * rtpbin, gint id)
 518 {
 519   GstRtpBinSession *sess;
 520   GstElement *session, *demux;
 521   GstState target;
 522
 523   if (!(session = gst_element_factory_make ("gstrtpsession", NULL)))
 524     goto no_session;
 525
 526   if (!(demux = gst_element_factory_make ("gstrtpssrcdemux", NULL)))
 527     goto no_demux;
 528
 529   sess = g_new0 (GstRtpBinSession, 1);
 530   sess->lock = g_mutex_new ();
 531   sess->id = id;
 532   sess->bin = rtpbin;
 533   sess->session = session;
 534   sess->demux = demux;
 535   sess->ptmap = g_hash_table_new_full (NULL, NULL, NULL,
 536       (GDestroyNotify) gst_caps_unref);
 537   rtpbin->sessions = g_slist_prepend (rtpbin->sessions, sess);
 538
 539   /* configure SDES items */
 540   GST_OBJECT_LOCK (rtpbin);
 541   g_object_set (session, "sdes", rtpbin->sdes, "use-pipeline-clock",
 542       rtpbin->use_pipeline_clock, NULL);
 543   GST_OBJECT_UNLOCK (rtpbin);
 544
 545   /* provide clock_rate to the session manager when needed */
 546   g_signal_connect (session, "request-pt-map",
 547       (GCallback) pt_map_requested, sess);
 548
 549   g_signal_connect (sess->session, "on-new-ssrc",
 550       (GCallback) on_new_ssrc, sess);
 551   g_signal_connect (sess->session, "on-ssrc-collision",
 552       (GCallback) on_ssrc_collision, sess);
 553   g_signal_connect (sess->session, "on-ssrc-validated",
 554       (GCallback) on_ssrc_validated, sess);
 555   g_signal_connect (sess->session, "on-ssrc-active",
 556       (GCallback) on_ssrc_active, sess);
 557   g_signal_connect (sess->session, "on-ssrc-sdes",
 558       (GCallback) on_ssrc_sdes, sess);
 559   g_signal_connect (sess->session, "on-bye-ssrc",
 560       (GCallback) on_bye_ssrc, sess);
 561   g_signal_connect (sess->session, "on-bye-timeout",
 562       (GCallback) on_bye_timeout, sess);
 563   g_signal_connect (sess->session, "on-timeout", (GCallback) on_timeout, sess);
 564   g_signal_connect (sess->session, "on-sender-timeout",
 565       (GCallback) on_sender_timeout, sess);
 566
 567   gst_bin_add (GST_BIN_CAST (rtpbin), session);
 568   gst_bin_add (GST_BIN_CAST (rtpbin), demux);
 569
 570   GST_OBJECT_LOCK (rtpbin);
 571   target = GST_STATE_TARGET (rtpbin);
 572   GST_OBJECT_UNLOCK (rtpbin);
 573
 574   /* change state only to what's needed */
 575   gst_element_set_state (demux, target);
 576   gst_element_set_state (session, target);
 577
 578   return sess;
 579
 580   /* ERRORS */
 581 no_session:
 582   {
 583     g_warning ("gstrtpbin: could not create gstrtpsession element");
 584     return NULL;
 585   }
 586 no_demux:
 587   {
 588     gst_object_unref (session);
 589     g_warning ("gstrtpbin: could not create gstrtpssrcdemux element");
 590     return NULL;
 591   }
 592 }
 593
 594 static void
 595 free_session (GstRtpBinSession * sess, GstRtpBin * bin)
 596 {
 597   GSList *client_walk;
 598
 599   GST_DEBUG_OBJECT (bin, "freeing session %p", sess);
 600
 601   gst_element_set_locked_state (sess->demux, TRUE);
 602   gst_element_set_locked_state (sess->session, TRUE);
 603
 604   gst_element_set_state (sess->demux, GST_STATE_NULL);
 605   gst_element_set_state (sess->session, GST_STATE_NULL);
 606
 607   if (sess->recv_rtp_sink != NULL) {
 608     gst_element_release_request_pad (sess->session, sess->recv_rtp_sink);
 609     gst_object_unref (sess->recv_rtp_sink);
 610   }
 611   if (sess->recv_rtp_src != NULL)
 612     gst_object_unref (sess->recv_rtp_src);
 613   if (sess->recv_rtcp_sink != NULL) {
 614     gst_element_release_request_pad (sess->session, sess->recv_rtcp_sink);
 615     gst_object_unref (sess->recv_rtcp_sink);
 616   }
 617   if (sess->sync_src != NULL)
 618     gst_object_unref (sess->sync_src);
 619   if (sess->send_rtp_sink != NULL) {
 620     gst_element_release_request_pad (sess->session, sess->send_rtp_sink);
 621     gst_object_unref (sess->send_rtp_sink);
 622   }
 623   if (sess->send_rtp_src != NULL)
 624     gst_object_unref (sess->send_rtp_src);
 625   if (sess->send_rtcp_src != NULL) {
 626     gst_element_release_request_pad (sess->session, sess->send_rtcp_src);
 627     gst_object_unref (sess->send_rtcp_src);
 628   }
 629
 630   gst_bin_remove (GST_BIN_CAST (bin), sess->session);
 631   gst_bin_remove (GST_BIN_CAST (bin), sess->demux);
 632
 633   /* remove any references in bin->clients to the streams in sess->streams */
 634   client_walk = bin->clients;
 635   while (client_walk) {
 636     GSList *client_node = client_walk;
 637     GstRtpBinClient *client = (GstRtpBinClient *) client_node->data;
 638     GSList *stream_walk = client->streams;
 639
 640     while (stream_walk) {
 641       GSList *stream_node = stream_walk;
 642       GstRtpBinStream *stream = (GstRtpBinStream *) stream_node->data;
 643       GSList *inner_walk;
 644
 645       stream_walk = g_slist_next (stream_walk);
 646
 647       for (inner_walk = sess->streams; inner_walk;
 648           inner_walk = g_slist_next (inner_walk)) {
 649         if ((GstRtpBinStream *) inner_walk->data == stream) {
 650           client->streams = g_slist_delete_link (client->streams, stream_node);
 651           --client->nstreams;
 652           break;
 653         }
 654       }
 655     }
 656     client_walk = g_slist_next (client_walk);
 657
 658     g_assert ((client->streams && client->nstreams > 0) || (!client->streams
 659             && client->streams == 0));
 660     if (client->nstreams == 0) {
 661       free_client (client, bin);
 662       bin->clients = g_slist_delete_link (bin->clients, client_node);
 663     }
 664   }
 665
 666   g_slist_foreach (sess->streams, (GFunc) free_stream, NULL);
 667   g_slist_free (sess->streams);
 668
 669   g_mutex_free (sess->lock);
 670   g_hash_table_destroy (sess->ptmap);
 671
 672   g_free (sess);
 673 }
 674
 675 /* get the payload type caps for the specific payload @pt in @session */
 676 static GstCaps *
 677 get_pt_map (GstRtpBinSession * session, guint pt)
 678 {
 679   GstCaps *caps = NULL;
 680   GstRtpBin *bin;
 681   GValue ret = { 0 };
 682   GValue args[3] = { {0}, {0}, {0} };
 683
 684   GST_DEBUG ("searching pt %d in cache", pt);
 685
 686   GST_RTP_SESSION_LOCK (session);
 687
 688   /* first look in the cache */
 689   caps = g_hash_table_lookup (session->ptmap, GINT_TO_POINTER (pt));
 690   if (caps) {
 691     gst_caps_ref (caps);
 692     goto done;
 693   }
 694
 695   bin = session->bin;
 696
 697   GST_DEBUG ("emiting signal for pt %d in session %d", pt, session->id);
 698
 699   /* not in cache, send signal to request caps */
 700   g_value_init (&args[0], GST_TYPE_ELEMENT);
 701   g_value_set_object (&args[0], bin);
 702   g_value_init (&args[1], G_TYPE_UINT);
 703   g_value_set_uint (&args[1], session->id);
 704   g_value_init (&args[2], G_TYPE_UINT);
 705   g_value_set_uint (&args[2], pt);
 706
 707   g_value_init (&ret, GST_TYPE_CAPS);
 708   g_value_set_boxed (&ret, NULL);
 709
 710   GST_RTP_SESSION_UNLOCK (session);
 711
 712   g_signal_emitv (args, gst_rtp_bin_signals[SIGNAL_REQUEST_PT_MAP], 0, &ret);
 713
 714   GST_RTP_SESSION_LOCK (session);
 715
 716   g_value_unset (&args[0]);
 717   g_value_unset (&args[1]);
 718   g_value_unset (&args[2]);
 719
 720   /* look in the cache again because we let the lock go */
 721   caps = g_hash_table_lookup (session->ptmap, GINT_TO_POINTER (pt));
 722   if (caps) {
 723     gst_caps_ref (caps);
 724     g_value_unset (&ret);
 725     goto done;
 726   }
 727
 728   caps = (GstCaps *) g_value_dup_boxed (&ret);
 729   g_value_unset (&ret);
 730   if (!caps)
 731     goto no_caps;
 732
 733   GST_DEBUG ("caching pt %d as %" GST_PTR_FORMAT, pt, caps);
 734
 735   /* store in cache, take additional ref */
 736   g_hash_table_insert (session->ptmap, GINT_TO_POINTER (pt),
 737       gst_caps_ref (caps));
 738
 739 done:
 740   GST_RTP_SESSION_UNLOCK (session);
 741
 742   return caps;
 743
 744   /* ERRORS */
 745 no_caps:
 746   {
 747     GST_RTP_SESSION_UNLOCK (session);
 748     GST_DEBUG ("no pt map could be obtained");
 749     return NULL;
 750   }
 751 }
 752
 753 static gboolean
 754 return_true (gpointer key, gpointer value, gpointer user_data)
 755 {
 756   return TRUE;
 757 }
 758
 759 static void
 760 gst_rtp_bin_reset_sync (GstRtpBin * rtpbin)
 761 {
 762   GSList *clients, *streams;
 763
 764   GST_DEBUG_OBJECT (rtpbin, "Reset sync on all clients");
 765
 766   GST_RTP_BIN_LOCK (rtpbin);
 767   for (clients = rtpbin->clients; clients; clients = g_slist_next (clients)) {
 768     GstRtpBinClient *client = (GstRtpBinClient *) clients->data;
 769
 770     /* reset sync on all streams for this client */
 771     for (streams = client->streams; streams; streams = g_slist_next (streams)) {
 772       GstRtpBinStream *stream = (GstRtpBinStream *) streams->data;
 773
 774       /* make use require a new SR packet for this stream before we attempt new
 775        * lip-sync */
 776       stream->have_sync = FALSE;
 777       stream->rt_delta = 0;
 778     }
 779   }
 780   GST_RTP_BIN_UNLOCK (rtpbin);
 781 }
 782
 783 static void
 784 gst_rtp_bin_clear_pt_map (GstRtpBin * bin)
 785 {
 786   GSList *sessions, *streams;
 787
 788   GST_RTP_BIN_LOCK (bin);
 789   GST_DEBUG_OBJECT (bin, "clearing pt map");
 790   for (sessions = bin->sessions; sessions; sessions = g_slist_next (sessions)) {
 791     GstRtpBinSession *session = (GstRtpBinSession *) sessions->data;
 792
 793     GST_DEBUG_OBJECT (bin, "clearing session %p", session);
 794     g_signal_emit_by_name (session->session, "clear-pt-map", NULL);
 795
 796     GST_RTP_SESSION_LOCK (session);
 797     g_hash_table_foreach_remove (session->ptmap, return_true, NULL);
 798
 799     for (streams = session->streams; streams; streams = g_slist_next (streams)) {
 800       GstRtpBinStream *stream = (GstRtpBinStream *) streams->data;
 801
 802       GST_DEBUG_OBJECT (bin, "clearing stream %p", stream);
 803       g_signal_emit_by_name (stream->buffer, "clear-pt-map", NULL);
 804       if (stream->demux)
 805         g_signal_emit_by_name (stream->demux, "clear-pt-map", NULL);
 806     }
 807     GST_RTP_SESSION_UNLOCK (session);
 808   }
 809   GST_RTP_BIN_UNLOCK (bin);
 810
 811   /* reset sync too */
 812   gst_rtp_bin_reset_sync (bin);
 813 }
 814
 815 static RTPSession *
 816 gst_rtp_bin_get_internal_session (GstRtpBin * bin, guint session_id)
 817 {
 818   RTPSession *internal_session = NULL;
 819   GstRtpBinSession *session;
 820
 821   GST_RTP_BIN_LOCK (bin);
 822   GST_DEBUG_OBJECT (bin, "retrieving internal RTPSession object, index: %d",
 823       session_id);
 824   session = find_session_by_id (bin, (gint) session_id);
 825   if (session) {
 826     g_object_get (session->session, "internal-session", &internal_session,
 827         NULL);
 828   }
 829   GST_RTP_BIN_UNLOCK (bin);
 830
 831   return internal_session;
 832 }
 833
 834 static void
 835 gst_rtp_bin_propagate_property_to_jitterbuffer (GstRtpBin * bin,
 836     const gchar * name, const GValue * value)
 837 {
 838   GSList *sessions, *streams;
 839
 840   GST_RTP_BIN_LOCK (bin);
 841   for (sessions = bin->sessions; sessions; sessions = g_slist_next (sessions)) {
 842     GstRtpBinSession *session = (GstRtpBinSession *) sessions->data;
 843
 844     GST_RTP_SESSION_LOCK (session);
 845     for (streams = session->streams; streams; streams = g_slist_next (streams)) {
 846       GstRtpBinStream *stream = (GstRtpBinStream *) streams->data;
 847
 848       g_object_set_property (G_OBJECT (stream->buffer), name, value);
 849     }
 850     GST_RTP_SESSION_UNLOCK (session);
 851   }
 852   GST_RTP_BIN_UNLOCK (bin);
 853 }
 854
 855 /* get a client with the given SDES name. Must be called with RTP_BIN_LOCK */
 856 static GstRtpBinClient *
 857 get_client (GstRtpBin * bin, guint8 len, guint8 * data, gboolean * created)
 858 {
 859   GstRtpBinClient *result = NULL;
 860   GSList *walk;
 861
 862   for (walk = bin->clients; walk; walk = g_slist_next (walk)) {
 863     GstRtpBinClient *client = (GstRtpBinClient *) walk->data;
 864
 865     if (len != client->cname_len)
 866       continue;
 867
 868     if (!strncmp ((gchar *) data, client->cname, client->cname_len)) {
 869       GST_DEBUG_OBJECT (bin, "found existing client %p with CNAME %s", client,
 870           client->cname);
 871       result = client;
 872       break;
 873     }
 874   }
 875
 876   /* nothing found, create one */
 877   if (result == NULL) {
 878     result = g_new0 (GstRtpBinClient, 1);
 879     result->cname = g_strndup ((gchar *) data, len);
 880     result->cname_len = len;
 881     bin->clients = g_slist_prepend (bin->clients, result);
 882     GST_DEBUG_OBJECT (bin, "created new client %p with CNAME %s", result,
 883         result->cname);
 884   }
 885   return result;
 886 }
 887
 888 static void
 889 free_client (GstRtpBinClient * client, GstRtpBin * bin)
 890 {
 891   GST_DEBUG_OBJECT (bin, "freeing client %p", client);
 892   g_slist_free (client->streams);
 893   g_free (client->cname);
 894   g_free (client);
 895 }
 896
 897 static void
 898 get_current_times (GstRtpBin * bin, GstClockTime * running_time,
 899     guint64 * ntpnstime)
 900 {
 901   guint64 ntpns;
 902   GstClock *clock;
 903   GstClockTime base_time, rt, clock_time;
 904
 905   GST_OBJECT_LOCK (bin);
 906   if ((clock = GST_ELEMENT_CLOCK (bin))) {
 907     base_time = GST_ELEMENT_CAST (bin)->base_time;
 908     gst_object_ref (clock);
 909     GST_OBJECT_UNLOCK (bin);
 910
 911     clock_time = gst_clock_get_time (clock);
 912
 913     if (bin->use_pipeline_clock) {
 914       ntpns = clock_time;
 915     } else {
 916       GTimeVal current;
 917
 918       /* get current NTP time */
 919       g_get_current_time (&current);
 920       ntpns = GST_TIMEVAL_TO_TIME (current);
 921     }
 922
 923     /* add constant to convert from 1970 based time to 1900 based time */
 924     ntpns += (2208988800LL * GST_SECOND);
 925
 926     /* get current clock time and convert to running time */
 927     rt = clock_time - base_time;
 928
 929     gst_object_unref (clock);
 930   } else {
 931     GST_OBJECT_UNLOCK (bin);
 932     rt = -1;
 933     ntpns = -1;
 934   }
 935   if (running_time)
 936     *running_time = rt;
 937   if (ntpnstime)
 938     *ntpnstime = ntpns;
 939 }
 940
 941 static void
 942 stream_set_ts_offset (GstRtpBin * bin, GstRtpBinStream * stream,
 943     gint64 ts_offset)
 944 {
 945   gint64 prev_ts_offset;
 946
 947   g_object_get (stream->buffer, "ts-offset", &prev_ts_offset, NULL);
 948
 949   /* delta changed, see how much */
 950   if (prev_ts_offset != ts_offset) {
 951     gint64 diff;
 952
 953     diff = prev_ts_offset - ts_offset;
 954
 955     GST_DEBUG_OBJECT (bin,
 956         "ts-offset %" G_GINT64_FORMAT ", prev %" G_GINT64_FORMAT
 957         ", diff: %" G_GINT64_FORMAT, ts_offset, prev_ts_offset, diff);
 958
 959     /* only change diff when it changed more than 4 milliseconds. This
 960      * compensates for rounding errors in NTP to RTP timestamp
 961      * conversions */
 962     if (ABS (diff) > 4 * GST_MSECOND) {
 963       if (ABS (diff) < (3 * GST_SECOND)) {
 964         g_object_set (stream->buffer, "ts-offset", ts_offset, NULL);
 965       } else {
 966         GST_WARNING_OBJECT (bin, "offset unusually large, ignoring");
 967       }
 968     } else {
 969       GST_DEBUG_OBJECT (bin, "offset too small, ignoring");
 970     }
 971   }
 972   GST_DEBUG_OBJECT (bin, "stream SSRC %08x, delta %" G_GINT64_FORMAT,
 973       stream->ssrc, ts_offset);
 974 }
 975
 976 /* associate a stream to the given CNAME. This will make sure all streams for
 977  * that CNAME are synchronized together.
 978  * Must be called with GST_RTP_BIN_LOCK */
 979 static void
 980 gst_rtp_bin_associate (GstRtpBin * bin, GstRtpBinStream * stream, guint8 len,
 981     guint8 * data, guint64 ntptime, guint64 last_extrtptime,
 982     guint64 base_rtptime, guint64 base_time, guint clock_rate)
 983 {
 984   GstRtpBinClient *client;
 985   gboolean created;
 986   GSList *walk;
 987   guint64 local_rt;
 988   guint64 local_rtp;
 989   GstClockTime running_time;
 990   guint64 ntpnstime;
 991   gint64 ntpdiff, rtdiff;
 992   guint64 last_unix;
 993
 994   /* first find or create the CNAME */
 995   client = get_client (bin, len, data, &created);
 996
 997   /* find stream in the client */
 998   for (walk = client->streams; walk; walk = g_slist_next (walk)) {
 999     GstRtpBinStream *ostream = (GstRtpBinStream *) walk->data;
1000
1001     if (ostream == stream)
1002       break;
1003   }
1004   /* not found, add it to the list */
1005   if (walk == NULL) {
1006     GST_DEBUG_OBJECT (bin,
1007         "new association of SSRC %08x with client %p with CNAME %s",
1008         stream->ssrc, client, client->cname);
1009     client->streams = g_slist_prepend (client->streams, stream);
1010     client->nstreams++;
1011   } else {
1012     GST_DEBUG_OBJECT (bin,
1013         "found association of SSRC %08x with client %p with CNAME %s",
1014         stream->ssrc, client, client->cname);
1015   }
1016
1017   /* Take the extended rtptime we found in the SR packet and map it to the
1018    * local rtptime. The local rtp time is used to construct timestamps on the
1019    * buffers so we will calculate what running_time corresponds to the RTP
1020    * timestamp in the SR packet. */
1021   local_rtp = last_extrtptime - base_rtptime;
1022
1023   GST_DEBUG_OBJECT (bin,
1024       "base %" G_GUINT64_FORMAT ", extrtptime %" G_GUINT64_FORMAT
1025       ", local RTP %" G_GUINT64_FORMAT ", clock-rate %d", base_rtptime,
1026       last_extrtptime, local_rtp, clock_rate);
1027
1028   /* calculate local RTP time in gstreamer timestamp, we essentially perform the
1029    * same conversion that a jitterbuffer would use to convert an rtp timestamp
1030    * into a corresponding gstreamer timestamp. Note that the base_time also
1031    * contains the drift between sender and receiver. */
1032   local_rt = gst_util_uint64_scale_int (local_rtp, GST_SECOND, clock_rate);
1033   local_rt += base_time;
1034
1035   /* convert ntptime to unix time since 1900 */
1036   last_unix = gst_util_uint64_scale (ntptime, GST_SECOND,
1037       (G_GINT64_CONSTANT (1) << 32));
1038
1039   stream->have_sync = TRUE;
1040
1041   GST_DEBUG_OBJECT (bin,
1042       "local UNIX %" G_GUINT64_FORMAT ", remote UNIX %" G_GUINT64_FORMAT,
1043       local_rt, last_unix);
1044
1045   /* recalc inter stream playout offset, but only if there is more than one
1046    * stream or we're doing NTP sync. */
1047   if (bin->ntp_sync) {
1048     /* For NTP sync we need to first get a snapshot of running_time and NTP
1049      * time. We know at what running_time we play a certain RTP time, we also
1050      * calculated when we would play the RTP time in the SR packet. Now we need
1051      * to know how the running_time and the NTP time relate to eachother. */
1052     get_current_times (bin, &running_time, &ntpnstime);
1053
1054     /* see how far away the NTP time is. This is the difference between the
1055      * current NTP time and the NTP time in the last SR packet. */
1056     ntpdiff = ntpnstime - last_unix;
1057     /* see how far away the running_time is. This is the difference between the
1058      * current running_time and the running_time of the RTP timestamp in the
1059      * last SR packet. */
1060     rtdiff = running_time - local_rt;
1061
1062     GST_DEBUG_OBJECT (bin,
1063         "NTP time %" G_GUINT64_FORMAT ", last unix %" G_GUINT64_FORMAT,
1064         ntpnstime, last_unix);
1065     GST_DEBUG_OBJECT (bin,
1066         "NTP diff %" G_GINT64_FORMAT ", RT diff %" G_GINT64_FORMAT, ntpdiff,
1067         rtdiff);
1068
1069     /* combine to get the final diff to apply to the running_time */
1070     stream->rt_delta = rtdiff - ntpdiff;
1071
1072     stream_set_ts_offset (bin, stream, stream->rt_delta);
1073   } else if (client->nstreams > 1) {
1074     gint64 min;
1075
1076     /* calculate delta between server and receiver. last_unix is created by
1077      * converting the ntptime in the last SR packet to a gstreamer timestamp. This
1078      * delta expresses the difference to our timeline and the server timeline. The
1079      * difference in itself doesn't mean much but we can combine the delta of
1080      * multiple streams to create a stream specific offset. */
1081     stream->rt_delta = last_unix - local_rt;
1082
1083     /* calculate the min of all deltas, ignoring streams that did not yet have a
1084      * valid rt_delta because we did not yet receive an SR packet for those
1085      * streams.
1086      * We calculate the mininum because we would like to only apply positive
1087      * offsets to streams, delaying their playback instead of trying to speed up
1088      * other streams (which might be imposible when we have to create negative
1089      * latencies).
1090      * The stream that has the smallest diff is selected as the reference stream,
1091      * all other streams will have a positive offset to this difference. */
1092     min = G_MAXINT64;
1093     for (walk = client->streams; walk; walk = g_slist_next (walk)) {
1094       GstRtpBinStream *ostream = (GstRtpBinStream *) walk->data;
1095
1096       if (!ostream->have_sync)
1097         continue;
1098
1099       if (ostream->rt_delta < min)
1100         min = ostream->rt_delta;
1101     }
1102
1103     GST_DEBUG_OBJECT (bin, "client %p min delta %" G_GINT64_FORMAT, client,
1104         min);
1105
1106     /* calculate offsets for each stream */
1107     for (walk = client->streams; walk; walk = g_slist_next (walk)) {
1108       GstRtpBinStream *ostream = (GstRtpBinStream *) walk->data;
1109       gint64 ts_offset;
1110
1111       /* ignore streams for which we didn't receive an SR packet yet, we
1112        * can't synchronize them yet. We can however sync other streams just
1113        * fine. */
1114       if (!ostream->have_sync)
1115         continue;
1116
1117       /* calculate offset to our reference stream, this should always give a
1118        * positive number. */
1119       ts_offset = ostream->rt_delta - min;
1120
1121       stream_set_ts_offset (bin, ostream, ts_offset);
1122     }
1123   }
1124   return;
1125 }
1126
1127 #define GST_RTCP_BUFFER_FOR_PACKETS(b,buffer,packet) \
1128   for ((b) = gst_rtcp_buffer_get_first_packet ((buffer), (packet)); (b); \
1129           (b) = gst_rtcp_packet_move_to_next ((packet)))
1130
1131 #define GST_RTCP_SDES_FOR_ITEMS(b,packet) \
1132   for ((b) = gst_rtcp_packet_sdes_first_item ((packet)); (b); \
1133           (b) = gst_rtcp_packet_sdes_next_item ((packet)))
1134
1135 #define GST_RTCP_SDES_FOR_ENTRIES(b,packet) \
1136   for ((b) = gst_rtcp_packet_sdes_first_entry ((packet)); (b); \
1137           (b) = gst_rtcp_packet_sdes_next_entry ((packet)))
1138
1139 static void
1140 gst_rtp_bin_handle_sync (GstElement * jitterbuffer, GstStructure * s,
1141     GstRtpBinStream * stream)
1142 {
1143   GstRtpBin *bin;
1144   GstRTCPPacket packet;
1145   guint32 ssrc;
1146   guint64 ntptime;
1147   gboolean have_sr, have_sdes;
1148   gboolean more;
1149   guint64 base_rtptime;
1150   guint64 base_time;
1151   guint clock_rate;
1152   guint64 extrtptime;
1153   GstBuffer *buffer;
1154   GstRTCPBuffer rtcp = { NULL };
1155
1156   bin = stream->bin;
1157
1158   GST_DEBUG_OBJECT (bin, "sync handler called");
1159
1160   /* get the last relation between the rtp timestamps and the gstreamer
1161    * timestamps. We get this info directly from the jitterbuffer which
1162    * constructs gstreamer timestamps from rtp timestamps and so it know exactly
1163    * what the current situation is. */
1164   base_rtptime =
1165       g_value_get_uint64 (gst_structure_get_value (s, "base-rtptime"));
1166   base_time = g_value_get_uint64 (gst_structure_get_value (s, "base-time"));
1167   clock_rate = g_value_get_uint (gst_structure_get_value (s, "clock-rate"));
1168   extrtptime =
1169       g_value_get_uint64 (gst_structure_get_value (s, "sr-ext-rtptime"));
1170   buffer = gst_value_get_buffer (gst_structure_get_value (s, "sr-buffer"));
1171
1172   have_sr = FALSE;
1173   have_sdes = FALSE;
1174
1175   gst_rtcp_buffer_map (buffer, GST_MAP_READ, &rtcp);
1176
1177   GST_RTCP_BUFFER_FOR_PACKETS (more, &rtcp, &packet) {
1178     /* first packet must be SR or RR or else the validate would have failed */
1179     switch (gst_rtcp_packet_get_type (&packet)) {
1180       case GST_RTCP_TYPE_SR:
1181         /* only parse first. There is only supposed to be one SR in the packet
1182          * but we will deal with malformed packets gracefully */
1183         if (have_sr)
1184           break;
1185         /* get NTP and RTP times */
1186         gst_rtcp_packet_sr_get_sender_info (&packet, &ssrc, &ntptime, NULL,
1187             NULL, NULL);
1188
1189         GST_DEBUG_OBJECT (bin, "received sync packet from SSRC %08x", ssrc);
1190         /* ignore SR that is not ours */
1191         if (ssrc != stream->ssrc)
1192           continue;
1193
1194         have_sr = TRUE;
1195         break;
1196       case GST_RTCP_TYPE_SDES:
1197       {
1198         gboolean more_items, more_entries;
1199
1200         /* only deal with first SDES, there is only supposed to be one SDES in
1201          * the RTCP packet but we deal with bad packets gracefully. Also bail
1202          * out if we have not seen an SR item yet. */
1203         if (have_sdes || !have_sr)
1204           break;
1205
1206         GST_RTCP_SDES_FOR_ITEMS (more_items, &packet) {
1207           /* skip items that are not about the SSRC of the sender */
1208           if (gst_rtcp_packet_sdes_get_ssrc (&packet) != ssrc)
1209             continue;
1210
1211           /* find the CNAME entry */
1212           GST_RTCP_SDES_FOR_ENTRIES (more_entries, &packet) {
1213             GstRTCPSDESType type;
1214             guint8 len;
1215             guint8 *data;
1216
1217             gst_rtcp_packet_sdes_get_entry (&packet, &type, &len, &data);
1218
1219             if (type == GST_RTCP_SDES_CNAME) {
1220               GST_RTP_BIN_LOCK (bin);
1221               /* associate the stream to CNAME */
1222               gst_rtp_bin_associate (bin, stream, len, data,
1223                   ntptime, extrtptime, base_rtptime, base_time, clock_rate);
1224               GST_RTP_BIN_UNLOCK (bin);
1225             }
1226           }
1227         }
1228         have_sdes = TRUE;
1229         break;
1230       }
1231       default:
1232         /* we can ignore these packets */
1233         break;
1234     }
1235   }
1236   gst_rtcp_buffer_unmap (&rtcp);
1237 }
1238
1239 /* create a new stream with @ssrc in @session. Must be called with
1240  * RTP_SESSION_LOCK. */
1241 static GstRtpBinStream *
1242 create_stream (GstRtpBinSession * session, guint32 ssrc)
1243 {
1244   GstElement *buffer, *demux = NULL;
1245   GstRtpBinStream *stream;
1246   GstRtpBin *rtpbin;
1247   GstState target;
1248
1249   rtpbin = session->bin;
1250
1251   if (!(buffer = gst_element_factory_make ("gstrtpjitterbuffer", NULL)))
1252     goto no_jitterbuffer;
1253
1254   if (!rtpbin->ignore_pt)
1255     if (!(demux = gst_element_factory_make ("gstrtpptdemux", NULL)))
1256       goto no_demux;
1257
1258
1259   stream = g_new0 (GstRtpBinStream, 1);
1260   stream->ssrc = ssrc;
1261   stream->bin = rtpbin;
1262   stream->session = session;
1263   stream->buffer = buffer;
1264   stream->demux = demux;
1265
1266   stream->have_sync = FALSE;
1267   stream->rt_delta = 0;
1268   stream->percent = 100;
1269   session->streams = g_slist_prepend (session->streams, stream);
1270
1271   /* provide clock_rate to the jitterbuffer when needed */
1272   stream->buffer_ptreq_sig = g_signal_connect (buffer, "request-pt-map",
1273       (GCallback) pt_map_requested, session);
1274   stream->buffer_ntpstop_sig = g_signal_connect (buffer, "on-npt-stop",
1275       (GCallback) on_npt_stop, stream);
1276
1277   g_object_set_data (G_OBJECT (buffer), "GstRTPBin.session", session);
1278   g_object_set_data (G_OBJECT (buffer), "GstRTPBin.stream", stream);
1279
1280   /* configure latency and packet lost */
1281   g_object_set (buffer, "latency", rtpbin->latency_ms, NULL);
1282   g_object_set (buffer, "do-lost", rtpbin->do_lost, NULL);
1283   g_object_set (buffer, "mode", rtpbin->buffer_mode, NULL);
1284
1285   if (!rtpbin->ignore_pt)
1286     gst_bin_add (GST_BIN_CAST (rtpbin), demux);
1287   gst_bin_add (GST_BIN_CAST (rtpbin), buffer);
1288
1289   /* link stuff */
1290   if (demux)
1291     gst_element_link (buffer, demux);
1292
1293   if (rtpbin->buffering) {
1294     guint64 last_out;
1295
1296     GST_INFO_OBJECT (rtpbin,
1297         "bin is buffering, set jitterbuffer as not active");
1298     g_signal_emit_by_name (buffer, "set-active", FALSE, (gint64) 0, &last_out);
1299   }
1300
1301
1302   GST_OBJECT_LOCK (rtpbin);
1303   target = GST_STATE_TARGET (rtpbin);
1304   GST_OBJECT_UNLOCK (rtpbin);
1305
1306   /* from sink to source */
1307   if (demux)
1308     gst_element_set_state (demux, target);
1309
1310   gst_element_set_state (buffer, target);
1311
1312   return stream;
1313
1314   /* ERRORS */
1315 no_jitterbuffer:
1316   {
1317     g_warning ("gstrtpbin: could not create gstrtpjitterbuffer element");
1318     return NULL;
1319   }
1320 no_demux:
1321   {
1322     gst_object_unref (buffer);
1323     g_warning ("gstrtpbin: could not create gstrtpptdemux element");
1324     return NULL;
1325   }
1326 }
1327
1328 static void
1329 free_stream (GstRtpBinStream * stream)
1330 {
1331   GstRtpBinSession *session;
1332
1333   session = stream->session;
1334
1335   if (stream->demux) {
1336     g_signal_handler_disconnect (stream->demux, stream->demux_newpad_sig);
1337     g_signal_handler_disconnect (stream->demux, stream->demux_ptreq_sig);
1338     g_signal_handler_disconnect (stream->demux, stream->demux_ptchange_sig);
1339   }
1340   g_signal_handler_disconnect (stream->buffer, stream->buffer_handlesync_sig);
1341   g_signal_handler_disconnect (stream->buffer, stream->buffer_ptreq_sig);
1342   g_signal_handler_disconnect (stream->buffer, stream->buffer_ntpstop_sig);
1343
1344   if (stream->demux)
1345     gst_element_set_locked_state (stream->demux, TRUE);
1346   gst_element_set_locked_state (stream->buffer, TRUE);
1347
1348   if (stream->demux)
1349     gst_element_set_state (stream->demux, GST_STATE_NULL);
1350   gst_element_set_state (stream->buffer, GST_STATE_NULL);
1351
1352   /* now remove this signal, we need this while going to NULL because it to
1353    * do some cleanups */
1354   if (stream->demux)
1355     g_signal_handler_disconnect (stream->demux, stream->demux_padremoved_sig);
1356
1357   gst_bin_remove (GST_BIN_CAST (session->bin), stream->buffer);
1358   if (stream->demux)
1359     gst_bin_remove (GST_BIN_CAST (session->bin), stream->demux);
1360
1361   g_free (stream);
1362 }
1363
1364 /* GObject vmethods */
1365 static void gst_rtp_bin_dispose (GObject * object);
1366 static void gst_rtp_bin_finalize (GObject * object);
1367 static void gst_rtp_bin_set_property (GObject * object, guint prop_id,
1368     const GValue * value, GParamSpec * pspec);
1369 static void gst_rtp_bin_get_property (GObject * object, guint prop_id,
1370     GValue * value, GParamSpec * pspec);
1371
1372 /* GstElement vmethods */
1373 static GstStateChangeReturn gst_rtp_bin_change_state (GstElement * element,
1374     GstStateChange transition);
1375 static GstPad *gst_rtp_bin_request_new_pad (GstElement * element,
1376     GstPadTemplate * templ, const gchar * name, const GstCaps * caps);
1377 static void gst_rtp_bin_release_pad (GstElement * element, GstPad * pad);
1378 static void gst_rtp_bin_handle_message (GstBin * bin, GstMessage * message);
1379
1380 #define gst_rtp_bin_parent_class parent_class
1381 G_DEFINE_TYPE (GstRtpBin, gst_rtp_bin, GST_TYPE_BIN);
1382
1383 static void
1384 gst_rtp_bin_class_init (GstRtpBinClass * klass)
1385 {
1386   GObjectClass *gobject_class;
1387   GstElementClass *gstelement_class;
1388   GstBinClass *gstbin_class;
1389
1390   gobject_class = (GObjectClass *) klass;
1391   gstelement_class = (GstElementClass *) klass;
1392   gstbin_class = (GstBinClass *) klass;
1393
1394   g_type_class_add_private (klass, sizeof (GstRtpBinPrivate));
1395
1396   gobject_class->dispose = gst_rtp_bin_dispose;
1397   gobject_class->finalize = gst_rtp_bin_finalize;
1398   gobject_class->set_property = gst_rtp_bin_set_property;
1399   gobject_class->get_property = gst_rtp_bin_get_property;
1400
1401   g_object_class_install_property (gobject_class, PROP_LATENCY,
1402       g_param_spec_uint ("latency", "Buffer latency in ms",
1403           "Default amount of ms to buffer in the jitterbuffers", 0,
1404           G_MAXUINT, DEFAULT_LATENCY_MS,
1405           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1406
1407   /**
1408    * GstRtpBin::request-pt-map:
1409    * @rtpbin: the object which received the signal
1410    * @session: the session
1411    * @pt: the pt
1412    *
1413    * Request the payload type as #GstCaps for @pt in @session.
1414    */
1415   gst_rtp_bin_signals[SIGNAL_REQUEST_PT_MAP] =
1416       g_signal_new ("request-pt-map", G_TYPE_FROM_CLASS (klass),
1417       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, request_pt_map),
1418       NULL, NULL, gst_rtp_bin_marshal_BOXED__UINT_UINT, GST_TYPE_CAPS, 2,
1419       G_TYPE_UINT, G_TYPE_UINT);
1420
1421     /**
1422    * GstRtpBin::payload-type-change:
1423    * @rtpbin: the object which received the signal
1424    * @session: the session
1425    * @pt: the pt
1426    *
1427    * Signal that the current payload type changed to @pt in @session.
1428    *
1429    * Since: 0.10.17
1430    */
1431   gst_rtp_bin_signals[SIGNAL_PAYLOAD_TYPE_CHANGE] =
1432       g_signal_new ("payload-type-change", G_TYPE_FROM_CLASS (klass),
1433       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, payload_type_change),
1434       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1435       G_TYPE_UINT, G_TYPE_UINT);
1436
1437   /**
1438    * GstRtpBin::clear-pt-map:
1439    * @rtpbin: the object which received the signal
1440    *
1441    * Clear all previously cached pt-mapping obtained with
1442    * #GstRtpBin::request-pt-map.
1443    */
1444   gst_rtp_bin_signals[SIGNAL_CLEAR_PT_MAP] =
1445       g_signal_new ("clear-pt-map", G_TYPE_FROM_CLASS (klass),
1446       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GstRtpBinClass,
1447           clear_pt_map), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE,
1448       0, G_TYPE_NONE);
1449
1450   /**
1451    * GstRtpBin::reset-sync:
1452    * @rtpbin: the object which received the signal
1453    *
1454    * Reset all currently configured lip-sync parameters and require new SR
1455    * packets for all streams before lip-sync is attempted again.
1456    */
1457   gst_rtp_bin_signals[SIGNAL_RESET_SYNC] =
1458       g_signal_new ("reset-sync", G_TYPE_FROM_CLASS (klass),
1459       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GstRtpBinClass,
1460           reset_sync), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE,
1461       0, G_TYPE_NONE);
1462
1463   /**
1464    * GstRtpBin::get-internal-session:
1465    * @rtpbin: the object which received the signal
1466    * @id: the session id
1467    *
1468    * Request the internal RTPSession object as #GObject in session @id.
1469    */
1470   gst_rtp_bin_signals[SIGNAL_GET_INTERNAL_SESSION] =
1471       g_signal_new ("get-internal-session", G_TYPE_FROM_CLASS (klass),
1472       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GstRtpBinClass,
1473           get_internal_session), NULL, NULL, gst_rtp_bin_marshal_OBJECT__UINT,
1474       RTP_TYPE_SESSION, 1, G_TYPE_UINT);
1475
1476   /**
1477    * GstRtpBin::on-new-ssrc:
1478    * @rtpbin: the object which received the signal
1479    * @session: the session
1480    * @ssrc: the SSRC
1481    *
1482    * Notify of a new SSRC that entered @session.
1483    */
1484   gst_rtp_bin_signals[SIGNAL_ON_NEW_SSRC] =
1485       g_signal_new ("on-new-ssrc", G_TYPE_FROM_CLASS (klass),
1486       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_new_ssrc),
1487       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1488       G_TYPE_UINT, G_TYPE_UINT);
1489   /**
1490    * GstRtpBin::on-ssrc-collision:
1491    * @rtpbin: the object which received the signal
1492    * @session: the session
1493    * @ssrc: the SSRC
1494    *
1495    * Notify when we have an SSRC collision
1496    */
1497   gst_rtp_bin_signals[SIGNAL_ON_SSRC_COLLISION] =
1498       g_signal_new ("on-ssrc-collision", G_TYPE_FROM_CLASS (klass),
1499       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_ssrc_collision),
1500       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1501       G_TYPE_UINT, G_TYPE_UINT);
1502   /**
1503    * GstRtpBin::on-ssrc-validated:
1504    * @rtpbin: the object which received the signal
1505    * @session: the session
1506    * @ssrc: the SSRC
1507    *
1508    * Notify of a new SSRC that became validated.
1509    */
1510   gst_rtp_bin_signals[SIGNAL_ON_SSRC_VALIDATED] =
1511       g_signal_new ("on-ssrc-validated", G_TYPE_FROM_CLASS (klass),
1512       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_ssrc_validated),
1513       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1514       G_TYPE_UINT, G_TYPE_UINT);
1515   /**
1516    * GstRtpBin::on-ssrc-active:
1517    * @rtpbin: the object which received the signal
1518    * @session: the session
1519    * @ssrc: the SSRC
1520    *
1521    * Notify of a SSRC that is active, i.e., sending RTCP.
1522    */
1523   gst_rtp_bin_signals[SIGNAL_ON_SSRC_ACTIVE] =
1524       g_signal_new ("on-ssrc-active", G_TYPE_FROM_CLASS (klass),
1525       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_ssrc_active),
1526       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1527       G_TYPE_UINT, G_TYPE_UINT);
1528   /**
1529    * GstRtpBin::on-ssrc-sdes:
1530    * @rtpbin: the object which received the signal
1531    * @session: the session
1532    * @ssrc: the SSRC
1533    *
1534    * Notify of a SSRC that is active, i.e., sending RTCP.
1535    */
1536   gst_rtp_bin_signals[SIGNAL_ON_SSRC_SDES] =
1537       g_signal_new ("on-ssrc-sdes", G_TYPE_FROM_CLASS (klass),
1538       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_ssrc_sdes),
1539       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1540       G_TYPE_UINT, G_TYPE_UINT);
1541
1542   /**
1543    * GstRtpBin::on-bye-ssrc:
1544    * @rtpbin: the object which received the signal
1545    * @session: the session
1546    * @ssrc: the SSRC
1547    *
1548    * Notify of an SSRC that became inactive because of a BYE packet.
1549    */
1550   gst_rtp_bin_signals[SIGNAL_ON_BYE_SSRC] =
1551       g_signal_new ("on-bye-ssrc", G_TYPE_FROM_CLASS (klass),
1552       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_bye_ssrc),
1553       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1554       G_TYPE_UINT, G_TYPE_UINT);
1555   /**
1556    * GstRtpBin::on-bye-timeout:
1557    * @rtpbin: the object which received the signal
1558    * @session: the session
1559    * @ssrc: the SSRC
1560    *
1561    * Notify of an SSRC that has timed out because of BYE
1562    */
1563   gst_rtp_bin_signals[SIGNAL_ON_BYE_TIMEOUT] =
1564       g_signal_new ("on-bye-timeout", G_TYPE_FROM_CLASS (klass),
1565       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_bye_timeout),
1566       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1567       G_TYPE_UINT, G_TYPE_UINT);
1568   /**
1569    * GstRtpBin::on-timeout:
1570    * @rtpbin: the object which received the signal
1571    * @session: the session
1572    * @ssrc: the SSRC
1573    *
1574    * Notify of an SSRC that has timed out
1575    */
1576   gst_rtp_bin_signals[SIGNAL_ON_TIMEOUT] =
1577       g_signal_new ("on-timeout", G_TYPE_FROM_CLASS (klass),
1578       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_timeout),
1579       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1580       G_TYPE_UINT, G_TYPE_UINT);
1581   /**
1582    * GstRtpBin::on-sender-timeout:
1583    * @rtpbin: the object which received the signal
1584    * @session: the session
1585    * @ssrc: the SSRC
1586    *
1587    * Notify of a sender SSRC that has timed out and became a receiver
1588    */
1589   gst_rtp_bin_signals[SIGNAL_ON_SENDER_TIMEOUT] =
1590       g_signal_new ("on-sender-timeout", G_TYPE_FROM_CLASS (klass),
1591       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_sender_timeout),
1592       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1593       G_TYPE_UINT, G_TYPE_UINT);
1594
1595   /**
1596    * GstRtpBin::on-npt-stop:
1597    * @rtpbin: the object which received the signal
1598    * @session: the session
1599    * @ssrc: the SSRC
1600    *
1601    * Notify that SSRC sender has sent data up to the configured NPT stop time.
1602    */
1603   gst_rtp_bin_signals[SIGNAL_ON_NPT_STOP] =
1604       g_signal_new ("on-npt-stop", G_TYPE_FROM_CLASS (klass),
1605       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRtpBinClass, on_npt_stop),
1606       NULL, NULL, gst_rtp_bin_marshal_VOID__UINT_UINT, G_TYPE_NONE, 2,
1607       G_TYPE_UINT, G_TYPE_UINT);
1608
1609   g_object_class_install_property (gobject_class, PROP_SDES,
1610       g_param_spec_boxed ("sdes", "SDES",
1611           "The SDES items of this session",
1612           GST_TYPE_STRUCTURE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1613
1614   g_object_class_install_property (gobject_class, PROP_DO_LOST,
1615       g_param_spec_boolean ("do-lost", "Do Lost",
1616           "Send an event downstream when a packet is lost", DEFAULT_DO_LOST,
1617           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1618
1619   g_object_class_install_property (gobject_class, PROP_AUTOREMOVE,
1620       g_param_spec_boolean ("autoremove", "Auto Remove",
1621           "Automatically remove timed out sources", DEFAULT_AUTOREMOVE,
1622           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1623
1624   g_object_class_install_property (gobject_class, PROP_IGNORE_PT,
1625       g_param_spec_boolean ("ignore-pt", "Ignore PT",
1626           "Do not demultiplex based on PT values", DEFAULT_IGNORE_PT,
1627           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1628
1629   g_object_class_install_property (gobject_class, PROP_USE_PIPELINE_CLOCK,
1630       g_param_spec_boolean ("use-pipeline-clock", "Use pipeline clock",
1631           "Use the pipeline clock to set the NTP time in the RTCP SR messages",
1632           DEFAULT_USE_PIPELINE_CLOCK,
1633           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1634   /**
1635    * GstRtpBin::buffer-mode:
1636    *
1637    * Control the buffering and timestamping mode used by the jitterbuffer.
1638    *
1639    * Since: 0.10.17
1640    */
1641   g_object_class_install_property (gobject_class, PROP_BUFFER_MODE,
1642       g_param_spec_enum ("buffer-mode", "Buffer Mode",
1643           "Control the buffering algorithm in use", RTP_TYPE_JITTER_BUFFER_MODE,
1644           DEFAULT_BUFFER_MODE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1645   /**
1646    * GstRtpBin::ntp-sync:
1647    *
1648    * Synchronize received streams to the NTP clock. When the NTP clock is shared
1649    * between the receivers and the senders (such as when using ntpd) this option
1650    * can be used to synchronize receivers on multiple machines.
1651    *
1652    * Since: 0.10.21
1653    */
1654   g_object_class_install_property (gobject_class, PROP_NTP_SYNC,
1655       g_param_spec_boolean ("ntp-sync", "Sync on NTP clock",
1656           "Synchronize received streams to the NTP clock", DEFAULT_NTP_SYNC,
1657           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1658
1659   gstelement_class->change_state = GST_DEBUG_FUNCPTR (gst_rtp_bin_change_state);
1660   gstelement_class->request_new_pad =
1661       GST_DEBUG_FUNCPTR (gst_rtp_bin_request_new_pad);
1662   gstelement_class->release_pad = GST_DEBUG_FUNCPTR (gst_rtp_bin_release_pad);
1663
1664   /* sink pads */
1665   gst_element_class_add_pad_template (gstelement_class,
1666       gst_static_pad_template_get (&rtpbin_recv_rtp_sink_template));
1667   gst_element_class_add_pad_template (gstelement_class,
1668       gst_static_pad_template_get (&rtpbin_recv_rtcp_sink_template));
1669   gst_element_class_add_pad_template (gstelement_class,
1670       gst_static_pad_template_get (&rtpbin_send_rtp_sink_template));
1671
1672   /* src pads */
1673   gst_element_class_add_pad_template (gstelement_class,
1674       gst_static_pad_template_get (&rtpbin_recv_rtp_src_template));
1675   gst_element_class_add_pad_template (gstelement_class,
1676       gst_static_pad_template_get (&rtpbin_send_rtcp_src_template));
1677   gst_element_class_add_pad_template (gstelement_class,
1678       gst_static_pad_template_get (&rtpbin_send_rtp_src_template));
1679
1680   gst_element_class_set_details_simple (gstelement_class, "RTP Bin",
1681       "Filter/Network/RTP",
1682       "Real-Time Transport Protocol bin",
1683       "Wim Taymans <wim.taymans@gmail.com>");
1684
1685   gstbin_class->handle_message = GST_DEBUG_FUNCPTR (gst_rtp_bin_handle_message);
1686
1687   klass->clear_pt_map = GST_DEBUG_FUNCPTR (gst_rtp_bin_clear_pt_map);
1688   klass->reset_sync = GST_DEBUG_FUNCPTR (gst_rtp_bin_reset_sync);
1689   klass->get_internal_session =
1690       GST_DEBUG_FUNCPTR (gst_rtp_bin_get_internal_session);
1691
1692   GST_DEBUG_CATEGORY_INIT (gst_rtp_bin_debug, "rtpbin", 0, "RTP bin");
1693 }
1694
1695 static void
1696 gst_rtp_bin_init (GstRtpBin * rtpbin)
1697 {
1698   gchar *str;
1699
1700   rtpbin->priv = GST_RTP_BIN_GET_PRIVATE (rtpbin);
1701   rtpbin->priv->bin_lock = g_mutex_new ();
1702   rtpbin->priv->dyn_lock = g_mutex_new ();
1703
1704   rtpbin->latency_ms = DEFAULT_LATENCY_MS;
1705   rtpbin->latency_ns = DEFAULT_LATENCY_MS * GST_MSECOND;
1706   rtpbin->do_lost = DEFAULT_DO_LOST;
1707   rtpbin->ignore_pt = DEFAULT_IGNORE_PT;
1708   rtpbin->ntp_sync = DEFAULT_NTP_SYNC;
1709   rtpbin->priv->autoremove = DEFAULT_AUTOREMOVE;
1710   rtpbin->buffer_mode = DEFAULT_BUFFER_MODE;
1711   rtpbin->use_pipeline_clock = DEFAULT_USE_PIPELINE_CLOCK;
1712
1713   /* some default SDES entries */
1714   str = g_strdup_printf ("%s@%s", g_get_user_name (), g_get_host_name ());
1715   rtpbin->sdes = gst_structure_new ("application/x-rtp-source-sdes",
1716       "cname", G_TYPE_STRING, str,
1717       "name", G_TYPE_STRING, g_get_real_name (),
1718       "tool", G_TYPE_STRING, "GStreamer", NULL);
1719   g_free (str);
1720 }
1721
1722 static void
1723 gst_rtp_bin_dispose (GObject * object)
1724 {
1725   GstRtpBin *rtpbin;
1726
1727   rtpbin = GST_RTP_BIN (object);
1728
1729   GST_DEBUG_OBJECT (object, "freeing sessions");
1730   g_slist_foreach (rtpbin->sessions, (GFunc) free_session, rtpbin);
1731   g_slist_free (rtpbin->sessions);
1732   rtpbin->sessions = NULL;
1733   GST_DEBUG_OBJECT (object, "freeing clients");
1734   g_slist_foreach (rtpbin->clients, (GFunc) free_client, rtpbin);
1735   g_slist_free (rtpbin->clients);
1736   rtpbin->clients = NULL;
1737
1738   G_OBJECT_CLASS (parent_class)->dispose (object);
1739 }
1740
1741 static void
1742 gst_rtp_bin_finalize (GObject * object)
1743 {
1744   GstRtpBin *rtpbin;
1745
1746   rtpbin = GST_RTP_BIN (object);
1747
1748   if (rtpbin->sdes)
1749     gst_structure_free (rtpbin->sdes);
1750
1751   g_mutex_free (rtpbin->priv->bin_lock);
1752   g_mutex_free (rtpbin->priv->dyn_lock);
1753
1754   G_OBJECT_CLASS (parent_class)->finalize (object);
1755 }
1756
1757
1758 static void
1759 gst_rtp_bin_set_sdes_struct (GstRtpBin * bin, const GstStructure * sdes)
1760 {
1761   GSList *item;
1762
1763   if (sdes == NULL)
1764     return;
1765
1766   GST_RTP_BIN_LOCK (bin);
1767
1768   GST_OBJECT_LOCK (bin);
1769   if (bin->sdes)
1770     gst_structure_free (bin->sdes);
1771   bin->sdes = gst_structure_copy (sdes);
1772   GST_OBJECT_UNLOCK (bin);
1773
1774   /* store in all sessions */
1775   for (item = bin->sessions; item; item = g_slist_next (item)) {
1776     GstRtpBinSession *session = item->data;
1777     g_object_set (session->session, "sdes", sdes, NULL);
1778   }
1779
1780   GST_RTP_BIN_UNLOCK (bin);
1781 }
1782
1783 static GstStructure *
1784 gst_rtp_bin_get_sdes_struct (GstRtpBin * bin)
1785 {
1786   GstStructure *result;
1787
1788   GST_OBJECT_LOCK (bin);
1789   result = gst_structure_copy (bin->sdes);
1790   GST_OBJECT_UNLOCK (bin);
1791
1792   return result;
1793 }
1794
1795 static void
1796 gst_rtp_bin_set_property (GObject * object, guint prop_id,
1797     const GValue * value, GParamSpec * pspec)
1798 {
1799   GstRtpBin *rtpbin;
1800
1801   rtpbin = GST_RTP_BIN (object);
1802
1803   switch (prop_id) {
1804     case PROP_LATENCY:
1805       GST_RTP_BIN_LOCK (rtpbin);
1806       rtpbin->latency_ms = g_value_get_uint (value);
1807       rtpbin->latency_ns = rtpbin->latency_ms * GST_MSECOND;
1808       GST_RTP_BIN_UNLOCK (rtpbin);
1809       /* propagate the property down to the jitterbuffer */
1810       gst_rtp_bin_propagate_property_to_jitterbuffer (rtpbin, "latency", value);
1811       break;
1812     case PROP_SDES:
1813       gst_rtp_bin_set_sdes_struct (rtpbin, g_value_get_boxed (value));
1814       break;
1815     case PROP_DO_LOST:
1816       GST_RTP_BIN_LOCK (rtpbin);
1817       rtpbin->do_lost = g_value_get_boolean (value);
1818       GST_RTP_BIN_UNLOCK (rtpbin);
1819       gst_rtp_bin_propagate_property_to_jitterbuffer (rtpbin, "do-lost", value);
1820       break;
1821     case PROP_NTP_SYNC:
1822       rtpbin->ntp_sync = g_value_get_boolean (value);
1823       break;
1824     case PROP_IGNORE_PT:
1825       rtpbin->ignore_pt = g_value_get_boolean (value);
1826       break;
1827     case PROP_AUTOREMOVE:
1828       rtpbin->priv->autoremove = g_value_get_boolean (value);
1829       break;
1830     case PROP_USE_PIPELINE_CLOCK:
1831     {
1832       GSList *sessions;
1833       GST_RTP_BIN_LOCK (rtpbin);
1834       rtpbin->use_pipeline_clock = g_value_get_boolean (value);
1835       for (sessions = rtpbin->sessions; sessions;
1836           sessions = g_slist_next (sessions)) {
1837         GstRtpBinSession *session = (GstRtpBinSession *) sessions->data;
1838
1839         g_object_set (G_OBJECT (session->session),
1840             "use-pipeline-clock", rtpbin->use_pipeline_clock, NULL);
1841       }
1842       GST_RTP_BIN_UNLOCK (rtpbin);
1843     }
1844       break;
1845     case PROP_BUFFER_MODE:
1846       GST_RTP_BIN_LOCK (rtpbin);
1847       rtpbin->buffer_mode = g_value_get_enum (value);
1848       GST_RTP_BIN_UNLOCK (rtpbin);
1849       /* propagate the property down to the jitterbuffer */
1850       gst_rtp_bin_propagate_property_to_jitterbuffer (rtpbin, "mode", value);
1851       break;
1852     default:
1853       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1854       break;
1855   }
1856 }
1857
1858 static void
1859 gst_rtp_bin_get_property (GObject * object, guint prop_id,
1860     GValue * value, GParamSpec * pspec)
1861 {
1862   GstRtpBin *rtpbin;
1863
1864   rtpbin = GST_RTP_BIN (object);
1865
1866   switch (prop_id) {
1867     case PROP_LATENCY:
1868       GST_RTP_BIN_LOCK (rtpbin);
1869       g_value_set_uint (value, rtpbin->latency_ms);
1870       GST_RTP_BIN_UNLOCK (rtpbin);
1871       break;
1872     case PROP_SDES:
1873       g_value_take_boxed (value, gst_rtp_bin_get_sdes_struct (rtpbin));
1874       break;
1875     case PROP_DO_LOST:
1876       GST_RTP_BIN_LOCK (rtpbin);
1877       g_value_set_boolean (value, rtpbin->do_lost);
1878       GST_RTP_BIN_UNLOCK (rtpbin);
1879       break;
1880     case PROP_IGNORE_PT:
1881       g_value_set_boolean (value, rtpbin->ignore_pt);
1882       break;
1883     case PROP_NTP_SYNC:
1884       g_value_set_boolean (value, rtpbin->ntp_sync);
1885       break;
1886     case PROP_AUTOREMOVE:
1887       g_value_set_boolean (value, rtpbin->priv->autoremove);
1888       break;
1889     case PROP_BUFFER_MODE:
1890       g_value_set_enum (value, rtpbin->buffer_mode);
1891       break;
1892     case PROP_USE_PIPELINE_CLOCK:
1893       g_value_set_boolean (value, rtpbin->use_pipeline_clock);
1894       break;
1895     default:
1896       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1897       break;
1898   }
1899 }
1900
1901 static void
1902 gst_rtp_bin_handle_message (GstBin * bin, GstMessage * message)
1903 {
1904   GstRtpBin *rtpbin;
1905
1906   rtpbin = GST_RTP_BIN (bin);
1907
1908   switch (GST_MESSAGE_TYPE (message)) {
1909     case GST_MESSAGE_ELEMENT:
1910     {
1911       const GstStructure *s = gst_message_get_structure (message);
1912
1913       /* we change the structure name and add the session ID to it */
1914       if (gst_structure_has_name (s, "application/x-rtp-source-sdes")) {
1915         GstRtpBinSession *sess;
1916
1917         /* find the session we set it as object data */
1918         sess = g_object_get_data (G_OBJECT (GST_MESSAGE_SRC (message)),
1919             "GstRTPBin.session");
1920
1921         if (G_LIKELY (sess)) {
1922           message = gst_message_make_writable (message);
1923           s = gst_message_get_structure (message);
1924           gst_structure_set ((GstStructure *) s, "session", G_TYPE_UINT,
1925               sess->id, NULL);
1926         }
1927       }
1928       GST_BIN_CLASS (parent_class)->handle_message (bin, message);
1929       break;
1930     }
1931     case GST_MESSAGE_BUFFERING:
1932     {
1933       gint percent;
1934       gint min_percent = 100;
1935       GSList *sessions, *streams;
1936       GstRtpBinStream *stream;
1937       gboolean change = FALSE, active = FALSE;
1938       GstClockTime min_out_time;
1939       GstBufferingMode mode;
1940       gint avg_in, avg_out;
1941       gint64 buffering_left;
1942
1943       gst_message_parse_buffering (message, &percent);
1944       gst_message_parse_buffering_stats (message, &mode, &avg_in, &avg_out,
1945           &buffering_left);
1946
1947       stream =
1948           g_object_get_data (G_OBJECT (GST_MESSAGE_SRC (message)),
1949           "GstRTPBin.stream");
1950
1951       GST_DEBUG_OBJECT (bin, "got percent %d from stream %p", percent, stream);
1952
1953       /* get the stream */
1954       if (G_LIKELY (stream)) {
1955         GST_RTP_BIN_LOCK (rtpbin);
1956         /* fill in the percent */
1957         stream->percent = percent;
1958
1959         /* calculate the min value for all streams */
1960         for (sessions = rtpbin->sessions; sessions;
1961             sessions = g_slist_next (sessions)) {
1962           GstRtpBinSession *session = (GstRtpBinSession *) sessions->data;
1963
1964           GST_RTP_SESSION_LOCK (session);
1965           if (session->streams) {
1966             for (streams = session->streams; streams;
1967                 streams = g_slist_next (streams)) {
1968               GstRtpBinStream *stream = (GstRtpBinStream *) streams->data;
1969
1970               GST_DEBUG_OBJECT (bin, "stream %p percent %d", stream,
1971                   stream->percent);
1972
1973               /* find min percent */
1974               if (min_percent > stream->percent)
1975                 min_percent = stream->percent;
1976             }
1977           } else {
1978             GST_INFO_OBJECT (bin,
1979                 "session has no streams, setting min_percent to 0");
1980             min_percent = 0;
1981           }
1982           GST_RTP_SESSION_UNLOCK (session);
1983         }
1984         GST_DEBUG_OBJECT (bin, "min percent %d", min_percent);
1985
1986         if (rtpbin->buffering) {
1987           if (min_percent == 100) {
1988             rtpbin->buffering = FALSE;
1989             active = TRUE;
1990             change = TRUE;
1991           }
1992         } else {
1993           if (min_percent < 100) {
1994             /* pause the streams */
1995             rtpbin->buffering = TRUE;
1996             active = FALSE;
1997             change = TRUE;
1998           }
1999         }
2000         GST_RTP_BIN_UNLOCK (rtpbin);
2001
2002         gst_message_unref (message);
2003
2004         /* make a new buffering message with the min value */
2005         message =
2006             gst_message_new_buffering (GST_OBJECT_CAST (bin), min_percent);
2007         gst_message_set_buffering_stats (message, mode, avg_in, avg_out,
2008             buffering_left);
2009
2010         if (G_UNLIKELY (change)) {
2011           GstClock *clock;
2012           guint64 running_time = 0;
2013           guint64 offset = 0;
2014
2015           /* figure out the running time when we have a clock */
2016           if (G_LIKELY ((clock =
2017                       gst_element_get_clock (GST_ELEMENT_CAST (bin))))) {
2018             guint64 now, base_time;
2019
2020             now = gst_clock_get_time (clock);
2021             base_time = gst_element_get_base_time (GST_ELEMENT_CAST (bin));
2022             running_time = now - base_time;
2023           }
2024           GST_DEBUG_OBJECT (bin,
2025               "running time now %" GST_TIME_FORMAT,
2026               GST_TIME_ARGS (running_time));
2027
2028           GST_RTP_BIN_LOCK (rtpbin);
2029
2030           /* when we reactivate, calculate the offsets so that all streams have
2031            * an output time that is at least as big as the running_time */
2032           offset = 0;
2033           if (active) {
2034             if (running_time > rtpbin->buffer_start) {
2035               offset = running_time - rtpbin->buffer_start;
2036               if (offset >= rtpbin->latency_ns)
2037                 offset -= rtpbin->latency_ns;
2038               else
2039                 offset = 0;
2040             }
2041           }
2042
2043           /* pause all streams */
2044           min_out_time = -1;
2045           for (sessions = rtpbin->sessions; sessions;
2046               sessions = g_slist_next (sessions)) {
2047             GstRtpBinSession *session = (GstRtpBinSession *) sessions->data;
2048
2049             GST_RTP_SESSION_LOCK (session);
2050             for (streams = session->streams; streams;
2051                 streams = g_slist_next (streams)) {
2052               GstRtpBinStream *stream = (GstRtpBinStream *) streams->data;
2053               GstElement *element = stream->buffer;
2054               guint64 last_out;
2055
2056               g_signal_emit_by_name (element, "set-active", active, offset,
2057                   &last_out);
2058
2059               if (!active) {
2060                 g_object_get (element, "percent", &stream->percent, NULL);
2061
2062                 if (last_out == -1)
2063                   last_out = 0;
2064                 if (min_out_time == -1 || last_out < min_out_time)
2065                   min_out_time = last_out;
2066               }
2067
2068               GST_DEBUG_OBJECT (bin,
2069                   "setting %p to %d, offset %" GST_TIME_FORMAT ", last %"
2070                   GST_TIME_FORMAT ", percent %d", element, active,
2071                   GST_TIME_ARGS (offset), GST_TIME_ARGS (last_out),
2072                   stream->percent);
2073             }
2074             GST_RTP_SESSION_UNLOCK (session);
2075           }
2076           GST_DEBUG_OBJECT (bin,
2077               "min out time %" GST_TIME_FORMAT, GST_TIME_ARGS (min_out_time));
2078
2079           /* the buffer_start is the min out time of all paused jitterbuffers */
2080           if (!active)
2081             rtpbin->buffer_start = min_out_time;
2082
2083           GST_RTP_BIN_UNLOCK (rtpbin);
2084         }
2085       }
2086       GST_BIN_CLASS (parent_class)->handle_message (bin, message);
2087       break;
2088     }
2089     default:
2090     {
2091       GST_BIN_CLASS (parent_class)->handle_message (bin, message);
2092       break;
2093     }
2094   }
2095 }
2096
2097 static GstStateChangeReturn
2098 gst_rtp_bin_change_state (GstElement * element, GstStateChange transition)
2099 {
2100   GstStateChangeReturn res;
2101   GstRtpBin *rtpbin;
2102   GstRtpBinPrivate *priv;
2103
2104   rtpbin = GST_RTP_BIN (element);
2105   priv = rtpbin->priv;
2106
2107   switch (transition) {
2108     case GST_STATE_CHANGE_NULL_TO_READY:
2109       break;
2110     case GST_STATE_CHANGE_READY_TO_PAUSED:
2111       GST_LOG_OBJECT (rtpbin, "clearing shutdown flag");
2112       g_atomic_int_set (&priv->shutdown, 0);
2113       break;
2114     case GST_STATE_CHANGE_PAUSED_TO_READY:
2115       GST_LOG_OBJECT (rtpbin, "setting shutdown flag");
2116       g_atomic_int_set (&priv->shutdown, 1);
2117       /* wait for all callbacks to end by taking the lock. No new callbacks will
2118        * be able to happen as we set the shutdown flag. */
2119       GST_RTP_BIN_DYN_LOCK (rtpbin);
2120       GST_LOG_OBJECT (rtpbin, "dynamic lock taken, we can continue shutdown");
2121       GST_RTP_BIN_DYN_UNLOCK (rtpbin);
2122       break;
2123     default:
2124       break;
2125   }
2126
2127   res = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
2128
2129   switch (transition) {
2130     case GST_STATE_CHANGE_PLAYING_TO_PAUSED:
2131       break;
2132     case GST_STATE_CHANGE_PAUSED_TO_READY:
2133       break;
2134     case GST_STATE_CHANGE_READY_TO_NULL:
2135       break;
2136     default:
2137       break;
2138   }
2139   return res;
2140 }
2141
2142 /* a new pad (SSRC) was created in @session. This signal is emited from the
2143  * payload demuxer. */
2144 static void
2145 new_payload_found (GstElement * element, guint pt, GstPad * pad,
2146     GstRtpBinStream * stream)
2147 {
2148   GstRtpBin *rtpbin;
2149   GstElementClass *klass;
2150   GstPadTemplate *templ;
2151   gchar *padname;
2152   GstPad *gpad;
2153
2154   rtpbin = stream->bin;
2155
2156   GST_DEBUG ("new payload pad %d", pt);
2157
2158   GST_RTP_BIN_SHUTDOWN_LOCK (rtpbin, shutdown);
2159
2160   /* ghost the pad to the parent */
2161   klass = GST_ELEMENT_GET_CLASS (rtpbin);
2162   templ = gst_element_class_get_pad_template (klass, "recv_rtp_src_%d_%d_%d");
2163   padname = g_strdup_printf ("recv_rtp_src_%d_%u_%d",
2164       stream->session->id, stream->ssrc, pt);
2165   gpad = gst_ghost_pad_new_from_template (padname, pad, templ);
2166   g_free (padname);
2167   g_object_set_data (G_OBJECT (pad), "GstRTPBin.ghostpad", gpad);
2168
2169   gst_pad_set_active (gpad, TRUE);
2170   GST_RTP_BIN_SHUTDOWN_UNLOCK (rtpbin);
2171
2172   gst_element_add_pad (GST_ELEMENT_CAST (rtpbin), gpad);
2173
2174   return;
2175
2176 shutdown:
2177   {
2178     GST_DEBUG ("ignoring, we are shutting down");
2179     return;
2180   }
2181 }
2182
2183 static void
2184 payload_pad_removed (GstElement * element, GstPad * pad,
2185     GstRtpBinStream * stream)
2186 {
2187   GstRtpBin *rtpbin;
2188   GstPad *gpad;
2189
2190   rtpbin = stream->bin;
2191
2192   GST_DEBUG ("payload pad removed");
2193
2194   GST_RTP_BIN_DYN_LOCK (rtpbin);
2195   if ((gpad = g_object_get_data (G_OBJECT (pad), "GstRTPBin.ghostpad"))) {
2196     g_object_set_data (G_OBJECT (pad), "GstRTPBin.ghostpad", NULL);
2197
2198     gst_pad_set_active (gpad, FALSE);
2199     gst_element_remove_pad (GST_ELEMENT_CAST (rtpbin), gpad);
2200   }
2201   GST_RTP_BIN_DYN_UNLOCK (rtpbin);
2202 }
2203
2204 static GstCaps *
2205 pt_map_requested (GstElement * element, guint pt, GstRtpBinSession * session)
2206 {
2207   GstRtpBin *rtpbin;
2208   GstCaps *caps;
2209
2210   rtpbin = session->bin;
2211
2212   GST_DEBUG_OBJECT (rtpbin, "payload map requested for pt %d in session %d", pt,
2213       session->id);
2214
2215   caps = get_pt_map (session, pt);
2216   if (!caps)
2217     goto no_caps;
2218
2219   return caps;
2220
2221   /* ERRORS */
2222 no_caps:
2223   {
2224     GST_DEBUG_OBJECT (rtpbin, "could not get caps");
2225     return NULL;
2226   }
2227 }
2228
2229 static void
2230 payload_type_change (GstElement * element, guint pt, GstRtpBinSession * session)
2231 {
2232   GST_DEBUG_OBJECT (session->bin,
2233       "emiting signal for pt type changed to %d in session %d", pt,
2234       session->id);
2235
2236   g_signal_emit (session->bin, gst_rtp_bin_signals[SIGNAL_PAYLOAD_TYPE_CHANGE],
2237       0, session->id, pt);
2238 }
2239
2240 /* emited when caps changed for the session */
2241 static void
2242 caps_changed (GstPad * pad, GParamSpec * pspec, GstRtpBinSession * session)
2243 {
2244   GstRtpBin *bin;
2245   GstCaps *caps;
2246   gint payload;
2247   const GstStructure *s;
2248
2249   bin = session->bin;
2250
2251   g_object_get (pad, "caps", &caps, NULL);
2252
2253   if (caps == NULL)
2254     return;
2255
2256   GST_DEBUG_OBJECT (bin, "got caps %" GST_PTR_FORMAT, caps);
2257
2258   s = gst_caps_get_structure (caps, 0);
2259
2260   /* get payload, finish when it's not there */
2261   if (!gst_structure_get_int (s, "payload", &payload))
2262     return;
2263
2264   GST_RTP_SESSION_LOCK (session);
2265   GST_DEBUG_OBJECT (bin, "insert caps for payload %d", payload);
2266   g_hash_table_insert (session->ptmap, GINT_TO_POINTER (payload), caps);
2267   GST_RTP_SESSION_UNLOCK (session);
2268 }
2269
2270 /* a new pad (SSRC) was created in @session */
2271 static void
2272 new_ssrc_pad_found (GstElement * element, guint ssrc, GstPad * pad,
2273     GstRtpBinSession * session)
2274 {
2275   GstRtpBin *rtpbin;
2276   GstRtpBinStream *stream;
2277   GstPad *sinkpad, *srcpad;
2278   gchar *padname;
2279
2280   rtpbin = session->bin;
2281
2282   GST_DEBUG_OBJECT (rtpbin, "new SSRC pad %08x, %s:%s", ssrc,
2283       GST_DEBUG_PAD_NAME (pad));
2284
2285   GST_RTP_BIN_SHUTDOWN_LOCK (rtpbin, shutdown);
2286
2287   GST_RTP_SESSION_LOCK (session);
2288
2289   /* create new stream */
2290   stream = create_stream (session, ssrc);
2291   if (!stream)
2292     goto no_stream;
2293
2294   /* get pad and link */
2295   GST_DEBUG_OBJECT (rtpbin, "linking jitterbuffer RTP");
2296   padname = g_strdup_printf ("src_%d", ssrc);
2297   srcpad = gst_element_get_static_pad (element, padname);
2298   g_free (padname);
2299   sinkpad = gst_element_get_static_pad (stream->buffer, "sink");
2300   gst_pad_link (srcpad, sinkpad);
2301   gst_object_unref (sinkpad);
2302   gst_object_unref (srcpad);
2303
2304   GST_DEBUG_OBJECT (rtpbin, "linking jitterbuffer RTCP");
2305   padname = g_strdup_printf ("rtcp_src_%d", ssrc);
2306   srcpad = gst_element_get_static_pad (element, padname);
2307   g_free (padname);
2308   sinkpad = gst_element_get_request_pad (stream->buffer, "sink_rtcp");
2309   gst_pad_link (srcpad, sinkpad);
2310   gst_object_unref (sinkpad);
2311   gst_object_unref (srcpad);
2312
2313   /* connect to the RTCP sync signal from the jitterbuffer */
2314   GST_DEBUG_OBJECT (rtpbin, "connecting sync signal");
2315   stream->buffer_handlesync_sig = g_signal_connect (stream->buffer,
2316       "handle-sync", (GCallback) gst_rtp_bin_handle_sync, stream);
2317
2318   if (stream->demux) {
2319     /* connect to the new-pad signal of the payload demuxer, this will expose the
2320      * new pad by ghosting it. */
2321     stream->demux_newpad_sig = g_signal_connect (stream->demux,
2322         "new-payload-type", (GCallback) new_payload_found, stream);
2323     stream->demux_padremoved_sig = g_signal_connect (stream->demux,
2324         "pad-removed", (GCallback) payload_pad_removed, stream);
2325
2326     /* connect to the request-pt-map signal. This signal will be emited by the
2327      * demuxer so that it can apply a proper caps on the buffers for the
2328      * depayloaders. */
2329     stream->demux_ptreq_sig = g_signal_connect (stream->demux,
2330         "request-pt-map", (GCallback) pt_map_requested, session);
2331     /* connect to the  signal so it can be forwarded. */
2332     stream->demux_ptchange_sig = g_signal_connect (stream->demux,
2333         "payload-type-change", (GCallback) payload_type_change, session);
2334   } else {
2335     /* add gstrtpjitterbuffer src pad to pads */
2336     GstElementClass *klass;
2337     GstPadTemplate *templ;
2338     gchar *padname;
2339     GstPad *gpad, *pad;
2340
2341     pad = gst_element_get_static_pad (stream->buffer, "src");
2342
2343     /* ghost the pad to the parent */
2344     klass = GST_ELEMENT_GET_CLASS (rtpbin);
2345     templ = gst_element_class_get_pad_template (klass, "recv_rtp_src_%d_%d_%d");
2346     padname = g_strdup_printf ("recv_rtp_src_%d_%u_%d",
2347         stream->session->id, stream->ssrc, 255);
2348     gpad = gst_ghost_pad_new_from_template (padname, pad, templ);
2349     g_free (padname);
2350
2351     gst_pad_set_active (gpad, TRUE);
2352     gst_element_add_pad (GST_ELEMENT_CAST (rtpbin), gpad);
2353
2354     gst_object_unref (pad);
2355   }
2356
2357   GST_RTP_SESSION_UNLOCK (session);
2358   GST_RTP_BIN_SHUTDOWN_UNLOCK (rtpbin);
2359
2360   return;
2361
2362   /* ERRORS */
2363 shutdown:
2364   {
2365     GST_DEBUG_OBJECT (rtpbin, "we are shutting down");
2366     return;
2367   }
2368 no_stream:
2369   {
2370     GST_RTP_SESSION_UNLOCK (session);
2371     GST_RTP_BIN_SHUTDOWN_UNLOCK (rtpbin);
2372     GST_DEBUG_OBJECT (rtpbin, "could not create stream");
2373     return;
2374   }
2375 }
2376
2377 /* Create a pad for receiving RTP for the session in @name. Must be called with
2378  * RTP_BIN_LOCK.
2379  */
2380 static GstPad *
2381 create_recv_rtp (GstRtpBin * rtpbin, GstPadTemplate * templ, const gchar * name)
2382 {
2383   GstPad *sinkdpad;
2384   guint sessid;
2385   GstRtpBinSession *session;
2386   GstPadLinkReturn lres;
2387
2388   /* first get the session number */
2389   if (name == NULL || sscanf (name, "recv_rtp_sink_%d", &sessid) != 1)
2390     goto no_name;
2391
2392   GST_DEBUG_OBJECT (rtpbin, "finding session %d", sessid);
2393
2394   /* get or create session */
2395   session = find_session_by_id (rtpbin, sessid);
2396   if (!session) {
2397     GST_DEBUG_OBJECT (rtpbin, "creating session %d", sessid);
2398     /* create session now */
2399     session = create_session (rtpbin, sessid);
2400     if (session == NULL)
2401       goto create_error;
2402   }
2403
2404   /* check if pad was requested */
2405   if (session->recv_rtp_sink_ghost != NULL)
2406     return session->recv_rtp_sink_ghost;
2407
2408   GST_DEBUG_OBJECT (rtpbin, "getting RTP sink pad");
2409   /* get recv_rtp pad and store */
2410   session->recv_rtp_sink =
2411       gst_element_get_request_pad (session->session, "recv_rtp_sink");
2412   if (session->recv_rtp_sink == NULL)
2413     goto pad_failed;
2414
2415   g_signal_connect (session->recv_rtp_sink, "notify::caps",
2416       (GCallback) caps_changed, session);
2417
2418   GST_DEBUG_OBJECT (rtpbin, "getting RTP src pad");
2419   /* get srcpad, link to SSRCDemux */
2420   session->recv_rtp_src =
2421       gst_element_get_static_pad (session->session, "recv_rtp_src");
2422   if (session->recv_rtp_src == NULL)
2423     goto pad_failed;
2424
2425   GST_DEBUG_OBJECT (rtpbin, "getting demuxer RTP sink pad");
2426   sinkdpad = gst_element_get_static_pad (session->demux, "sink");
2427   GST_DEBUG_OBJECT (rtpbin, "linking demuxer RTP sink pad");
2428   lres = gst_pad_link (session->recv_rtp_src, sinkdpad);
2429   gst_object_unref (sinkdpad);
2430   if (lres != GST_PAD_LINK_OK)
2431     goto link_failed;
2432
2433   /* connect to the new-ssrc-pad signal of the SSRC demuxer */
2434   session->demux_newpad_sig = g_signal_connect (session->demux,
2435       "new-ssrc-pad", (GCallback) new_ssrc_pad_found, session);
2436   session->demux_padremoved_sig = g_signal_connect (session->demux,
2437       "removed-ssrc-pad", (GCallback) ssrc_demux_pad_removed, session);
2438
2439   GST_DEBUG_OBJECT (rtpbin, "ghosting session sink pad");
2440   session->recv_rtp_sink_ghost =
2441       gst_ghost_pad_new_from_template (name, session->recv_rtp_sink, templ);
2442   gst_pad_set_active (session->recv_rtp_sink_ghost, TRUE);
2443   gst_element_add_pad (GST_ELEMENT_CAST (rtpbin), session->recv_rtp_sink_ghost);
2444
2445   return session->recv_rtp_sink_ghost;
2446
2447   /* ERRORS */
2448 no_name:
2449   {
2450     g_warning ("gstrtpbin: invalid name given");
2451     return NULL;
2452   }
2453 create_error:
2454   {
2455     /* create_session already warned */
2456     return NULL;
2457   }
2458 pad_failed:
2459   {
2460     g_warning ("gstrtpbin: failed to get session pad");
2461     return NULL;
2462   }
2463 link_failed:
2464   {
2465     g_warning ("gstrtpbin: failed to link pads");
2466     return NULL;
2467   }
2468 }
2469
2470 static void
2471 remove_recv_rtp (GstRtpBin * rtpbin, GstRtpBinSession * session)
2472 {
2473   if (session->demux_newpad_sig) {
2474     g_signal_handler_disconnect (session->demux, session->demux_newpad_sig);
2475     session->demux_newpad_sig = 0;
2476   }
2477   if (session->demux_padremoved_sig) {
2478     g_signal_handler_disconnect (session->demux, session->demux_padremoved_sig);
2479     session->demux_padremoved_sig = 0;
2480   }
2481   if (session->recv_rtp_src) {
2482     gst_object_unref (session->recv_rtp_src);
2483     session->recv_rtp_src = NULL;
2484   }
2485   if (session->recv_rtp_sink) {
2486     gst_element_release_request_pad (session->session, session->recv_rtp_sink);
2487     gst_object_unref (session->recv_rtp_sink);
2488     session->recv_rtp_sink = NULL;
2489   }
2490   if (session->recv_rtp_sink_ghost) {
2491     gst_pad_set_active (session->recv_rtp_sink_ghost, FALSE);
2492     gst_element_remove_pad (GST_ELEMENT_CAST (rtpbin),
2493         session->recv_rtp_sink_ghost);
2494     session->recv_rtp_sink_ghost = NULL;
2495   }
2496 }
2497
2498 /* Create a pad for receiving RTCP for the session in @name. Must be called with
2499  * RTP_BIN_LOCK.
2500  */
2501 static GstPad *
2502 create_recv_rtcp (GstRtpBin * rtpbin, GstPadTemplate * templ,
2503     const gchar * name)
2504 {
2505   guint sessid;
2506   GstRtpBinSession *session;
2507   GstPad *sinkdpad;
2508   GstPadLinkReturn lres;
2509
2510   /* first get the session number */
2511   if (name == NULL || sscanf (name, "recv_rtcp_sink_%d", &sessid) != 1)
2512     goto no_name;
2513
2514   GST_DEBUG_OBJECT (rtpbin, "finding session %d", sessid);
2515
2516   /* get or create the session */
2517   session = find_session_by_id (rtpbin, sessid);
2518   if (!session) {
2519     GST_DEBUG_OBJECT (rtpbin, "creating session %d", sessid);
2520     /* create session now */
2521     session = create_session (rtpbin, sessid);
2522     if (session == NULL)
2523       goto create_error;
2524   }
2525
2526   /* check if pad was requested */
2527   if (session->recv_rtcp_sink_ghost != NULL)
2528     return session->recv_rtcp_sink_ghost;
2529
2530   /* get recv_rtp pad and store */
2531   GST_DEBUG_OBJECT (rtpbin, "getting RTCP sink pad");
2532   session->recv_rtcp_sink =
2533       gst_element_get_request_pad (session->session, "recv_rtcp_sink");
2534   if (session->recv_rtcp_sink == NULL)
2535     goto pad_failed;
2536
2537   /* get srcpad, link to SSRCDemux */
2538   GST_DEBUG_OBJECT (rtpbin, "getting sync src pad");
2539   session->sync_src = gst_element_get_static_pad (session->session, "sync_src");
2540   if (session->sync_src == NULL)
2541     goto pad_failed;
2542
2543   GST_DEBUG_OBJECT (rtpbin, "getting demuxer RTCP sink pad");
2544   sinkdpad = gst_element_get_static_pad (session->demux, "rtcp_sink");
2545   lres = gst_pad_link (session->sync_src, sinkdpad);
2546   gst_object_unref (sinkdpad);
2547   if (lres != GST_PAD_LINK_OK)
2548     goto link_failed;
2549
2550   session->recv_rtcp_sink_ghost =
2551       gst_ghost_pad_new_from_template (name, session->recv_rtcp_sink, templ);
2552   gst_pad_set_active (session->recv_rtcp_sink_ghost, TRUE);
2553   gst_element_add_pad (GST_ELEMENT_CAST (rtpbin),
2554       session->recv_rtcp_sink_ghost);
2555
2556   return session->recv_rtcp_sink_ghost;
2557
2558   /* ERRORS */
2559 no_name:
2560   {
2561     g_warning ("gstrtpbin: invalid name given");
2562     return NULL;
2563   }
2564 create_error:
2565   {
2566     /* create_session already warned */
2567     return NULL;
2568   }
2569 pad_failed:
2570   {
2571     g_warning ("gstrtpbin: failed to get session pad");
2572     return NULL;
2573   }
2574 link_failed:
2575   {
2576     g_warning ("gstrtpbin: failed to link pads");
2577     return NULL;
2578   }
2579 }
2580
2581 static void
2582 remove_recv_rtcp (GstRtpBin * rtpbin, GstRtpBinSession * session)
2583 {
2584   if (session->recv_rtcp_sink_ghost) {
2585     gst_pad_set_active (session->recv_rtcp_sink_ghost, FALSE);
2586     gst_element_remove_pad (GST_ELEMENT_CAST (rtpbin),
2587         session->recv_rtcp_sink_ghost);
2588     session->recv_rtcp_sink_ghost = NULL;
2589   }
2590   if (session->sync_src) {
2591     /* releasing the request pad should also unref the sync pad */
2592     gst_object_unref (session->sync_src);
2593     session->sync_src = NULL;
2594   }
2595   if (session->recv_rtcp_sink) {
2596     gst_element_release_request_pad (session->session, session->recv_rtcp_sink);
2597     gst_object_unref (session->recv_rtcp_sink);
2598     session->recv_rtcp_sink = NULL;
2599   }
2600 }
2601
2602 /* Create a pad for sending RTP for the session in @name. Must be called with
2603  * RTP_BIN_LOCK.
2604  */
2605 static GstPad *
2606 create_send_rtp (GstRtpBin * rtpbin, GstPadTemplate * templ, const gchar * name)
2607 {
2608   gchar *gname;
2609   guint sessid;
2610   GstRtpBinSession *session;
2611   GstElementClass *klass;
2612
2613   /* first get the session number */
2614   if (name == NULL || sscanf (name, "send_rtp_sink_%d", &sessid) != 1)
2615     goto no_name;
2616
2617   /* get or create session */
2618   session = find_session_by_id (rtpbin, sessid);
2619   if (!session) {
2620     /* create session now */
2621     session = create_session (rtpbin, sessid);
2622     if (session == NULL)
2623       goto create_error;
2624   }
2625
2626   /* check if pad was requested */
2627   if (session->send_rtp_sink_ghost != NULL)
2628     return session->send_rtp_sink_ghost;
2629
2630   /* get send_rtp pad and store */
2631   session->send_rtp_sink =
2632       gst_element_get_request_pad (session->session, "send_rtp_sink");
2633   if (session->send_rtp_sink == NULL)
2634     goto pad_failed;
2635
2636   session->send_rtp_sink_ghost =
2637       gst_ghost_pad_new_from_template (name, session->send_rtp_sink, templ);
2638   gst_pad_set_active (session->send_rtp_sink_ghost, TRUE);
2639   gst_element_add_pad (GST_ELEMENT_CAST (rtpbin), session->send_rtp_sink_ghost);
2640
2641   /* get srcpad */
2642   session->send_rtp_src =
2643       gst_element_get_static_pad (session->session, "send_rtp_src");
2644   if (session->send_rtp_src == NULL)
2645     goto no_srcpad;
2646
2647   /* ghost the new source pad */
2648   klass = GST_ELEMENT_GET_CLASS (rtpbin);
2649   gname = g_strdup_printf ("send_rtp_src_%d", sessid);
2650   templ = gst_element_class_get_pad_template (klass, "send_rtp_src_%d");
2651   session->send_rtp_src_ghost =
2652       gst_ghost_pad_new_from_template (gname, session->send_rtp_src, templ);
2653   gst_pad_set_active (session->send_rtp_src_ghost, TRUE);
2654   gst_element_add_pad (GST_ELEMENT_CAST (rtpbin), session->send_rtp_src_ghost);
2655   g_free (gname);
2656
2657   return session->send_rtp_sink_ghost;
2658
2659   /* ERRORS */
2660 no_name:
2661   {
2662     g_warning ("gstrtpbin: invalid name given");
2663     return NULL;
2664   }
2665 create_error:
2666   {
2667     /* create_session already warned */
2668     return NULL;
2669   }
2670 pad_failed:
2671   {
2672     g_warning ("gstrtpbin: failed to get session pad for session %d", sessid);
2673     return NULL;
2674   }
2675 no_srcpad:
2676   {
2677     g_warning ("gstrtpbin: failed to get rtp source pad for session %d",
2678         sessid);
2679     return NULL;
2680   }
2681 }
2682
2683 static void
2684 remove_send_rtp (GstRtpBin * rtpbin, GstRtpBinSession * session)
2685 {
2686   if (session->send_rtp_src_ghost) {
2687     gst_pad_set_active (session->send_rtp_src_ghost, FALSE);
2688     gst_element_remove_pad (GST_ELEMENT_CAST (rtpbin),
2689         session->send_rtp_src_ghost);
2690     session->send_rtp_src_ghost = NULL;
2691   }
2692   if (session->send_rtp_src) {
2693     gst_object_unref (session->send_rtp_src);
2694     session->send_rtp_src = NULL;
2695   }
2696   if (session->send_rtp_sink) {
2697     gst_element_release_request_pad (GST_ELEMENT_CAST (session->session),
2698         session->send_rtp_sink);
2699     gst_object_unref (session->send_rtp_sink);
2700     session->send_rtp_sink = NULL;
2701   }
2702   if (session->send_rtp_sink_ghost) {
2703     gst_pad_set_active (session->send_rtp_sink_ghost, FALSE);
2704     gst_element_remove_pad (GST_ELEMENT_CAST (rtpbin),
2705         session->send_rtp_sink_ghost);
2706     session->send_rtp_sink_ghost = NULL;
2707   }
2708 }
2709
2710 /* Create a pad for sending RTCP for the session in @name. Must be called with
2711  * RTP_BIN_LOCK.
2712  */
2713 static GstPad *
2714 create_rtcp (GstRtpBin * rtpbin, GstPadTemplate * templ, const gchar * name)
2715 {
2716   guint sessid;
2717   GstRtpBinSession *session;
2718
2719   /* first get the session number */
2720   if (name == NULL || sscanf (name, "send_rtcp_src_%d", &sessid) != 1)
2721     goto no_name;
2722
2723   /* get or create session */
2724   session = find_session_by_id (rtpbin, sessid);
2725   if (!session)
2726     goto no_session;
2727
2728   /* check if pad was requested */
2729   if (session->send_rtcp_src_ghost != NULL)
2730     return session->send_rtcp_src_ghost;
2731
2732   /* get rtcp_src pad and store */
2733   session->send_rtcp_src =
2734       gst_element_get_request_pad (session->session, "send_rtcp_src");
2735   if (session->send_rtcp_src == NULL)
2736     goto pad_failed;
2737
2738   session->send_rtcp_src_ghost =
2739       gst_ghost_pad_new_from_template (name, session->send_rtcp_src, templ);
2740   gst_pad_set_active (session->send_rtcp_src_ghost, TRUE);
2741   gst_element_add_pad (GST_ELEMENT_CAST (rtpbin), session->send_rtcp_src_ghost);
2742
2743   return session->send_rtcp_src_ghost;
2744
2745   /* ERRORS */
2746 no_name:
2747   {
2748     g_warning ("gstrtpbin: invalid name given");
2749     return NULL;
2750   }
2751 no_session:
2752   {
2753     g_warning ("gstrtpbin: session with id %d does not exist", sessid);
2754     return NULL;
2755   }
2756 pad_failed:
2757   {
2758     g_warning ("gstrtpbin: failed to get rtcp pad for session %d", sessid);
2759     return NULL;
2760   }
2761 }
2762
2763 static void
2764 remove_rtcp (GstRtpBin * rtpbin, GstRtpBinSession * session)
2765 {
2766   if (session->send_rtcp_src_ghost) {
2767     gst_pad_set_active (session->send_rtcp_src_ghost, FALSE);
2768     gst_element_remove_pad (GST_ELEMENT_CAST (rtpbin),
2769         session->send_rtcp_src_ghost);
2770     session->send_rtcp_src_ghost = NULL;
2771   }
2772   if (session->send_rtcp_src) {
2773     gst_element_release_request_pad (session->session, session->send_rtcp_src);
2774     gst_object_unref (session->send_rtcp_src);
2775     session->send_rtcp_src = NULL;
2776   }
2777 }
2778
2779 /* If the requested name is NULL we should create a name with
2780  * the session number assuming we want the lowest posible session
2781  * with a free pad like the template */
2782 static gchar *
2783 gst_rtp_bin_get_free_pad_name (GstElement * element, GstPadTemplate * templ)
2784 {
2785   gboolean name_found = FALSE;
2786   gint session = 0;
2787   GstIterator *pad_it = NULL;
2788   gchar *pad_name = NULL;
2789   GValue data = { 0, };
2790
2791   GST_DEBUG_OBJECT (element, "find a free pad name for template");
2792   while (!name_found) {
2793     gboolean done = FALSE;
2794
2795     g_free (pad_name);
2796     pad_name = g_strdup_printf (templ->name_template, session++);
2797     pad_it = gst_element_iterate_pads (GST_ELEMENT (element));
2798     name_found = TRUE;
2799     while (!done) {
2800       switch (gst_iterator_next (pad_it, &data)) {
2801         case GST_ITERATOR_OK:
2802         {
2803           GstPad *pad;
2804           gchar *name;
2805
2806           pad = g_value_get_object (&data);
2807           name = gst_pad_get_name (pad);
2808
2809           if (strcmp (name, pad_name) == 0) {
2810             done = TRUE;
2811             name_found = FALSE;
2812           }
2813           g_free (name);
2814           g_value_reset (&data);
2815           break;
2816         }
2817         case GST_ITERATOR_ERROR:
2818         case GST_ITERATOR_RESYNC:
2819           /* restart iteration */
2820           done = TRUE;
2821           name_found = FALSE;
2822           session = 0;
2823           break;
2824         case GST_ITERATOR_DONE:
2825           done = TRUE;
2826           break;
2827       }
2828     }
2829     g_value_unset (&data);
2830     gst_iterator_free (pad_it);
2831   }
2832
2833   GST_DEBUG_OBJECT (element, "free pad name found: '%s'", pad_name);
2834   return pad_name;
2835 }
2836
2837 /*
2838  */
2839 static GstPad *
2840 gst_rtp_bin_request_new_pad (GstElement * element,
2841     GstPadTemplate * templ, const gchar * name, const GstCaps * caps)
2842 {
2843   GstRtpBin *rtpbin;
2844   GstElementClass *klass;
2845   GstPad *result;
2846
2847   gchar *pad_name = NULL;
2848
2849   g_return_val_if_fail (templ != NULL, NULL);
2850   g_return_val_if_fail (GST_IS_RTP_BIN (element), NULL);
2851
2852   rtpbin = GST_RTP_BIN (element);
2853   klass = GST_ELEMENT_GET_CLASS (element);
2854
2855   GST_RTP_BIN_LOCK (rtpbin);
2856
2857   if (name == NULL) {
2858     /* use a free pad name */
2859     pad_name = gst_rtp_bin_get_free_pad_name (element, templ);
2860   } else {
2861     /* use the provided name */
2862     pad_name = g_strdup (name);
2863   }
2864
2865   GST_DEBUG_OBJECT (rtpbin, "Trying to request a pad with name %s", pad_name);
2866
2867   /* figure out the template */
2868   if (templ == gst_element_class_get_pad_template (klass, "recv_rtp_sink_%d")) {
2869     result = create_recv_rtp (rtpbin, templ, pad_name);
2870   } else if (templ == gst_element_class_get_pad_template (klass,
2871           "recv_rtcp_sink_%d")) {
2872     result = create_recv_rtcp (rtpbin, templ, pad_name);
2873   } else if (templ == gst_element_class_get_pad_template (klass,
2874           "send_rtp_sink_%d")) {
2875     result = create_send_rtp (rtpbin, templ, pad_name);
2876   } else if (templ == gst_element_class_get_pad_template (klass,
2877           "send_rtcp_src_%d")) {
2878     result = create_rtcp (rtpbin, templ, pad_name);
2879   } else
2880     goto wrong_template;
2881
2882   g_free (pad_name);
2883   GST_RTP_BIN_UNLOCK (rtpbin);
2884
2885   return result;
2886
2887   /* ERRORS */
2888 wrong_template:
2889   {
2890     g_free (pad_name);
2891     GST_RTP_BIN_UNLOCK (rtpbin);
2892     g_warning ("gstrtpbin: this is not our template");
2893     return NULL;
2894   }
2895 }
2896
2897 static void
2898 gst_rtp_bin_release_pad (GstElement * element, GstPad * pad)
2899 {
2900   GstRtpBinSession *session;
2901   GstRtpBin *rtpbin;
2902
2903   g_return_if_fail (GST_IS_GHOST_PAD (pad));
2904   g_return_if_fail (GST_IS_RTP_BIN (element));
2905
2906   rtpbin = GST_RTP_BIN (element);
2907
2908   GST_RTP_BIN_LOCK (rtpbin);
2909   GST_DEBUG_OBJECT (rtpbin, "Trying to release pad %s:%s",
2910       GST_DEBUG_PAD_NAME (pad));
2911
2912   if (!(session = find_session_by_pad (rtpbin, pad)))
2913     goto unknown_pad;
2914
2915   if (session->recv_rtp_sink_ghost == pad) {
2916     remove_recv_rtp (rtpbin, session);
2917   } else if (session->recv_rtcp_sink_ghost == pad) {
2918     remove_recv_rtcp (rtpbin, session);
2919   } else if (session->send_rtp_sink_ghost == pad) {
2920     remove_send_rtp (rtpbin, session);
2921   } else if (session->send_rtcp_src_ghost == pad) {
2922     remove_rtcp (rtpbin, session);
2923   }
2924
2925   /* no more request pads, free the complete session */
2926   if (session->recv_rtp_sink_ghost == NULL
2927       && session->recv_rtcp_sink_ghost == NULL
2928       && session->send_rtp_sink_ghost == NULL
2929       && session->send_rtcp_src_ghost == NULL) {
2930     GST_DEBUG_OBJECT (rtpbin, "no more pads for session %p", session);
2931     rtpbin->sessions = g_slist_remove (rtpbin->sessions, session);
2932     free_session (session, rtpbin);
2933   }
2934   GST_RTP_BIN_UNLOCK (rtpbin);
2935
2936   return;
2937
2938   /* ERROR */
2939 unknown_pad:
2940   {
2941     GST_RTP_BIN_UNLOCK (rtpbin);
2942     g_warning ("gstrtpbin: %s:%s is not one of our request pads",
2943         GST_DEBUG_PAD_NAME (pad));
2944     return;
2945   }
2946 }