gst/rtpmanager/gstrtpbin.h

   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., 51 Franklin St, Fifth Floor,
  17  * Boston, MA 02110-1301, USA.
  18  */
  19
  20 #ifndef __GST_RTP_BIN_H__
  21 #define __GST_RTP_BIN_H__
  22
  23 #include <gst/gst.h>
  24
  25 #include "rtpsession.h"
  26 #include "gstrtpsession.h"
  27 #include "rtpjitterbuffer.h"
  28
  29 #define GST_TYPE_RTP_BIN \
  30   (gst_rtp_bin_get_type())
  31 #define GST_RTP_BIN(obj) \
  32   (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_RTP_BIN,GstRtpBin))
  33 #define GST_RTP_BIN_CLASS(klass) \
  34   (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_RTP_BIN,GstRtpBinClass))
  35 #define GST_IS_RTP_BIN(obj) \
  36   (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_RTP_BIN))
  37 #define GST_IS_RTP_BIN_CLASS(klass) \
  38   (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_RTP_BIN))
  39
  40 typedef enum
  41 {
  42   GST_RTP_BIN_RTCP_SYNC_ALWAYS,
  43   GST_RTP_BIN_RTCP_SYNC_INITIAL,
  44   GST_RTP_BIN_RTCP_SYNC_RTP
  45 } GstRTCPSync;
  46
  47 typedef struct _GstRtpBin GstRtpBin;
  48 typedef struct _GstRtpBinClass GstRtpBinClass;
  49 typedef struct _GstRtpBinPrivate GstRtpBinPrivate;
  50
  51 struct _GstRtpBin {
  52   GstBin         bin;
  53
  54   /*< private >*/
  55   /* default latency for sessions */
  56   guint           latency_ms;
  57   guint64         latency_ns;
  58   gboolean        drop_on_latency;
  59   gboolean        do_lost;
  60   gboolean        ignore_pt;
  61   gboolean        ntp_sync;
  62   gint            rtcp_sync;
  63   guint           rtcp_sync_interval;
  64   RTPJitterBufferMode buffer_mode;
  65   gboolean        buffering;
  66   gboolean        use_pipeline_clock;
  67   GstRtpNtpTimeSource ntp_time_source;
  68   gboolean        send_sync_event;
  69   GstClockTime    buffer_start;
  70   gboolean        do_retransmission;
  71   GstRTPProfile   rtp_profile;
  72
  73   /* a list of session */
  74   GSList         *sessions;
  75
  76   /* a list of clients, these are streams with the same CNAME */
  77   GSList         *clients;
  78
  79   /* the default SDES items for sessions */
  80   GstStructure   *sdes;
  81
  82   /*< private >*/
  83   GstRtpBinPrivate *priv;
  84 };
  85
  86 struct _GstRtpBinClass {
  87   GstBinClass  parent_class;
  88
  89   /* get the caps for pt */
  90   GstCaps*    (*request_pt_map)       (GstRtpBin *rtpbin, guint session, guint pt);
  91
  92   void        (*payload_type_change)  (GstRtpBin *rtpbin, guint session, guint pt);
  93
  94   void        (*new_jitterbuffer)     (GstRtpBin *rtpbin, GstElement *jitterbuffer, guint session, guint32 ssrc);
  95
  96   /* action signals */
  97   void        (*clear_pt_map)         (GstRtpBin *rtpbin);
  98   void        (*reset_sync)           (GstRtpBin *rtpbin);
  99   RTPSession* (*get_internal_session) (GstRtpBin *rtpbin, guint session);
 100
 101   /* session manager signals */
 102   void     (*on_new_ssrc)       (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 103   void     (*on_ssrc_collision) (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 104   void     (*on_ssrc_validated) (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 105   void     (*on_ssrc_active)    (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 106   void     (*on_ssrc_sdes)      (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 107   void     (*on_bye_ssrc)       (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 108   void     (*on_bye_timeout)    (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 109   void     (*on_timeout)        (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 110   void     (*on_sender_timeout) (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 111   void     (*on_npt_stop)       (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 112
 113   GstElement* (*request_rtp_encoder)  (GstRtpBin *rtpbin, guint session);
 114   GstElement* (*request_rtp_decoder)  (GstRtpBin *rtpbin, guint session);
 115   GstElement* (*request_rtcp_encoder) (GstRtpBin *rtpbin, guint session);
 116   GstElement* (*request_rtcp_decoder) (GstRtpBin *rtpbin, guint session);
 117
 118   GstElement* (*request_aux_sender)   (GstRtpBin *rtpbin, guint session);
 119   GstElement* (*request_aux_receiver) (GstRtpBin *rtpbin, guint session);
 120 };
 121
 122 GType gst_rtp_bin_get_type (void);
 123
 124 #endif /* __GST_RTP_BIN_H__ */