private.h 50.5 KB
Newer Older
aymeric's avatar
aymeric committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
/***************************************************************************
 *            private.h
 *
 *  Mon Jun 13 14:23:23 2005
 *  Copyright  2005  Simon Morlat
 *  Email simon dot morlat at linphone dot org
 ****************************************************************************/

/*
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */
24

aymeric's avatar
aymeric committed
25
26
#ifndef _PRIVATE_H
#define _PRIVATE_H
Guillaume Beraudo's avatar
Guillaume Beraudo committed
27
#ifdef __cplusplus
28

Guillaume Beraudo's avatar
Guillaume Beraudo committed
29
30
extern "C" {
#endif
aymeric's avatar
aymeric committed
31
#include "linphonecore.h"
Yann Diorcet's avatar
Yann Diorcet committed
32
#include "linphonefriend.h"
jehan's avatar
jehan committed
33
#include "linphone_tunnel.h"
Simon Morlat's avatar
Simon Morlat committed
34
#include "linphonecore_utils.h"
Sylvain Berfini's avatar
Sylvain Berfini committed
35
#include "sal/sal.h"
Yann Diorcet's avatar
Yann Diorcet committed
36
#include "sipsetup.h"
37
#include "quality_reporting.h"
aymeric's avatar
aymeric committed
38

39
40
41
#include <belle-sip/object.h>
#include <belle-sip/dict.h>

aymeric's avatar
aymeric committed
42
43
44
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
45
#include "mediastreamer2/ice.h"
46
#include "mediastreamer2/mediastream.h"
Simon Morlat's avatar
Simon Morlat committed
47
#include "mediastreamer2/msconference.h"
Yann Diorcet's avatar
Yann Diorcet committed
48
#ifdef BUILD_UPNP
Yann Diorcet's avatar
Yann Diorcet committed
49
#include "upnp.h"
50
#endif //BUILD_UPNP
aymeric's avatar
aymeric committed
51

Margaux Clerc's avatar
Margaux Clerc committed
52
53
54
55
#ifdef MSG_STORAGE_ENABLED
#include "sqlite3.h"
#endif

56
#ifndef LIBLINPHONE_VERSION
aymeric's avatar
aymeric committed
57
58
59
#define LIBLINPHONE_VERSION LINPHONE_VERSION
#endif

60
#ifndef PACKAGE_SOUND_DIR
aymeric's avatar
aymeric committed
61
62
63
#define PACKAGE_SOUND_DIR "."
#endif

64
65
66
67
#ifndef PACKAGE_DATA_DIR
#define PACKAGE_DATA_DIR "."
#endif

68
#ifdef ENABLE_NLS
69
70
71
72
73
74
75
76
77
78
79
80

#ifdef _MSC_VER
// prevent libintl.h from re-defining fprintf and vfprintf
#ifndef fprintf
#define fprintf fprintf
#endif
#ifndef vfprintf
#define vfprintf vfprintf
#endif
#define _GL_STDIO_H
#endif

aymeric's avatar
aymeric committed
81
#include <libintl.h>
82
	
aymeric's avatar
aymeric committed
83
#ifndef _
Simon Morlat's avatar
Simon Morlat committed
84
#define _(String) dgettext(GETTEXT_PACKAGE,String)
aymeric's avatar
aymeric committed
85
86
#endif
#else
smorlat's avatar
smorlat committed
87
#ifndef _
aymeric's avatar
aymeric committed
88
89
#define _(something)	(something)
#endif
90
91
92
#ifndef ngettext
#define ngettext(singular, plural, number)	(((number)==1)?(singular):(plural))
#endif
smorlat's avatar
smorlat committed
93
#endif
94
95
96
#ifdef ANDROID
#include <jni.h>
#endif
97

98
99
100
101
102
103
104
105
106
107
108
109
#ifdef _WIN32
#if defined(__MINGW32__) || !defined(WINAPI_FAMILY_PARTITION) || !defined(WINAPI_PARTITION_DESKTOP)
#define LINPHONE_WINDOWS_DESKTOP 1
#elif defined(WINAPI_FAMILY_PARTITION)
#if defined(WINAPI_PARTITION_DESKTOP) && WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
#define LINPHONE_WINDOWS_DESKTOP 1
#elif defined(WINAPI_PARTITION_PHONE_APP) && WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PHONE_APP)
#define LINPHONE_WINDOWS_PHONE 1
#elif defined(WINAPI_PARTITION_APP) && WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP)
#define LINPHONE_WINDOWS_UNIVERSAL 1
#endif
#endif
François Grisez's avatar
François Grisez committed
110
#endif
jehan's avatar
jehan committed
111

112
struct _LinphoneCallParams{
113
114
	belle_sip_object_t base;
	void *user_data;
115
	LinphoneCall *referer; /*in case this call creation is consecutive to an incoming transfer, this points to the original call */
116
	int audio_bw; /* bandwidth limit for audio stream */
Simon Morlat's avatar
Simon Morlat committed
117
	LinphoneMediaEncryption media_encryption;
Simon Morlat's avatar
Simon Morlat committed
118
119
	PayloadType *audio_codec; /*audio codec currently in use */
	PayloadType *video_codec; /*video codec currently in use */
120
121
	MSVideoSize sent_vsize; /* Size of the video currently being sent */
	MSVideoSize recv_vsize; /* Size of the video currently being received */
122
	float received_fps,sent_fps;
Simon Morlat's avatar
Simon Morlat committed
123
124
125
126
	int down_bw;
	int up_bw;
	int down_ptime;
	int up_ptime;
Simon Morlat's avatar
Simon Morlat committed
127
	char *record_file;
Simon Morlat's avatar
Simon Morlat committed
128
	char *session_name;
129
	SalCustomHeader *custom_headers;
130
	bool_t has_video;
131
	bool_t avpf_enabled; /* RTCP feedback messages are enabled */
132
	bool_t real_early_media; /*send real media even during early media (for outgoing calls)*/
Simon Morlat's avatar
Simon Morlat committed
133
	bool_t in_conference; /*in conference mode */
jehan's avatar
jehan committed
134
	bool_t low_bandwidth;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
135
	bool_t no_user_consent;/*when set to TRUE an UPDATE request will be used instead of reINVITE*/
136
	uint16_t avpf_rr_interval; /*in milliseconds*/
137
	LinphonePrivacyMask privacy;
138
139
	LinphoneMediaDirection audio_dir;
	LinphoneMediaDirection video_dir;
140
141
	bool_t video_declined; /*use to keep  traces of declined video to avoid to re-offer video in case of automatic RE-INVITE*/
	bool_t internal_call_update; /*use mark that call update was requested internally (might be by ice)*/
142
143
	bool_t video_multicast_enabled;
	bool_t audio_multicast_enabled;
144
};
145

146
147
148
BELLE_SIP_DECLARE_VPTR(LinphoneCallParams);


149
150
151
struct _LinphoneQualityReporting{
	reporting_session_report_t * reports[2]; /**Store information on audio and video media streams (RFC 6035) */
	bool_t was_video_running; /*Keep video state since last check in order to detect its (de)activation*/
152
	LinphoneQualityReportingReportSendCb on_report_sent;
153
154
};

155
struct _LinphoneCallLog{
156
157
	belle_sip_object_t base;
	void *user_data;
158
159
160
161
162
163
	struct _LinphoneCore *lc;
	LinphoneCallDir dir; /**< The direction of the call*/
	LinphoneCallStatus status; /**< The status of the call*/
	LinphoneAddress *from; /**<Originator of the call as a LinphoneAddress object*/
	LinphoneAddress *to; /**<Destination of the call as a LinphoneAddress object*/
	char start_date[128]; /**<Human readable string containing the start date*/
164
	int duration; /**<Duration of the call starting in connected state in seconds*/
165
166
167
168
169
	char *refkey;
	rtp_stats_t local_stats;
	rtp_stats_t remote_stats;
	float quality;
	time_t start_date_time; /**Start date of the call in seconds as expressed in a time_t */
170
	time_t connected_date_time; /**Connecting date of the call in seconds as expressed in a time_t */
171
	char* call_id; /**unique id of a call*/
172
	struct _LinphoneQualityReporting reporting;
173
174
175
	bool_t video_enabled;
};

176
177
BELLE_SIP_DECLARE_VPTR(LinphoneCallLog);

178

179
180
typedef struct _CallCallbackObj
{
181
182
	LinphoneCallCbFunc _func;
	void * _user_data;
183
}CallCallbackObj;
184

185
186
187
struct _LinphoneChatMessageCbs {
	belle_sip_object_t base;
	void *user_data;
188
189
190
191
	LinphoneChatMessageCbsMsgStateChangedCb msg_state_changed;
	LinphoneChatMessageCbsFileTransferRecvCb file_transfer_recv; /**< Callback to store file received attached to a #LinphoneChatMessage */
	LinphoneChatMessageCbsFileTransferSendCb file_transfer_send; /**< Callback to collect file chunk to be sent for a #LinphoneChatMessage */
	LinphoneChatMessageCbsFileTransferProgressIndicationCb file_transfer_progress_indication; /**< Callback to indicate file transfer progress */
192
193
194
195
};

BELLE_SIP_DECLARE_VPTR(LinphoneChatMessageCbs);

Simon Morlat's avatar
Simon Morlat committed
196
197
198
199
200
typedef enum _LinphoneChatMessageDir{
	LinphoneChatMessageIncoming,
	LinphoneChatMessageOutgoing
} LinphoneChatMessageDir;

jehan's avatar
jehan committed
201
struct _LinphoneChatMessage {
202
	belle_sip_object_t base;
jehan's avatar
jehan committed
203
	LinphoneChatRoom* chat_room;
204
	LinphoneChatMessageCbs *callbacks;
Simon Morlat's avatar
Simon Morlat committed
205
206
	LinphoneChatMessageDir dir;
	char* message;
207
	LinphoneChatMessageStateChangedCb cb;
jehan's avatar
jehan committed
208
209
	void* cb_ud;
	void* message_userdata;
210
	char* appdata;
211
	char* external_body_url;
Simon Morlat's avatar
Simon Morlat committed
212
213
	LinphoneAddress *from;
	LinphoneAddress *to;
214
	time_t time;
215
	SalCustomHeader *custom_headers;
Margaux Clerc's avatar
Margaux Clerc committed
216
	LinphoneChatMessageState state;
Simon Morlat's avatar
Simon Morlat committed
217
	bool_t is_read;
218
	unsigned int storage_id;
219
	SalOp *op;
220
221
222
	LinphoneContent *file_transfer_information; /**< used to store file transfer information when the message is of file transfer type */
	char *content_type; /**< is used to specified the type of message to be sent, used only for file transfer message */
	belle_http_request_t *http_request; /**< keep a reference to the http_request in case of file transfer in order to be able to cancel the transfer */
223
	char *file_transfer_filepath;
jehan's avatar
jehan committed
224
};
225

226
227
BELLE_SIP_DECLARE_VPTR(LinphoneChatMessage);

228
229
230
231
232
233
typedef struct StunCandidate{
	char addr[64];
	int port;
}StunCandidate;


234
typedef struct _PortConfig{
235
	char multicast_ip[LINPHONE_IPADDR_SIZE];
236
237
238
239
	int rtp_port;
	int rtcp_port;
}PortConfig;

240
struct _LinphoneCall{
241
242
	belle_sip_object_t base;
	void *user_data;
smorlat's avatar
smorlat committed
243
	struct _LinphoneCore *core;
244
	SalErrorInfo non_op_error;
245
	int af; /*the address family to prefer for RTP path, guessed from signaling path*/
246
247
	LinphoneCallDir dir;
	SalMediaDescription *biggestdesc; /*media description with all already proposed streams, used to remember the mapping of streams*/
248
249
	SalMediaDescription *localdesc;
	SalMediaDescription *resultdesc;
Simon Morlat's avatar
Simon Morlat committed
250
251
	struct _RtpProfile *audio_profile;
	struct _RtpProfile *video_profile;
252
253
	struct _RtpProfile *rtp_io_audio_profile;
	struct _RtpProfile *rtp_io_video_profile;
smorlat's avatar
smorlat committed
254
	struct _LinphoneCallLog *log;
255
	LinphoneAddress *me; /*Either from or to based on call dir*/
256
	SalOp *op;
257
	SalOp *ping_op;
258
	char media_localip[LINPHONE_IPADDR_SIZE]; /* our best guess for local media ipaddress for this call */
259
260
	LinphoneCallState state;
	LinphoneCallState prevstate;
261
	LinphoneCallState transfer_state; /*idle if no transfer*/
262
	LinphoneProxyConfig *dest_proxy;
263
264
	PortConfig media_ports[2];
	MSMediaStreamSessions sessions[2]; /*the rtp, srtp, zrtp contexts for each stream*/
265
	StunCandidate ac,vc; /*audio video ip/port discovered by STUN*/
266
267
	struct _AudioStream *audiostream;  /**/
	struct _VideoStream *videostream;
Ghislain MARY's avatar
Ghislain MARY committed
268
	void *video_window_id;
Simon Morlat's avatar
Simon Morlat committed
269
	MSAudioEndpoint *endpoint; /*used for conferencing*/
Simon Morlat's avatar
Simon Morlat committed
270
	char *refer_to;
271
272
273
	LinphoneCallParams *params;
	LinphoneCallParams *current_params;
	LinphoneCallParams *remote_params;
Simon Morlat's avatar
Simon Morlat committed
274
	int up_bw; /*upload bandwidth setting at the time the call is started. Used to detect if it changes during a call */
Simon Morlat's avatar
Simon Morlat committed
275
	int audio_bw;	/*upload bandwidth used by audio */
276
277
278
279
280
	OrtpEvQueue *audiostream_app_evq;
	char *auth_token;
	OrtpEvQueue *videostream_app_evq;
	CallCallbackObj nextVideoFrameDecoded;
	LinphoneCallStats stats[2];
Yann Diorcet's avatar
Yann Diorcet committed
281
282
283
#ifdef BUILD_UPNP
	UpnpSession *upnp_session;
#endif //BUILD_UPNP
284
285
	IceSession *ice_session;
	int ping_time;
286
287
	unsigned int remote_session_id;
	unsigned int remote_session_ver;
288
	LinphoneCall *referer; /*when this call is the result of a transfer, referer is set to the original call that caused the transfer*/
289
	LinphoneCall *transfer_target;/*if this call received a transfer request, then transfer_target points to the new call created to the refer target */
290
	int localdesc_changed;/*not a boolean, contains a mask representing changes*/
291
	LinphonePlayer *player;
Simon Morlat's avatar
Simon Morlat committed
292
	unsigned long bg_task_id; /*used to prevent device to suspend app while a call is received in background*/
293

294
295
296
	char *dtmf_sequence; /*DTMF sequence needed to be sent using #dtmfs_timer*/
	belle_sip_source_t *dtmfs_timer; /*DTMF timer needed to send a DTMF sequence*/

297
	char *dtls_certificate_fingerprint; /**> This fingerprint is computed during stream init and is stored in call to be used when making local media description */
298
	MSWebCam *cam; /*webcam use for this call*/
299
	bool_t refer_pending;
300
	bool_t expect_media_in_ack;
301
	bool_t audio_muted;
302
	bool_t camera_enabled;
303

304
	bool_t all_muted; /*this flag is set during early medias*/
305
	bool_t playing_ringbacktone;
306
	bool_t ringing_beep; /* whether this call is ringing through an already existent current call*/
Simon Morlat's avatar
Simon Morlat committed
307
	bool_t auth_token_verified;
308

309
	bool_t defer_update;
310
	bool_t was_automatically_paused;
311
	bool_t ping_replied;
Simon Morlat's avatar
Simon Morlat committed
312
	bool_t record_active;
313

314
	bool_t paused_by_app;
315
};
smorlat's avatar
smorlat committed
316

317
318
BELLE_SIP_DECLARE_VPTR(LinphoneCall);

319

Simon Morlat's avatar
Simon Morlat committed
320
LinphoneCall * linphone_call_new_outgoing(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, const LinphoneCallParams *params, LinphoneProxyConfig *cfg);
321
LinphoneCall * linphone_call_new_incoming(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, SalOp *op);
322
void linphone_call_set_new_params(LinphoneCall *call, const LinphoneCallParams *params);
323
void linphone_call_set_state(LinphoneCall *call, LinphoneCallState cstate, const char *message);
jehan's avatar
jehan committed
324
void linphone_call_set_contact_op(LinphoneCall* call);
325
void linphone_call_set_compatible_incoming_call_parameters(LinphoneCall *call, const SalMediaDescription *md);
smorlat's avatar
smorlat committed
326
/* private: */
327
LinphoneCallLog * linphone_call_log_new(LinphoneCallDir dir, LinphoneAddress *local, LinphoneAddress * remote);
328
void linphone_call_log_completed(LinphoneCall *call);
smorlat's avatar
smorlat committed
329
void linphone_call_log_destroy(LinphoneCallLog *cl);
330
void linphone_call_set_transfer_state(LinphoneCall* call, LinphoneCallState state);
331
LinphonePlayer *linphone_call_build_player(LinphoneCall*call);
smorlat's avatar
smorlat committed
332

333
334
LinphoneCallParams * linphone_call_params_new(void);
SalMediaProto get_proto_from_call_params(const LinphoneCallParams *params);
335
336
SalStreamDir get_audio_dir_from_call_params(const LinphoneCallParams *params);
SalStreamDir get_video_dir_from_call_params(const LinphoneCallParams *params);
337

aymeric's avatar
aymeric committed
338
339
340
341
void linphone_auth_info_write_config(struct _LpConfig *config, LinphoneAuthInfo *obj, int pos);

void linphone_core_update_proxy_register(LinphoneCore *lc);
void linphone_core_refresh_subscribes(LinphoneCore *lc);
342
int linphone_core_abort_call(LinphoneCore *lc, LinphoneCall *call, const char *error);
jehan's avatar
jehan committed
343
const char *linphone_core_get_nat_address_resolved(LinphoneCore *lc);
aymeric's avatar
aymeric committed
344

345
int linphone_proxy_config_send_publish(LinphoneProxyConfig *cfg, LinphonePresenceModel *presence);
346
void linphone_proxy_config_set_state(LinphoneProxyConfig *cfg, LinphoneRegistrationState rstate, const char *message);
347
void linphone_proxy_config_stop_refreshing(LinphoneProxyConfig *obj);
348
void linphone_proxy_config_write_all_to_config_file(LinphoneCore *lc);
349
void _linphone_proxy_config_release(LinphoneProxyConfig *cfg);
jehan's avatar
jehan committed
350
351
352
353
354
/*
 * returns service route as defined in as defined by rfc3608, might be a list instead of just one.
 * Can be NULL
 * */
const LinphoneAddress* linphone_proxy_config_get_service_route(const LinphoneProxyConfig* cfg);
355

356
void linphone_friend_close_subscriptions(LinphoneFriend *lf);
357
void linphone_friend_update_subscribes(LinphoneFriend *fr, LinphoneProxyConfig *cfg, bool_t only_when_registered);
358
void linphone_friend_notify(LinphoneFriend *lf, LinphonePresenceModel *presence);
359
360
LinphoneFriend *linphone_find_friend_by_inc_subscribe(MSList *l, SalOp *op);
LinphoneFriend *linphone_find_friend_by_out_subscribe(MSList *l, SalOp *op);
Ghislain MARY's avatar
Ghislain MARY committed
361
MSList *linphone_find_friend_by_address(MSList *fl, const LinphoneAddress *addr, LinphoneFriend **lf);
362
363
bool_t linphone_core_should_subscribe_friends_only_when_registered(const LinphoneCore *lc);
void linphone_core_update_friends_subscriptions(LinphoneCore *lc, LinphoneProxyConfig *cfg, bool_t only_when_registered);
364

365
int parse_hostname_to_addr(const char *server, struct sockaddr_storage *ss, socklen_t *socklen, int default_port);
Simon Morlat's avatar
Simon Morlat committed
366

aymeric's avatar
aymeric committed
367
368
369
bool_t host_has_ipv6_network();
bool_t lp_spawn_command_line_sync(const char *command, char **result,int *command_ret);

370
static MS2_INLINE int get_min_bandwidth(int dbw, int ubw){
Simon Morlat's avatar
Simon Morlat committed
371
372
	if (dbw<=0) return ubw;
	if (ubw<=0) return dbw;
aymeric's avatar
aymeric committed
373
374
375
	return MIN(dbw,ubw);
}

376
static MS2_INLINE bool_t bandwidth_is_greater(int bw1, int bw2){
377
378
	if (bw1<=0) return TRUE;
	else if (bw2<=0) return FALSE;
aymeric's avatar
aymeric committed
379
380
381
	else return bw1>=bw2;
}

382
static MS2_INLINE int get_remaining_bandwidth_for_video(int total, int audio){
383
384
385
	int ret = total-audio-10;
	if (ret < 0) ret = 0;
	return ret;
386
387
}

388
static MS2_INLINE void set_string(char **dest, const char *src){
smorlat's avatar
smorlat committed
389
390
391
392
393
394
395
396
	if (*dest){
		ms_free(*dest);
		*dest=NULL;
	}
	if (src)
		*dest=ms_strdup(src);
}

aymeric's avatar
aymeric committed
397
#define PAYLOAD_TYPE_ENABLED	PAYLOAD_TYPE_USER_FLAG_0
398
#define PAYLOAD_TYPE_BITRATE_OVERRIDE PAYLOAD_TYPE_USER_FLAG_3
399
#define PAYLOAD_TYPE_FROZEN_NUMBER	PAYLOAD_TYPE_USER_FLAG_4
aymeric's avatar
aymeric committed
400

401
402
void linphone_process_authentication(LinphoneCore* lc, SalOp *op);
void linphone_authentication_ok(LinphoneCore *lc, SalOp *op);
403
void linphone_subscription_new(LinphoneCore *lc, SalOp *op, const char *from);
404
void linphone_core_send_presence(LinphoneCore *lc, LinphonePresenceModel *presence);
405
void linphone_notify_parse_presence(SalOp *op, const char *content_type, const char *content_subtype, const char *body, SalPresenceModel **result);
406
void linphone_notify_convert_presence_to_xml(SalOp *op, SalPresenceModel *presence, const char *contact, char **content);
407
void linphone_notify_recv(LinphoneCore *lc, SalOp *op, SalSubscribeStatus ss, SalPresenceModel *model);
408
void linphone_proxy_config_process_authentication_failure(LinphoneCore *lc, SalOp *op);
409
410
void linphone_core_soundcard_hint_check(LinphoneCore* lc);

aymeric's avatar
aymeric committed
411

412
413
void linphone_subscription_answered(LinphoneCore *lc, SalOp *op);
void linphone_subscription_closed(LinphoneCore *lc, SalOp *op);
aymeric's avatar
aymeric committed
414

415
void linphone_core_update_allocated_audio_bandwidth(LinphoneCore *lc);
416
void linphone_core_update_allocated_audio_bandwidth_in_call(LinphoneCall *call, const PayloadType *pt, int maxbw);
417

418
LINPHONE_PUBLIC int linphone_core_run_stun_tests(LinphoneCore *lc, LinphoneCall *call);
419
void linphone_core_resolve_stun_server(LinphoneCore *lc);
420
LINPHONE_PUBLIC const struct addrinfo *linphone_core_get_stun_server_addrinfo(LinphoneCore *lc);
Simon Morlat's avatar
Simon Morlat committed
421
void linphone_core_adapt_to_network(LinphoneCore *lc, int ping_time_ms, LinphoneCallParams *params);
422
int linphone_core_gather_ice_candidates(LinphoneCore *lc, LinphoneCall *call);
423
void linphone_core_update_ice_state_in_call_stats(LinphoneCall *call);
Simon Morlat's avatar
Simon Morlat committed
424
void linphone_call_stats_fill(LinphoneCallStats *stats, MediaStream *ms, OrtpEvent *ev);
Simon Morlat's avatar
Simon Morlat committed
425
void linphone_call_stop_ice_for_inactive_streams(LinphoneCall *call);
426
427
428
void _update_local_media_description_from_ice(SalMediaDescription *desc, IceSession *session);
void linphone_call_update_local_media_description_from_ice_or_upnp(LinphoneCall *call);
void linphone_call_update_ice_from_remote_media_description(LinphoneCall *call, const SalMediaDescription *md);
429
bool_t linphone_core_media_description_contains_video_stream(const SalMediaDescription *md);
aymeric's avatar
aymeric committed
430

431
void linphone_core_send_initial_subscribes(LinphoneCore *lc);
432
void linphone_core_write_friends_config(LinphoneCore* lc);
smorlat's avatar
smorlat committed
433
434
435
void linphone_friend_write_to_config_file(struct _LpConfig *config, LinphoneFriend *lf, int index);
LinphoneFriend * linphone_friend_new_from_config_file(struct _LinphoneCore *lc, int index);

smorlat's avatar
smorlat committed
436
void linphone_proxy_config_update(LinphoneProxyConfig *cfg);
Simon Morlat's avatar
Simon Morlat committed
437
LinphoneProxyConfig * linphone_core_lookup_known_proxy(LinphoneCore *lc, const LinphoneAddress *uri);
438
const char *linphone_core_find_best_identity(LinphoneCore *lc, const LinphoneAddress *to);
439
int linphone_core_get_local_ip_for(int type, const char *dest, char *result);
Ghislain MARY's avatar
Ghislain MARY committed
440
void linphone_core_get_local_ip(LinphoneCore *lc, int af, const char *dest, char *result);
441

jehan's avatar
jehan committed
442
LinphoneProxyConfig *linphone_proxy_config_new_from_config_file(LinphoneCore *lc, int index);
smorlat's avatar
smorlat committed
443
444
void linphone_proxy_config_write_to_config_file(struct _LpConfig* config,LinphoneProxyConfig *obj, int index);

Simon Morlat's avatar
Simon Morlat committed
445
void linphone_core_message_received(LinphoneCore *lc, SalOp *op, const SalMessage *msg);
446
void linphone_core_is_composing_received(LinphoneCore *lc, SalOp *op, const SalIsComposing *is_composing);
447

Yann Diorcet's avatar
Yann Diorcet committed
448
void linphone_call_init_stats(LinphoneCallStats *stats, int type);
449
void linphone_call_fix_call_parameters(LinphoneCall *call);
450
451
void linphone_call_init_audio_stream(LinphoneCall *call);
void linphone_call_init_video_stream(LinphoneCall *call);
452
void linphone_call_init_media_streams(LinphoneCall *call);
453
void linphone_call_start_media_streams(LinphoneCall *call, bool_t all_inputs_muted, bool_t send_ringbacktone);
454
void linphone_call_start_media_streams_for_ice_gathering(LinphoneCall *call);
455
void linphone_call_stop_media_streams(LinphoneCall *call);
456
void linphone_call_delete_ice_session(LinphoneCall *call);
Yann Diorcet's avatar
Yann Diorcet committed
457
void linphone_call_delete_upnp_session(LinphoneCall *call);
458
void linphone_call_stop_media_streams_for_ice_gathering(LinphoneCall *call);
459
void linphone_call_update_crypto_parameters(LinphoneCall *call, SalMediaDescription *old_md, SalMediaDescription *new_md);
460
void linphone_call_update_remote_session_id_and_ver(LinphoneCall *call);
461
int _linphone_core_apply_transports(LinphoneCore *lc);
462
const char * linphone_core_get_identity(LinphoneCore *lc);
463

464
465
466
467
void linphone_core_start_waiting(LinphoneCore *lc, const char *purpose);
void linphone_core_update_progress(LinphoneCore *lc, const char *purpose, float progresses);
void linphone_core_stop_waiting(LinphoneCore *lc);

468
int linphone_core_proceed_with_invite_if_ready(LinphoneCore *lc, LinphoneCall *call, LinphoneProxyConfig *dest_proxy);
469
int linphone_core_start_invite(LinphoneCore *lc, LinphoneCall *call, const LinphoneAddress* destination/* = NULL if to be taken from the call log */);
Simon Morlat's avatar
Simon Morlat committed
470
int linphone_core_restart_invite(LinphoneCore *lc, LinphoneCall *call);
471
472
473
/*
 * param automatic_offering aims is to take into account previous answer for video in case of automatic re-invite.
 *  Purpose is to avoid to re-ask video previously declined */
474
int linphone_core_start_update_call(LinphoneCore *lc, LinphoneCall *call);
475
int linphone_core_start_accept_call_update(LinphoneCore *lc, LinphoneCall *call, LinphoneCallState next_state, const char *state_info);
476
void linphone_core_notify_incoming_call(LinphoneCore *lc, LinphoneCall *call);
477
bool_t linphone_core_incompatible_security(LinphoneCore *lc, SalMediaDescription *md);
478
extern SalCallbacks linphone_sal_callbacks;
479
bool_t linphone_core_rtcp_enabled(const LinphoneCore *lc);
480
bool_t linphone_core_symmetric_rtp_enabled(LinphoneCore*lc);
481

482
483
void linphone_core_queue_task(LinphoneCore *lc, belle_sip_source_func_t task_fun, void *data, const char *task_description);

484
485
486
487
488
489
490
491
typedef enum _LinphoneProxyConfigAddressComparisonResult{
	LinphoneProxyConfigAddressDifferent,
	LinphoneProxyConfigAddressEqual,
	LinphoneProxyConfigAddressWeakEqual
} LinphoneProxyConfigAddressComparisonResult;

LINPHONE_PUBLIC LinphoneProxyConfigAddressComparisonResult linphone_proxy_config_address_equal(const LinphoneAddress *a, const LinphoneAddress *b);
LINPHONE_PUBLIC LinphoneProxyConfigAddressComparisonResult linphone_proxy_config_is_server_config_changed(const LinphoneProxyConfig* obj);
492
493
494
/**
 * unregister without moving the register_enable flag
 */
495
void _linphone_proxy_config_unregister(LinphoneProxyConfig *obj);
496
void _linphone_proxy_config_release_ops(LinphoneProxyConfig *obj);
497

498
/*chat*/
499
void linphone_chat_room_release(LinphoneChatRoom *cr);
jehan's avatar
jehan committed
500
void linphone_chat_message_destroy(LinphoneChatMessage* msg);
501
void linphone_chat_message_update_state(LinphoneChatMessage* chat_msg );
502
/**/
jehan's avatar
jehan committed
503

504
505
struct _LinphoneProxyConfig
{
506
507
	belle_sip_object_t base;
	void *user_data;
508
509
510
	struct _LinphoneCore *lc;
	char *reg_proxy;
	char *reg_identity;
511
	LinphoneAddress* identity_address;
512
	char *reg_route;
513
	char *quality_reporting_collector;
514
	char *realm;
515
	char *contact_params;
516
	char *contact_uri_params;
517
	int expires;
518
	int publish_expires;
519
	SalOp *op;
520
	SalCustomHeader *sent_headers;
521
522
523
524
	char *type;
	struct _SipSetupContext *ssctx;
	int auth_failures;
	char *dial_prefix;
525
	LinphoneRegistrationState state;
Simon Morlat's avatar
Simon Morlat committed
526
	SalOp *publish_op;
527
	LinphoneAVPFMode avpf_mode;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
528

529
530
531
532
	bool_t commit;
	bool_t reg_sendregister;
	bool_t publish;
	bool_t dial_escape_plus;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
533

534
	bool_t send_publish;
535
	bool_t quality_reporting_enabled;
536
	uint8_t avpf_rr_interval;
537
	uint8_t quality_reporting_interval;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
538

539
	time_t deletion_date;
jehan's avatar
jehan committed
540
	LinphonePrivacyMask privacy;
541
542
543
544
	/*use to check if server config has changed  between edit() and done()*/
	LinphoneAddress *saved_proxy;
	LinphoneAddress *saved_identity;
	/*---*/
545
	LinphoneAddress *pending_contact; /*use to store previous contact in case of network failure*/
546

547
548
};

549
550
BELLE_SIP_DECLARE_VPTR(LinphoneProxyConfig);

551
struct _LinphoneAuthInfo
552
553
554
555
556
557
{
	char *username;
	char *realm;
	char *userid;
	char *passwd;
	char *ha1;
558
	char *domain;
559
560
};

561
562
563
564
565
typedef enum _LinphoneIsComposingState {
	LinphoneIsComposingIdle,
	LinphoneIsComposingActive
} LinphoneIsComposingState;

566
struct _LinphoneChatRoom{
567
568
	belle_sip_object_t base;
	void *user_data;
569
570
571
	struct _LinphoneCore *lc;
	char  *peer;
	LinphoneAddress *peer_url;
Margaux Clerc's avatar
Margaux Clerc committed
572
	MSList *messages_hist;
573
	MSList *transient_messages;
574
	int unread_count;
575
576
577
578
579
	LinphoneIsComposingState remote_is_composing;
	LinphoneIsComposingState is_composing;
	belle_sip_source_t *remote_composing_refresh_timer;
	belle_sip_source_t *composing_idle_timer;
	belle_sip_source_t *composing_refresh_timer;
580
581
};

582
BELLE_SIP_DECLARE_VPTR(LinphoneChatRoom);
jehan's avatar
jehan committed
583

584

585
struct _LinphoneFriend{
586
587
	belle_sip_object_t base;
	void *user_data;
588
589
590
591
	LinphoneAddress *uri;
	SalOp *insub;
	SalOp *outsub;
	LinphoneSubscribePolicy pol;
592
	LinphonePresenceModel *presence;
593
594
595
596
	struct _LinphoneCore *lc;
	BuddyInfo *info;
	char *refkey;
	bool_t subscribe;
597
	bool_t subscribe_active;
598
	bool_t inc_subscribe_pending;
599
	bool_t commit;
600
	bool_t initial_subscribes_sent; /*used to know if initial subscribe message was sent or not*/
601
};
602

603
604
BELLE_SIP_DECLARE_VPTR(LinphoneFriend);

jehan's avatar
jehan committed
605

606
607
608
609
610
611
612
typedef struct sip_config
{
	char *contact;
	char *guessed_contact;
	MSList *proxies;
	MSList *deleted_proxies;
	int inc_timeout;	/*timeout after an un-answered incoming call is rejected*/
Yann Diorcet's avatar
Yann Diorcet committed
613
	int in_call_timeout;	/*timeout after a call is hangup */
614
	int delayed_timeout; 	/*timeout after a delayed call is resumed */
615
616
	unsigned int keepalive_period; /* interval in ms between keep alive messages sent to the proxy server*/
	LCSipTransports transports;
617
618
619
620
621
	bool_t guess_hostname;
	bool_t loopback_only;
	bool_t ipv6_enabled;
	bool_t sdp_200_ack;
	bool_t register_only_when_network_is_up;
622
	bool_t register_only_when_upnp_is_ok;
623
	bool_t ping_with_options;
jehan's avatar
jehan committed
624
	bool_t auto_net_state_mon;
625
	bool_t tcp_tls_keepalive;
626
	bool_t vfu_with_info; /*use to enable vfu request using sip info*/
627
	bool_t save_auth_info; // if true, auth infos will be write in the config file when they are added to the list
628
629
630
631
} sip_config_t;

typedef struct rtp_config
{
632
633
634
635
	int audio_rtp_min_port;
	int audio_rtp_max_port;
	int video_rtp_min_port;
	int video_rtp_max_port;
636
637
638
	int audio_jitt_comp;  /*jitter compensation*/
	int video_jitt_comp;  /*jitter compensation*/
	int nortp_timeout;
639
	int disable_upnp;
640
	MSCryptoSuite *srtp_suites;
641
	LinphoneAVPFMode avpf_mode;
642
	bool_t rtp_no_xmit_on_audio_mute;
643
							  /* stop rtp xmit when audio muted */
644
645
	bool_t audio_adaptive_jitt_comp_enabled;
	bool_t video_adaptive_jitt_comp_enabled;
Simon Morlat's avatar
Simon Morlat committed
646
	bool_t pad;
jehan's avatar
jehan committed
647
648
649
650
651
652
	char* audio_multicast_addr;
	bool_t audio_multicast_enabled;
	int audio_multicast_ttl;
	char* video_multicast_addr;
	int video_multicast_ttl;
	bool_t video_multicast_enabled;
653
654
655
656
657
658
}rtp_config_t;



typedef struct net_config
{
659
660
	char *nat_address; /* may be IP or host name */
	char *nat_address_ip; /* ip translated from nat_address */
661
	char *stun_server;
662
	struct addrinfo *stun_addrinfo;
Simon Morlat's avatar
Simon Morlat committed
663
	SalResolverContext * stun_res;
664
665
666
	int download_bw;
	int upload_bw;
	int mtu;
667
	OrtpNetworkSimulatorParams netsim_params;
668
669
670
671
672
673
674
675
676
	bool_t nat_sdp_only;
}net_config_t;


typedef struct sound_config
{
	struct _MSSndCard * ring_sndcard;	/* the playback sndcard currently used */
	struct _MSSndCard * play_sndcard;	/* the playback sndcard currently used */
	struct _MSSndCard * capt_sndcard; /* the capture sndcard currently used */
677
	struct _MSSndCard * lsd_card; /* dummy playback card for Linphone Sound Daemon extension */
678
679
	const char **cards;
	int latency;	/* latency in samples of the current used sound device */
680
	float soft_play_lev; /*playback gain in db.*/
Yann Diorcet's avatar
Yann Diorcet committed
681
	float soft_mic_lev; /*mic gain in db.*/
682
683
684
685
686
687
	char rec_lev;
	char play_lev;
	char ring_lev;
	char source;
	char *local_ring;
	char *remote_ring;
688
	char *ringback_tone;
689
690
691
692
693
694
695
696
	bool_t ec;
	bool_t ea;
	bool_t agc;
} sound_config_t;

typedef struct codecs_config
{
	MSList *audio_codecs;  /* list of audio codecs in order of preference*/
697
698
699
	MSList *video_codecs;
	int dyn_pt;
	int telephone_event_pt;
700
701
702
703
704
705
}codecs_config_t;

typedef struct video_config{
	struct _MSWebCam *device;
	const char **cams;
	MSVideoSize vsize;
706
	MSVideoSize preview_vsize; /*is 0,0 if no forced preview size is set, in which case vsize field above is used.*/
707
	float fps;
708
709
710
711
	bool_t capture;
	bool_t show_local;
	bool_t display;
	bool_t selfview; /*during calls*/
Guillaume BIENKOWSKI's avatar
Guillaume BIENKOWSKI committed
712
	bool_t reuse_preview_source;
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
}video_config_t;

typedef struct ui_config
{
	int is_daemon;
	int is_applet;
	unsigned int timer_id;  /* the timer id for registration */
}ui_config_t;



typedef struct autoreplier_config
{
	int enabled;
	int after_seconds;		/* accept the call after x seconds*/
	int max_users;			/* maximum number of user that can call simultaneously */
	int max_rec_time;  	/* the max time of incoming voice recorded */
	int max_rec_msg;		/* maximum number of recorded messages */
	const char *message;		/* the path of the file to be played */
}autoreplier_config_t;

Simon Morlat's avatar
Simon Morlat committed
734
735
736
737
struct _LinphoneConference{
	MSAudioConference *conf;
	AudioStream *local_participant;
	MSAudioEndpoint *local_endpoint;
738
	MSAudioEndpoint *record_endpoint;
739
	RtpProfile *local_dummy_profile;
740
	bool_t local_muted;
741
	bool_t terminated;
Simon Morlat's avatar
Simon Morlat committed
742
743
};

744
745
746
747
748
749
750
751
752
753
754

typedef struct _LinphoneToneDescription{
	LinphoneReason reason;
	LinphoneToneID toneid;
	char *audiofile;
}LinphoneToneDescription;

LinphoneToneDescription * linphone_tone_description_new(LinphoneReason reason, LinphoneToneID id, const char *audiofile);
void linphone_tone_description_destroy(LinphoneToneDescription *obj);
LinphoneToneDescription *linphone_core_get_call_error_tone(const LinphoneCore *lc, LinphoneReason reason);
void linphone_core_play_call_error_tone(LinphoneCore *lc, LinphoneReason reason);
755
756
void _linphone_core_set_tone(LinphoneCore *lc, LinphoneReason reason, LinphoneToneID id, const char *audiofile);
const char *linphone_core_get_tone_file(const LinphoneCore *lc, LinphoneToneID id);
757
int _linphone_core_accept_call_update(LinphoneCore *lc, LinphoneCall *call, const LinphoneCallParams *params, LinphoneCallState next_state, const char *state_info);
Simon Morlat's avatar
Simon Morlat committed
758
typedef struct _LinphoneConference LinphoneConference;
759
760
761

struct _LinphoneCore
{
Simon Morlat's avatar
Simon Morlat committed
762
	MSList* vtable_refs;
763
	Sal *sal;
Simon Morlat's avatar
Simon Morlat committed
764
	LinphoneGlobalState state;
765
	struct _LpConfig *config;
766
767
	MSList *default_audio_codecs;
	MSList *default_video_codecs;
768
769
770
771
772
773
774
775
776
777
778
779
	net_config_t net_conf;
	sip_config_t sip_conf;
	rtp_config_t rtp_conf;
	sound_config_t sound_conf;
	video_config_t video_conf;
	codecs_config_t codecs_conf;
	ui_config_t ui_conf;
	autoreplier_config_t autoreplier_conf;
	LinphoneProxyConfig *default_proxy;
	MSList *friends;
	MSList *auth_info;
	struct _RingStream *ringstream;
780
	time_t dmfs_playing_start_time;
781
	LCCallbackObj preview_finished_cb;
782
783
	LinphoneCall *current_call;   /* the current call */
	MSList *calls;				/* all the processed calls */
784
785
786
787
788
	MSList *queued_calls;	/* used by the autoreplier */
	MSList *call_logs;
	MSList *chatrooms;
	int max_call_logs;
	int missed_calls;
789
	VideoPreview *previewstream;
790
	struct _MSEventQueue *msevq;
Guillaume Beraudo's avatar
Guillaume Beraudo committed
791
	LinphoneRtpTransportFactories *rtptf;
792
793
794
	MSList *bl_reqs;
	MSList *subscribers;	/* unknown subscribers */
	int minutes_away;
795
	LinphonePresenceModel *presence_model;
796
797
798
799
	void *data;
	char *play_file;
	char *rec_file;
	time_t prevtime;
800
	int audio_bw; /*IP bw consumed by audio codec, set as soon as used codec is known, its purpose is to know the remaining bw for video*/
801
	LinphoneCoreWaitingCallback wait_cb;
802
	void *wait_ctx;
Ghislain MARY's avatar
Ghislain MARY committed
803
804
	void *video_window_id;
	void *preview_window_id;
805
	time_t netup_time; /*time when network went reachable */
Simon Morlat's avatar
Simon Morlat committed
806
	struct _EcCalibrator *ecc;
Simon Morlat's avatar
Simon Morlat committed
807
	MSList *hooks;
Simon Morlat's avatar
Simon Morlat committed
808
809
	LinphoneConference conf_ctx;
	char* zrtp_secrets_cache;
johan's avatar
johan committed
810
	char* user_certificates_path;
811
	LinphoneVideoPolicy video_policy;
Simon Morlat's avatar
Simon Morlat committed
812
	time_t network_last_check;
813

814
815
	bool_t use_files;
	bool_t apply_nat_settings;
816
	bool_t initial_subscribes_sent;
817
	bool_t bl_refresh;
818

819
	bool_t preview_finished;
820
	bool_t auto_net_state_mon;
821
	bool_t network_reachable;
822
	bool_t network_reachable_to_be_notified; /*set to true when state must be notified in next iterate*/
823

824
	bool_t use_preview_window;
Yann Diorcet's avatar
Yann Diorcet committed
825
	bool_t network_last_status;
826
	bool_t ringstream_autorelease;
Simon Morlat's avatar
Simon Morlat committed
827
	bool_t vtables_running;
Simon Morlat's avatar