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