Fork me on GitHub
ice.h
Go to the documentation of this file.
1 
17 #ifndef JANUS_ICE_H
18 #define JANUS_ICE_H
19 
20 #include <glib.h>
21 #include <agent.h>
22 
23 #include "sdp.h"
24 #include "dtls.h"
25 #include "sctp.h"
26 #include "rtcp.h"
27 #include "text2pcap.h"
28 #include "utils.h"
29 #include "ip-utils.h"
30 #include "refcount.h"
31 #include "plugins/plugin.h"
32 
33 
41 void janus_ice_init(gboolean ice_lite, gboolean ice_tcp, gboolean full_trickle, gboolean ipv6, uint16_t rtp_min_port, uint16_t rtp_max_port);
43 void janus_ice_deinit(void);
51 int janus_ice_test_stun_server(janus_network_address *addr, uint16_t port, uint16_t local_port, janus_network_address *public_addr, uint16_t *public_port);
56 int janus_ice_set_stun_server(gchar *stun_server, uint16_t stun_port);
64 int janus_ice_set_turn_server(gchar *turn_server, uint16_t turn_port, gchar *turn_type, gchar *turn_user, gchar *turn_pwd);
72 int janus_ice_set_turn_rest_api(gchar *api_server, gchar *api_key, gchar *api_method);
75 char *janus_ice_get_stun_server(void);
78 uint16_t janus_ice_get_stun_port(void);
81 char *janus_ice_get_turn_server(void);
84 uint16_t janus_ice_get_turn_port(void);
87 char *janus_ice_get_turn_rest_api(void);
89 void janus_ice_enable_nat_1_1(void);
96 void janus_ice_enforce_interface(const char *ip);
100 gboolean janus_ice_is_enforced(const char *ip);
108 void janus_ice_ignore_interface(const char *ip);
112 gboolean janus_ice_is_ignored(const char *ip);
115 gboolean janus_ice_is_ice_lite_enabled(void);
118 gboolean janus_ice_is_ice_tcp_enabled(void);
121 gboolean janus_ice_is_full_trickle_enabled(void);
124 gboolean janus_ice_is_ipv6_enabled(void);
127 void janus_set_max_nack_queue(uint mnq);
130 uint janus_get_max_nack_queue(void);
133 void janus_set_no_media_timer(uint timer);
136 uint janus_get_no_media_timer(void);
139 void janus_set_slowlink_threshold(uint packets);
145 void janus_set_twcc_period(uint period);
148 uint janus_get_twcc_period(void);
151 void janus_set_rfc4588_enabled(gboolean enabled);
154 gboolean janus_is_rfc4588_enabled(void);
157 void janus_ice_set_event_stats_period(int period);
165 void janus_ice_debugging_enable(void);
167 void janus_ice_debugging_disable(void);
172 gboolean janus_is_opaqueid_in_api_enabled(void);
173 
174 
178 const gchar *janus_get_ice_state_name(gint state);
179 
180 
189 
190 #define JANUS_ICE_HANDLE_WEBRTC_PROCESSING_OFFER (1 << 0)
191 #define JANUS_ICE_HANDLE_WEBRTC_START (1 << 1)
192 #define JANUS_ICE_HANDLE_WEBRTC_READY (1 << 2)
193 #define JANUS_ICE_HANDLE_WEBRTC_STOP (1 << 3)
194 #define JANUS_ICE_HANDLE_WEBRTC_ALERT (1 << 4)
195 #define JANUS_ICE_HANDLE_WEBRTC_NEGOTIATED (1 << 5)
196 #define JANUS_ICE_HANDLE_WEBRTC_TRICKLE (1 << 7)
197 #define JANUS_ICE_HANDLE_WEBRTC_ALL_TRICKLES (1 << 8)
198 #define JANUS_ICE_HANDLE_WEBRTC_TRICKLE_SYNCED (1 << 9)
199 #define JANUS_ICE_HANDLE_WEBRTC_DATA_CHANNELS (1 << 10)
200 #define JANUS_ICE_HANDLE_WEBRTC_CLEANING (1 << 11)
201 #define JANUS_ICE_HANDLE_WEBRTC_HAS_AUDIO (1 << 12)
202 #define JANUS_ICE_HANDLE_WEBRTC_HAS_VIDEO (1 << 13)
203 #define JANUS_ICE_HANDLE_WEBRTC_GOT_OFFER (1 << 14)
204 #define JANUS_ICE_HANDLE_WEBRTC_GOT_ANSWER (1 << 15)
205 #define JANUS_ICE_HANDLE_WEBRTC_HAS_AGENT (1 << 16)
206 #define JANUS_ICE_HANDLE_WEBRTC_ICE_RESTART (1 << 17)
207 #define JANUS_ICE_HANDLE_WEBRTC_RESEND_TRICKLES (1 << 18)
208 #define JANUS_ICE_HANDLE_WEBRTC_RFC4588_RTX (1 << 19)
209 #define JANUS_ICE_HANDLE_WEBRTC_NEW_DATACHAN_SDP (1 << 20)
210 
211 
214 typedef struct janus_ice_stats_info {
216  guint32 packets;
218  guint64 bytes;
222  gint64 updated;
226  guint32 nacks;
228 
231 typedef struct janus_ice_stats {
243 
247 void janus_ice_notify_hangup(janus_ice_handle *handle, const char *reason);
248 
249 
253 gboolean janus_plugin_session_is_alive(janus_plugin_session *plugin_session);
254 
255 
257 typedef struct janus_seq_info {
258  gint64 ts;
259  guint16 seq;
260  guint16 state;
265 enum {
270 };
271 
272 
276  void *session;
278  guint64 handle_id;
280  char *opaque_id;
282  gint64 created;
284  void *app;
290  gint cdone;
292  GMainContext *mainctx;
294  GMainLoop *mainloop;
296  GThread *thread;
298  GSource *rtp_source, *rtcp_source, *stats_source, *twcc_source;
300  NiceAgent *agent;
304  gboolean controlling;
306  gchar *audio_mid;
308  gchar *video_mid;
310  gchar *data_mid;
312  gchar *stream_mid;
314  guint stream_id;
318  gchar *rtp_profile;
320  gchar *local_sdp;
322  gchar *remote_sdp;
324  const gchar *hangup_reason;
328  GAsyncQueue *queued_packets;
332  gint last_srtp_error, last_srtp_summary;
336  volatile gint dump_packets;
342  volatile gint closepc;
344  volatile gint destroyed;
347 };
348 
354  guint stream_id;
356  gint cdone:1;
358  guint32 audio_ssrc;
360  guint32 video_ssrc;
362  guint32 video_ssrc_rtx;
364  guint32 audio_ssrc_peer, audio_ssrc_peer_new, audio_ssrc_peer_orig;
366  guint32 video_ssrc_peer[3], video_ssrc_peer_new[3], video_ssrc_peer_orig[3], video_ssrc_peer_temp;
368  guint32 video_ssrc_peer_rtx[3], video_ssrc_peer_rtx_new[3], video_ssrc_peer_rtx_orig[3];
370  char *rid[3];
372  gboolean legacy_rid;
380  GHashTable *rtx_payload_types;
382  GHashTable *clock_rates;
384  gint audio_payload_type, video_payload_type, video_rtx_payload_type;
386  char *audio_codec, *video_codec;
388  gboolean (* video_is_keyframe)(const char* buffer, int len);
390  gboolean audio_send, audio_recv, video_send, video_recv;
394  janus_rtcp_context *video_rtcp_ctx[3];
396  GHashTable *rtx_nacked[3];
402  gint64 video_first_ntp_ts[3];
404  guint32 video_first_rtp_ts[3];
406  guint32 audio_last_ts;
408  guint32 video_last_ts;
412  gint rid_ext_id, ridrtx_ext_id;
436  gchar *ruser;
438  gchar *rpass;
440  GHashTable *components;
444  gboolean noerrorlog;
448  volatile gint destroyed;
451 };
452 
453 #define LAST_SEQS_MAX_LEN 160
454 
459  guint stream_id;
463  guint state;
467  GSList *candidates;
475  gboolean process_started;
477  GSource *icestate_source;
481  GSource *dtlsrt_source;
485  gboolean do_audio_nacks;
487  gboolean do_video_nacks;
489  GQueue *audio_retransmit_buffer, *video_retransmit_buffer;
491  GHashTable *audio_retransmit_seqs, *video_retransmit_seqs;
493  guint16 rtx_seq_number;
505  janus_seq_info *last_seqs_video[3];
511  gboolean noerrorlog;
515  volatile gint destroyed;
518 };
519 
525  gint64 received;
527  char *transaction;
530 };
531 
534 
539 janus_ice_trickle *janus_ice_trickle_new(const char *transaction, json_t *candidate);
545 gint janus_ice_trickle_parse(janus_ice_handle *handle, json_t *candidate, const char **error);
550 
551 
554 
559 janus_ice_handle *janus_ice_handle_create(void *core_session, const char *opaque_id);
566 gint janus_ice_handle_attach_plugin(void *core_session, janus_ice_handle *handle, janus_plugin *plugin);
571 gint janus_ice_handle_destroy(void *core_session, janus_ice_handle *handle);
575 void janus_ice_webrtc_hangup(janus_ice_handle *handle, const char *reason);
583 
584 
587 
593 void janus_ice_relay_rtp(janus_ice_handle *handle, int video, char *buf, int len);
599 void janus_ice_relay_rtcp(janus_ice_handle *handle, int video, char *buf, int len);
605 void janus_ice_relay_data(janus_ice_handle *handle, char *label, char *buf, int len);
611 void janus_ice_incoming_data(janus_ice_handle *handle, char *label, char *buffer, int length);
616 void janus_ice_relay_sctp(janus_ice_handle *handle, char *buffer, int length);
618 
619 
622 
631 int janus_ice_setup_local(janus_ice_handle *handle, int offer, int audio, int video, int data, int trickle);
637 void janus_ice_candidates_to_sdp(janus_ice_handle *handle, janus_sdp_mline *mline, guint stream_id, guint component_id);
642 void janus_ice_setup_remote_candidates(janus_ice_handle *handle, guint stream_id, guint component_id);
650 void janus_ice_restart(janus_ice_handle *handle);
655 
656 
661 void janus_ice_set_static_event_loops(int loops);
668 
669 #endif
guint srtp_errors_count
Count of the recent SRTP replay errors, in order to avoid spamming the logs.
Definition: ice.h:330
void janus_ice_notify_hangup(janus_ice_handle *handle, const char *reason)
Quick helper method to notify a WebRTC hangup through the Janus API.
Definition: ice.c:676
janus_ice_stats in_stats
Stats for incoming data (audio/video/data)
Definition: ice.h:507
GHashTable * clock_rates
Mapping of payload types to their clock rates, as advertised in the SDP.
Definition: ice.h:382
gboolean noerrorlog
Helper flag to avoid flooding the console with the same error all over again.
Definition: ice.h:511
void janus_ice_resend_trickles(janus_ice_handle *handle)
Method to resend all the existing candidates via trickle (e.g., after an ICE restart) ...
Definition: ice.c:3452
const gchar * hangup_reason
Reason this handle has been hung up.
Definition: ice.h:324
guint sl_lost_count_video
Last known count of lost video packets (for slow_link)
Definition: ice.h:241
guint state
libnice ICE component state
Definition: ice.h:463
janus_ice_handle * janus_ice_handle_create(void *core_session, const char *opaque_id)
Method to create a new Janus ICE handle.
Definition: ice.c:1135
gboolean video_send
Definition: ice.h:390
GHashTable * rtx_payload_types
Mapping of rtx payload types to actual media-related packet types.
Definition: ice.h:380
json_t * candidate
JSON object of the trickle candidate(s)
Definition: ice.h:529
int janus_ice_set_turn_rest_api(gchar *api_server, gchar *api_key, gchar *api_method)
Method to force Janus to contact a TURN REST API server to get a TURN service to use when gathering c...
Definition: ice.c:1080
gint64 retransmit_log_ts
Last time a log message about sending retransmits was printed.
Definition: ice.h:495
gchar * audio_mid
Audio mid (media ID)
Definition: ice.h:306
janus_flags webrtc_flags
Mask of WebRTC-related flags for this handle.
Definition: ice.h:288
guint32 audio_ssrc
Audio SSRC of the server for this stream.
Definition: ice.h:358
IP address related utility functions (headers)
gboolean janus_ice_is_full_trickle_enabled(void)
Method to check whether full-trickle support is enabled or not.
Definition: ice.c:88
SCTP processing for data channels (headers)
guint32 packets
Packets sent or received.
Definition: ice.h:216
gchar * local_sdp
SDP generated locally (just for debugging purposes)
Definition: ice.h:320
void janus_set_slowlink_threshold(uint packets)
Method to modify the slowlink-threshold property (i.e., the number of lost packets per seconds that s...
Definition: ice.c:414
guint32 audio_ssrc_peer_orig
Definition: ice.h:364
Reference counter mechanism.
struct janus_seq_info * prev
Definition: ice.h:262
gsize janus_flags
Janus flags container.
Definition: utils.h:106
struct json_t json_t
Definition: plugin.h:225
guint nack_sent_recent_cnt
Number of NACKs sent since last log message.
Definition: ice.h:501
guint component_id
libnice ICE component ID
Definition: ice.h:461
void janus_seq_list_free(janus_seq_info **head)
Definition: ice.c:553
janus_ice_stream * stream
Janus ICE stream this component belongs to.
Definition: ice.h:457
gint64 audio_first_ntp_ts
First received audio NTP timestamp.
Definition: ice.h:398
Janus media statistics container.
Definition: ice.h:231
void janus_ice_component_destroy(janus_ice_component *component)
Method to only free resources related to a specific ICE component allocated by a Janus ICE handle...
Definition: ice.c:1507
guint32 video_ssrc_peer_temp
Definition: ice.h:366
uint16_t janus_ice_get_stun_port(void)
Method to get the STUN server port.
Definition: ice.c:45
gboolean janus_ice_is_ice_lite_enabled(void)
Method to check whether ICE Lite mode is enabled or not (still WIP)
Definition: ice.c:76
janus_mutex mutex
Mutex to lock/unlock this component.
Definition: ice.h:513
gchar * stream_mid
Main mid (will be a pointer to one of the above)
Definition: ice.h:312
int janus_ice_set_stun_server(gchar *stun_server, uint16_t stun_port)
Method to force Janus to use a STUN server when gathering candidates.
Definition: ice.c:984
struct janus_seq_info janus_seq_info
A helper struct for determining when to send NACKs.
janus_refcount ref
Reference counter for this instance.
Definition: ice.h:450
volatile gint closepc
Whether a close_pc was requested recently on the PeerConnection.
Definition: ice.h:342
janus_mutex mutex
Mutex to lock/unlock this stream.
Definition: ice.h:446
NiceAgent * agent
libnice ICE agent
Definition: ice.h:300
gint64 nack_sent_log_ts
Last time a log message about sending NACKs was printed.
Definition: ice.h:499
void janus_set_max_nack_queue(uint mnq)
Method to modify the max NACK value (i.e., the number of packets per handle to store for retransmissi...
Definition: ice.c:477
struct janus_ice_stats janus_ice_stats
Janus media statistics container.
char * janus_ice_get_turn_rest_api(void)
Method to get the specified TURN REST API backend, if any.
Definition: ice.c:65
Definition: ice.h:267
gboolean process_started
Whether the setup of remote candidates for this component has started or not.
Definition: ice.h:475
janus_refcount ref
Reference counter for this instance.
Definition: ice.h:517
GMutex janus_mutex
Janus mutex implementation.
Definition: mutex.h:61
SDP m-line representation.
Definition: sdp-utils.h:128
Plugin-Core communication (implementation)
Janus ICE stream.
Definition: ice.h:350
gint janus_ice_handle_attach_plugin(void *core_session, janus_ice_handle *handle, janus_plugin *plugin)
Method to attach a Janus ICE handle to a plugin.
Definition: ice.c:1167
void janus_ice_webrtc_hangup(janus_ice_handle *handle, const char *reason)
Method to only hangup (e.g., DTLS alert) the WebRTC PeerConnection allocated by a Janus ICE handle...
Definition: ice.c:1337
void janus_ice_set_event_stats_period(int period)
Method to modify the event handler statistics period (i.e., the number of seconds that should pass be...
Definition: ice.c:282
ogg_stream_state * stream
Definition: pp-opus.c:32
Janus ICE component.
Definition: ice.h:455
void janus_ice_incoming_data(janus_ice_handle *handle, char *label, char *buffer, int length)
Plugin SCTP/DataChannel callback, called by the SCTP stack when when there&#39;s data for a plugin...
Definition: ice.c:2886
void janus_enable_opaqueid_in_api(void)
Method to enable opaque ID in Janus API responses/events.
Definition: ice.c:102
void janus_ice_restart(janus_ice_handle *handle)
Method to restart ICE and the connectivity checks.
Definition: ice.c:3442
uint janus_get_no_media_timer(void)
Method to get the current no-media event timer (see above)
Definition: ice.c:406
gboolean janus_plugin_session_is_alive(janus_plugin_session *plugin_session)
Quick helper method to check if a plugin session associated with a Janus handle is still valid...
Definition: ice.c:581
void janus_ice_relay_rtp(janus_ice_handle *handle, int video, char *buf, int len)
Core RTP callback, called when a plugin has an RTP packet to send to a peer.
Definition: ice.c:4321
GSList * candidates
GLib list of libnice remote candidates for this component.
Definition: ice.h:467
gboolean janus_ice_is_ignored(const char *ip)
Method to check whether an interface/IP is currently in the ignore list for ICE (that is...
Definition: ice.c:262
gboolean janus_ice_is_ipv6_enabled(void)
Method to check whether IPv6 candidates are enabled/supported or not (still WIP)
Definition: ice.c:94
gint last_event_stats
Count of how many seconds passed since the last stats passed to event handlers.
Definition: ice.h:334
Instance of a text2pcap recorder.
Definition: text2pcap.h:49
guint16 seq
Definition: ice.h:259
janus_ice_handle * handle
Janus ICE handle this trickle candidate belongs to.
Definition: ice.h:523
gchar * remote_fingerprint
Hashed fingerprint of the peer&#39;s certificate, as parsed in SDP.
Definition: ice.h:434
void janus_set_rfc4588_enabled(gboolean enabled)
Method to enable or disable the RFC4588 support negotiation.
Definition: ice.c:444
GThread * thread
GLib thread for the handle and libnice.
Definition: ice.h:296
void janus_ice_init(gboolean ice_lite, gboolean ice_tcp, gboolean full_trickle, gboolean ipv6, uint16_t rtp_min_port, uint16_t rtp_max_port)
ICE stuff initialization.
Definition: ice.c:793
Definition: refcount.h:78
GSList * remote_candidates
GLib list of remote candidates for this component (summary)
Definition: ice.h:471
GHashTable * components
GLib hash table of components (IDs are the keys)
Definition: ice.h:440
gint mid_ext_id
SDES mid RTP extension ID.
Definition: ice.h:410
gint cdone
Number of gathered candidates.
Definition: ice.h:290
gchar * video_mid
Video mid (media ID)
Definition: ice.h:308
gchar * rtp_profile
RTP profile set by caller (so that we can match it)
Definition: ice.h:318
TURN REST API client.
char * transaction
Janus API transaction ID of the original trickle request.
Definition: ice.h:527
void janus_ice_stream_destroy(janus_ice_stream *stream)
Method to only free resources related to a specific ICE stream allocated by a Janus ICE handle...
Definition: ice.c:1427
Helper to handle pending trickle candidates (e.g., when we&#39;re still waiting for an offer) ...
Definition: ice.h:521
struct janus_seq_info * next
Definition: ice.h:261
guint stream_id
libnice ICE stream ID
Definition: ice.h:459
gboolean janus_ice_is_ice_tcp_enabled(void)
Method to check whether ICE-TCP support is enabled/supported or not (still WIP)
Definition: ice.c:82
gint64 created
Monotonic time of when the handle has been created.
Definition: ice.h:282
const gchar * janus_get_ice_state_name(gint state)
Helper method to get a string representation of a libnice ICE state.
Definition: ice.c:1107
void janus_ice_ignore_interface(const char *ip)
Method to add an interface/IP to the ignore list for ICE (that is, don&#39;t gather candidates) ...
Definition: ice.c:251
void janus_ice_relay_sctp(janus_ice_handle *handle, char *buffer, int length)
Core SCTP/DataChannel callback, called by the SCTP stack when when there&#39;s data to send...
Definition: ice.c:4430
gboolean do_transport_wide_cc
Whether we do transport wide cc for video.
Definition: ice.h:416
volatile gint destroyed
Atomic flag to check if this instance has been destroyed.
Definition: ice.h:344
GSList * transport_wide_received_seq_nums
GLib list of transport wide cc stats in reverse received order.
Definition: ice.h:428
gint framemarking_ext_id
Frame marking extension ID.
Definition: ice.h:414
void janus_ice_setup_remote_candidates(janus_ice_handle *handle, guint stream_id, guint component_id)
Method to handle remote candidates and start the connectivity checks.
Definition: ice.c:3092
void janus_ice_relay_data(janus_ice_handle *handle, char *label, char *buf, int len)
Core SCTP/DataChannel callback, called when a plugin has data to send to a peer.
GMainLoop * mainloop
GLib loop for the handle and libnice.
Definition: ice.h:294
GSource * dtlsrt_source
Re-transmission timer for DTLS.
Definition: ice.h:481
The plugin session and callbacks interface.
Definition: plugin.h:241
janus_refcount ref
Reference counter for this instance.
Definition: ice.h:346
GSource * twcc_source
Definition: ice.h:298
uint janus_get_max_nack_queue(void)
Method to get the current max NACK value (i.e., the number of packets per handle to store for retrans...
Definition: ice.c:484
janus_plugin_session * app_handle
Opaque core/plugin session pointer.
Definition: ice.h:286
uint janus_get_slowlink_threshold(void)
Method to get the current slowlink-threshold value (see above)
Definition: ice.c:421
guint retransmit_recent_cnt
Number of retransmitted packets since last log message.
Definition: ice.h:497
RTP context, in order to make sure SSRC changes result in coherent seq/ts increases.
Definition: rtp.h:223
volatile gint destroyed
Atomic flag to check if this instance has been destroyed.
Definition: ice.h:515
janus_ice_handle * handle
Janus ICE handle this stream belongs to.
Definition: ice.h:352
Definition: ice.h:266
janus_ice_stats out_stats
Stats for outgoing data (audio/video/data)
Definition: ice.h:509
void janus_ice_debugging_disable(void)
Method to disable libnice debugging (the default)
Definition: ice.c:209
RTCP processing (headers)
gint64 updated
Time we last updated the last second counter.
Definition: ice.h:222
uint16_t janus_ice_get_turn_port(void)
Method to get the TURN server port.
Definition: ice.c:59
GSList * local_candidates
GLib list of local candidates for this component (summary)
Definition: ice.h:469
GMainContext * mainctx
GLib context for the handle and libnice.
Definition: ice.h:292
void janus_ice_candidates_to_sdp(janus_ice_handle *handle, janus_sdp_mline *mline, guint stream_id, guint component_id)
Method to add local candidates to a janus_sdp SDP object representation.
Definition: ice.c:3055
uint janus_get_twcc_period(void)
Method to get the current TWCC period (see above)
Definition: ice.c:437
GQueue * video_retransmit_buffer
Definition: ice.h:489
guint stream_id
ICE Stream ID.
Definition: ice.h:314
gint64 ts
Definition: ice.h:258
gint ridrtx_ext_id
Definition: ice.h:412
void janus_ice_enable_nat_1_1(void)
Helper method to force Janus to overwrite all host candidates with the public IP. ...
Definition: ice.c:218
void janus_ice_deinit(void)
ICE stuff de-initialization.
Definition: ice.c:844
gboolean janus_is_opaqueid_in_api_enabled(void)
Method to check whether opaque ID have to be added to Janus API responses/events. ...
Definition: ice.c:105
janus_ice_stats_info audio
Audio info.
Definition: ice.h:233
gchar * remote_hashing
Hashing algorhitm used by the peer for the DTLS certificate (e.g., "SHA-256")
Definition: ice.h:432
gchar * ruser
The ICE username for this stream.
Definition: ice.h:436
gboolean janus_is_rfc4588_enabled(void)
Method to check whether the RFC4588 support is enabled.
Definition: ice.c:448
gchar * remote_sdp
SDP received by the peer (just for debugging purposes)
Definition: ice.h:322
A helper struct for determining when to send NACKs.
Definition: ice.h:257
char * janus_ice_get_stun_server(void)
Method to get the STUN server IP address.
Definition: ice.c:42
int janus_ice_test_stun_server(janus_network_address *addr, uint16_t port, uint16_t local_port, janus_network_address *public_addr, uint16_t *public_port)
Method to check whether a STUN server is reachable.
Definition: ice.c:850
void * app
Opaque application (plugin) pointer.
Definition: ice.h:284
int janus_ice_get_event_stats_period(void)
Method to get the current event handler statistics period (see above)
Definition: ice.c:285
DTLS/SRTP processing (headers)
void janus_ice_relay_rtcp(janus_ice_handle *handle, int video, char *buf, int len)
Core RTCP callback, called when a plugin has an RTCP message to send to a peer.
Definition: ice.c:4385
gboolean janus_ice_is_ice_debugging_enabled(void)
Method to check whether libnice debugging has been enabled (http://nice.freedesktop.org/libnice/libnice-Debug-messages.html)
Definition: ice.c:191
guint32 transport_wide_cc_last_seq_num
Last received transport wide seq num.
Definition: ice.h:420
janus_ice_stream * stream
ICE stream.
Definition: ice.h:316
void janus_ice_trickle_destroy(janus_ice_trickle *trickle)
Helper method to destroy a janus_ice_trickle instance.
Definition: ice.c:780
gint cdone
Whether this stream is ready to be used.
Definition: ice.h:356
gboolean notified_lastsec
Whether or not we notified about lastsec issues already.
Definition: ice.h:224
gint video_rtx_payload_type
Definition: ice.h:384
gint last_srtp_summary
Definition: ice.h:332
Definition: ice.h:269
gint transport_wide_cc_ext_id
Transport wide cc rtp ext ID.
Definition: ice.h:418
guint32 audio_first_rtp_ts
First received audio RTP timestamp.
Definition: ice.h:400
Janus ICE handle.
Definition: ice.h:274
guint32 video_ssrc
Video SSRC of the server for this stream.
Definition: ice.h:360
void janus_ice_set_static_event_loops(int loops)
Method to configure the static event loops mechanism at startup.
Definition: ice.c:138
char * opaque_id
Opaque identifier, e.g., to provide inter-handle relationships to external tools. ...
Definition: ice.h:280
int janus_ice_set_turn_server(gchar *turn_server, uint16_t turn_port, gchar *turn_type, gchar *turn_user, gchar *turn_pwd)
Method to force Janus to use a TURN server when gathering candidates.
Definition: ice.c:1030
struct janus_ice_stats_info janus_ice_stats_info
Janus media statistics.
GList * video_payload_types
List of payload types we can expect for video.
Definition: ice.h:378
gboolean controlling
ICE role (controlling or controlled)
Definition: ice.h:304
GHashTable * video_retransmit_seqs
Definition: ice.h:491
guint32 audio_last_ts
Last sent audio RTP timestamp.
Definition: ice.h:406
Janus media statistics.
Definition: ice.h:214
gboolean do_audio_nacks
Whether we should do NACKs (in or out) for audio.
Definition: ice.h:485
void * session
Opaque pointer to the core/peer session.
Definition: ice.h:276
guint32 video_last_ts
Last sent video RTP timestamp.
Definition: ice.h:408
guint32 nacks
Number of NACKs sent or received.
Definition: ice.h:226
gchar * rpass
The ICE password for this stream.
Definition: ice.h:438
janus_text2pcap * text2pcap
In case this session must be saved to text2pcap, the instance to dump packets to. ...
Definition: ice.h:338
gint64 component_connected
Monotonic time of when this component has successfully connected.
Definition: ice.h:465
int janus_ice_setup_local(janus_ice_handle *handle, int offer, int audio, int video, int data, int trickle)
Method to locally set up the ICE candidates (initialization and gathering)
Definition: ice.c:3149
Janus DTLS-SRTP handle.
Definition: dtls.h:60
janus_mutex mutex
Mutex to lock/unlock the ICE session.
Definition: ice.h:340
volatile gint destroyed
Atomic flag to check if this instance has been destroyed.
Definition: ice.h:448
janus_rtcp_context * audio_rtcp_ctx
RTCP context for the audio stream.
Definition: ice.h:392
volatile gint dump_packets
Flag to decide whether or not packets need to be dumped to a text2pcap file.
Definition: ice.h:336
guint64 bytes
Bytes sent or received.
Definition: ice.h:218
gint janus_ice_trickle_parse(janus_ice_handle *handle, json_t *candidate, const char **error)
Helper method to parse trickle candidates.
Definition: ice.c:718
GList * audio_payload_types
List of payload types we can expect for audio.
Definition: ice.h:376
Internal RTCP state context (for RR/SR)
Definition: rtcp.h:226
Structure to hold network addresses in a tagged union which should be IPv4 and IPv6 compatible...
Definition: ip-utils.h:53
guint32 bytes_lastsec
Bytes sent or received in the last second.
Definition: ice.h:220
gchar * data_mid
Data channel mid (media ID)
Definition: ice.h:310
guint64 handle_id
Handle identifier, guaranteed to be non-zero.
Definition: ice.h:278
Plugin-Gateway session mapping.
Definition: plugin.h:228
gint64 agent_created
Monotonic time of when the ICE agent has been created.
Definition: ice.h:302
gboolean legacy_rid
Whether we should use the legacy simulcast syntax (a=simulcast:recv rid=..) or the proper one (a=simu...
Definition: ice.h:372
guint transport_wide_cc_feedback_count
Transport wide cc rtp ext ID.
Definition: ice.h:426
GAsyncQueue * queued_packets
Queue of events in the loop and outgoing packets to send.
Definition: ice.h:328
guint32 transport_wide_cc_last_feedback_seq_num
Last transport wide seq num sent on feedback.
Definition: ice.h:422
janus_dtls_srtp * dtls
DTLS-SRTP stack.
Definition: ice.h:483
janus_seq_info * last_seqs_audio
List of recently received audio sequence numbers (as a support to NACK generation) ...
Definition: ice.h:503
GList * pending_trickles
List of pending trickle candidates (those we received before getting the JSEP offer) ...
Definition: ice.h:326
int janus_ice_get_static_event_loops(void)
Method to return the number of static event loops, if enabled.
Definition: ice.c:135
void janus_ice_enforce_interface(const char *ip)
Method to add an interface/IP to the enforce list for ICE (that is, only gather candidates from these...
Definition: ice.c:226
gint64 received
Monotonic time of when this trickle candidate has been received.
Definition: ice.h:525
gboolean do_video_nacks
Whether we should do NACKs (in or out) for video.
Definition: ice.h:487
janus_ice_component * component
ICE component.
Definition: ice.h:442
void janus_set_twcc_period(uint period)
Method to modify the TWCC feedback period (i.e., how often TWCC feedback is sent back to media sender...
Definition: ice.c:428
gint64 icefailed_detected
Time of when we first detected an ICE failed (we&#39;ll need this for the timer above) ...
Definition: ice.h:479
void janus_ice_debugging_enable(void)
Method to enable libnice debugging (http://nice.freedesktop.org/libnice/libnice-Debug-messages.html)
Definition: ice.c:194
SDP processing (headers)
guint16 rtx_seq_number
Current sequence number for the RFC4588 rtx SSRC session.
Definition: ice.h:493
gint janus_ice_handle_destroy(void *core_session, janus_ice_handle *handle)
Method to destroy a Janus ICE handle.
Definition: ice.c:1242
guint16 transport_wide_cc_cycles
Transport wide cc transport seq num wrap cycles.
Definition: ice.h:424
gboolean janus_ice_is_enforced(const char *ip)
Method to check whether an interface is currently in the enforce list for ICE (that is...
Definition: ice.c:234
guint32 video_ssrc_rtx
Video retransmission SSRC of the peer for this stream.
Definition: ice.h:362
guint16 state
Definition: ice.h:260
guint sl_lost_count_audio
Last known count of lost audio packets (for slow_link)
Definition: ice.h:239
Dumping of RTP/RTCP packets to text2pcap or pcap format (headers)
char * janus_ice_get_turn_server(void)
Method to get the TURN server IP address.
Definition: ice.c:56
guint stream_id
libnice ICE stream ID
Definition: ice.h:354
Definition: ice.h:268
void janus_set_no_media_timer(uint timer)
Method to modify the no-media event timer (i.e., the number of seconds where no media arrives before ...
Definition: ice.c:399
GSource * icestate_source
Timer to check when we should consider ICE as failed.
Definition: ice.h:477
gchar * selected_pair
String representation of the selected pair as notified by libnice (foundations)
Definition: ice.h:473
janus_ice_stats_info data
Data info.
Definition: ice.h:237
void janus_ice_stop_static_event_loops(void)
Method to stop all the static event loops, if enabled.
Definition: ice.c:172
janus_dtls_role
DTLS roles.
Definition: dtls.h:45
char * video_codec
Definition: ice.h:386
janus_ice_trickle * janus_ice_trickle_new(const char *transaction, json_t *candidate)
Helper method to allocate a janus_ice_trickle instance.
Definition: ice.c:707
janus_dtls_role dtls_role
DTLS role of the server for this stream.
Definition: ice.h:430
guint32 bytes_lastsec_temp
Definition: ice.h:220
void janus_ice_dtls_handshake_done(janus_ice_handle *handle, janus_ice_component *component)
Callback to be notified when the DTLS handshake for a specific component has been completed...
Definition: ice.c:4449
gboolean noerrorlog
Helper flag to avoid flooding the console with the same error all over again.
Definition: ice.h:444