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   gboolean        rtcp_sync_send_time;
  73   gint            max_rtcp_rtp_time_diff;
  74   guint32         max_dropout_time;
  75   guint32         max_misorder_time;
  76   gboolean        rfc7273_sync;
  77   guint           max_streams;
  78
  79   /* a list of session */
  80   GSList         *sessions;
  81
  82   /* a list of clients, these are streams with the same CNAME */
  83   GSList         *clients;
  84
  85   /* the default SDES items for sessions */
  86   GstStructure   *sdes;
  87
  88   /*< private >*/
  89   GstRtpBinPrivate *priv;
  90 };
  91
  92 struct _GstRtpBinClass {
  93   GstBinClass  parent_class;
  94
  95   /* get the caps for pt */
  96   GstCaps*    (*request_pt_map)       (GstRtpBin *rtpbin, guint session, guint pt);
  97
  98   void        (*payload_type_change)  (GstRtpBin *rtpbin, guint session, guint pt);
  99
 100   void        (*new_jitterbuffer)     (GstRtpBin *rtpbin, GstElement *jitterbuffer, guint session, guint32 ssrc);
 101
 102   /* action signals */
 103   void        (*clear_pt_map)         (GstRtpBin *rtpbin);
 104   void        (*reset_sync)           (GstRtpBin *rtpbin);
 105   GstElement* (*get_session)          (GstRtpBin *rtpbin, guint session);
 106   RTPSession* (*get_internal_session) (GstRtpBin *rtpbin, guint session);
 107
 108   /* session manager signals */
 109   void     (*on_new_ssrc)       (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 110   void     (*on_ssrc_collision) (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 111   void     (*on_ssrc_validated) (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 112   void     (*on_ssrc_active)    (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 113   void     (*on_ssrc_sdes)      (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 114   void     (*on_bye_ssrc)       (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 115   void     (*on_bye_timeout)    (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 116   void     (*on_timeout)        (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 117   void     (*on_sender_timeout) (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 118   void     (*on_npt_stop)       (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 119
 120   GstElement* (*request_rtp_encoder)  (GstRtpBin *rtpbin, guint session);
 121   GstElement* (*request_rtp_decoder)  (GstRtpBin *rtpbin, guint session);
 122   GstElement* (*request_rtcp_encoder) (GstRtpBin *rtpbin, guint session);
 123   GstElement* (*request_rtcp_decoder) (GstRtpBin *rtpbin, guint session);
 124
 125   GstElement* (*request_aux_sender)   (GstRtpBin *rtpbin, guint session);
 126   GstElement* (*request_aux_receiver) (GstRtpBin *rtpbin, guint session);
 127
 128   void     (*on_new_sender_ssrc)      (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 129   void     (*on_sender_ssrc_active)   (GstRtpBin *rtpbin, guint session, guint32 ssrc);
 130 };
 131
 132 GType gst_rtp_bin_get_type (void);
 133
 134 #endif /* __GST_RTP_BIN_H__ */