• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* GStreamer
2  * Copyright (C) 2017 Matthew Waters <matthew@centricular.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_WEBRTC_ICE_H__
21 #define __GST_WEBRTC_ICE_H__
22 
23 #include <gst/gst.h>
24 #include <gst/sdp/sdp.h>
25 #include <gst/webrtc/webrtc.h>
26 #include "fwd.h"
27 
28 G_BEGIN_DECLS
29 
30 #define GST_WEBRTC_ICE_ERROR gst_webrtc_ice_error_quark ()
31 GQuark gst_webrtc_ice_error_quark (void);
32 
33 GType gst_webrtc_ice_get_type(void);
34 #define GST_TYPE_WEBRTC_ICE            (gst_webrtc_ice_get_type())
35 #define GST_WEBRTC_ICE(obj)            (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_WEBRTC_ICE,GstWebRTCICE))
36 #define GST_IS_WEBRTC_ICE(obj)         (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_WEBRTC_ICE))
37 #define GST_WEBRTC_ICE_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST((klass) ,GST_TYPE_WEBRTC_ICE,GstWebRTCICEClass))
38 #define GST_IS_WEBRTC_ICE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass) ,GST_TYPE_WEBRTC_ICE))
39 #define GST_WEBRTC_ICE_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj) ,GST_TYPE_WEBRTC_ICE,GstWebRTCICEClass))
40 
41 struct _GstWebRTCICE
42 {
43   GstObject                         parent;
44 
45   GstWebRTCICEGatheringState        ice_gathering_state;
46   GstWebRTCICEConnectionState       ice_connection_state;
47 
48   GstUri                           *stun_server;
49   GstUri                           *turn_server;
50 
51   GHashTable                       *turn_servers;
52 
53   GstWebRTCICEPrivate              *priv;
54 
55   guint                             min_rtp_port;
56   guint                             max_rtp_port;
57 };
58 
59 struct _GstWebRTCICEClass
60 {
61   GstObjectClass            parent_class;
62 };
63 
64 GstWebRTCICE *              gst_webrtc_ice_new                      (const gchar * name);
65 GstWebRTCICEStream *        gst_webrtc_ice_add_stream               (GstWebRTCICE * ice,
66                                                                      guint session_id);
67 GstWebRTCICETransport *     gst_webrtc_ice_find_transport           (GstWebRTCICE * ice,
68                                                                      GstWebRTCICEStream * stream,
69                                                                      GstWebRTCICEComponent component);
70 
71 gboolean                    gst_webrtc_ice_gather_candidates        (GstWebRTCICE * ice,
72                                                                      GstWebRTCICEStream * stream);
73 /* FIXME: GstStructure-ize the candidate */
74 void                        gst_webrtc_ice_add_candidate            (GstWebRTCICE * ice,
75                                                                      GstWebRTCICEStream * stream,
76                                                                      const gchar * candidate);
77 gboolean                    gst_webrtc_ice_set_local_credentials    (GstWebRTCICE * ice,
78                                                                      GstWebRTCICEStream * stream,
79                                                                      gchar * ufrag,
80                                                                      gchar * pwd);
81 gboolean                    gst_webrtc_ice_set_remote_credentials   (GstWebRTCICE * ice,
82                                                                      GstWebRTCICEStream * stream,
83                                                                      gchar * ufrag,
84                                                                      gchar * pwd);
85 gboolean                    gst_webrtc_ice_add_turn_server          (GstWebRTCICE * ice,
86                                                                      const gchar * uri);
87 
88 void                        gst_webrtc_ice_set_is_controller        (GstWebRTCICE * ice,
89                                                                      gboolean controller);
90 gboolean                    gst_webrtc_ice_get_is_controller        (GstWebRTCICE * ice);
91 void                        gst_webrtc_ice_set_force_relay          (GstWebRTCICE * ice,
92                                                                      gboolean force_relay);
93 void                        gst_webrtc_ice_set_stun_server          (GstWebRTCICE * ice,
94                                                                      const gchar * uri);
95 gchar *                     gst_webrtc_ice_get_stun_server          (GstWebRTCICE * ice);
96 void                        gst_webrtc_ice_set_turn_server          (GstWebRTCICE * ice,
97                                                                      const gchar * uri);
98 gchar *                     gst_webrtc_ice_get_turn_server          (GstWebRTCICE * ice);
99 
100 typedef void (*GstWebRTCIceOnCandidateFunc) (GstWebRTCICE * ice, guint stream_id, gchar * candidate, gpointer user_data);
101 
102 void                        gst_webrtc_ice_set_on_ice_candidate     (GstWebRTCICE * ice,
103                                                                      GstWebRTCIceOnCandidateFunc func,
104                                                                      gpointer user_data,
105                                                                      GDestroyNotify notify);
106 
107 void                        gst_webrtc_ice_set_tos                  (GstWebRTCICE * ice,
108                                                                      GstWebRTCICEStream * stream,
109                                                                      guint tos);
110 G_END_DECLS
111 
112 #endif /* __GST_WEBRTC_ICE_H__ */
113