private.h 53.8 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
	PayloadType *text_codec; /*text codec currently in use */
121 122
	MSVideoSize sent_vsize; /* Size of the video currently being sent */
	MSVideoSize recv_vsize; /* Size of the video currently being received */
123
	float received_fps,sent_fps;
Simon Morlat's avatar
Simon Morlat committed
124 125 126 127
	int down_bw;
	int up_bw;
	int down_ptime;
	int up_ptime;
Simon Morlat's avatar
Simon Morlat committed
128
	char *record_file;
Simon Morlat's avatar
Simon Morlat committed
129
	char *session_name;
130
	SalCustomHeader *custom_headers;
131 132 133
	LinphonePrivacyMask privacy;
	LinphoneMediaDirection audio_dir;
	LinphoneMediaDirection video_dir;
134
	bool_t has_video;
135
	bool_t avpf_enabled; /* RTCP feedback messages are enabled */
136
	bool_t real_early_media; /*send real media even during early media (for outgoing calls)*/
Simon Morlat's avatar
Simon Morlat committed
137
	bool_t in_conference; /*in conference mode */
138
	
jehan's avatar
jehan committed
139
	bool_t low_bandwidth;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
140
	bool_t no_user_consent;/*when set to TRUE an UPDATE request will be used instead of reINVITE*/
141
	uint16_t avpf_rr_interval; /*in milliseconds*/
142 143
	
	bool_t internal_call_update; /*use mark that call update was requested internally (might be by ice) - unused for the moment*/
144 145
	bool_t video_multicast_enabled;
	bool_t audio_multicast_enabled;
146
	bool_t realtimetext_enabled;
147
};
148

149 150 151
BELLE_SIP_DECLARE_VPTR(LinphoneCallParams);


152 153 154
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*/
155
	LinphoneQualityReportingReportSendCb on_report_sent;
156 157
};

158
struct _LinphoneCallLog{
159 160
	belle_sip_object_t base;
	void *user_data;
161 162 163 164 165 166
	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*/
167
	int duration; /**<Duration of the call starting in connected state in seconds*/
168 169 170 171 172
	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 */
173
	time_t connected_date_time; /**Connecting date of the call in seconds as expressed in a time_t */
174
	char* call_id; /**unique id of a call*/
175
	struct _LinphoneQualityReporting reporting;
176
	bool_t video_enabled;
177
	unsigned int storage_id;
178 179
};

180 181
BELLE_SIP_DECLARE_VPTR(LinphoneCallLog);

182

183 184
typedef struct _CallCallbackObj
{
185 186
	LinphoneCallCbFunc _func;
	void * _user_data;
187
}CallCallbackObj;
188

189 190 191
struct _LinphoneChatMessageCbs {
	belle_sip_object_t base;
	void *user_data;
192 193 194 195
	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 */
196 197 198 199
};

BELLE_SIP_DECLARE_VPTR(LinphoneChatMessageCbs);

Simon Morlat's avatar
Simon Morlat committed
200 201 202 203 204
typedef enum _LinphoneChatMessageDir{
	LinphoneChatMessageIncoming,
	LinphoneChatMessageOutgoing
} LinphoneChatMessageDir;

jehan's avatar
jehan committed
205
struct _LinphoneChatMessage {
206
	belle_sip_object_t base;
jehan's avatar
jehan committed
207
	LinphoneChatRoom* chat_room;
208
	LinphoneChatMessageCbs *callbacks;
Simon Morlat's avatar
Simon Morlat committed
209 210
	LinphoneChatMessageDir dir;
	char* message;
211 212
	LinphoneChatMessageStateChangedCb message_state_changed_cb;
	void* message_state_changed_user_data;
jehan's avatar
jehan committed
213
	void* message_userdata;
214
	char* appdata;
215
	char* external_body_url;
Simon Morlat's avatar
Simon Morlat committed
216 217
	LinphoneAddress *from;
	LinphoneAddress *to;
218
	time_t time;
219
	SalCustomHeader *custom_headers;
Margaux Clerc's avatar
Margaux Clerc committed
220
	LinphoneChatMessageState state;
Simon Morlat's avatar
Simon Morlat committed
221
	bool_t is_read;
222
	unsigned int storage_id;
223
	SalOp *op;
224 225 226
	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 */
227
	belle_http_request_listener_t *http_listener; /* our listener, only owned by us*/
228
	char *file_transfer_filepath;
jehan's avatar
jehan committed
229
};
230

231 232
BELLE_SIP_DECLARE_VPTR(LinphoneChatMessage);

233 234 235 236 237 238
typedef struct StunCandidate{
	char addr[64];
	int port;
}StunCandidate;


239
typedef struct _PortConfig{
240
	char multicast_ip[LINPHONE_IPADDR_SIZE];
241 242 243 244
	int rtp_port;
	int rtcp_port;
}PortConfig;

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

303 304 305
	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*/

306
	char *dtls_certificate_fingerprint; /**> This fingerprint is computed during stream init and is stored in call to be used when making local media description */
307
	LinphoneChatRoom *chat_room;
308
	bool_t refer_pending;
309
	bool_t expect_media_in_ack;
310
	bool_t audio_muted;
311
	bool_t camera_enabled;
312

313
	bool_t all_muted; /*this flag is set during early medias*/
314
	bool_t playing_ringbacktone;
315
	bool_t ringing_beep; /* whether this call is ringing through an already existent current call*/
Simon Morlat's avatar
Simon Morlat committed
316
	bool_t auth_token_verified;
317

318
	bool_t defer_update;
319
	bool_t was_automatically_paused;
320
	bool_t ping_replied;
Simon Morlat's avatar
Simon Morlat committed
321
	bool_t record_active;
322

323
	bool_t paused_by_app;
324
	bool_t broken; /*set to TRUE when the call is in broken state due to network disconnection or transport */
325
};
smorlat's avatar
smorlat committed
326

327 328
BELLE_SIP_DECLARE_VPTR(LinphoneCall);

329

Simon Morlat's avatar
Simon Morlat committed
330
LinphoneCall * linphone_call_new_outgoing(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, const LinphoneCallParams *params, LinphoneProxyConfig *cfg);
331
LinphoneCall * linphone_call_new_incoming(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, SalOp *op);
332
void linphone_call_set_new_params(LinphoneCall *call, const LinphoneCallParams *params);
333
void linphone_call_set_state(LinphoneCall *call, LinphoneCallState cstate, const char *message);
jehan's avatar
jehan committed
334
void linphone_call_set_contact_op(LinphoneCall* call);
335
void linphone_call_set_compatible_incoming_call_parameters(LinphoneCall *call, SalMediaDescription *md);
smorlat's avatar
smorlat committed
336
/* private: */
337
LinphoneCallLog * linphone_call_log_new(LinphoneCallDir dir, LinphoneAddress *local, LinphoneAddress * remote);
338
void linphone_call_log_completed(LinphoneCall *call);
smorlat's avatar
smorlat committed
339
void linphone_call_log_destroy(LinphoneCallLog *cl);
340
void linphone_call_set_transfer_state(LinphoneCall* call, LinphoneCallState state);
341
LinphonePlayer *linphone_call_build_player(LinphoneCall*call);
smorlat's avatar
smorlat committed
342

343 344
LinphoneCallParams * linphone_call_params_new(void);
SalMediaProto get_proto_from_call_params(const LinphoneCallParams *params);
345 346
SalStreamDir get_audio_dir_from_call_params(const LinphoneCallParams *params);
SalStreamDir get_video_dir_from_call_params(const LinphoneCallParams *params);
347
void linphone_call_params_set_custom_headers(LinphoneCallParams *params, const SalCustomHeader *ch);
348

aymeric's avatar
aymeric committed
349
void linphone_auth_info_write_config(struct _LpConfig *config, LinphoneAuthInfo *obj, int pos);
350
void linphone_core_write_auth_info(LinphoneCore *lc, LinphoneAuthInfo *ai);
351
const LinphoneAuthInfo *_linphone_core_find_auth_info(LinphoneCore *lc, const char *realm, const char *username, const char *domain, bool_t ignore_realm);
aymeric's avatar
aymeric committed
352 353 354

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

358
int linphone_proxy_config_send_publish(LinphoneProxyConfig *cfg, LinphonePresenceModel *presence);
359
void linphone_proxy_config_set_state(LinphoneProxyConfig *cfg, LinphoneRegistrationState rstate, const char *message);
360
void linphone_proxy_config_stop_refreshing(LinphoneProxyConfig *obj);
361
void linphone_proxy_config_write_all_to_config_file(LinphoneCore *lc);
362
void _linphone_proxy_config_release(LinphoneProxyConfig *cfg);
jehan's avatar
jehan committed
363 364 365 366 367
/*
 * 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);
368

369
void linphone_friend_close_subscriptions(LinphoneFriend *lf);
370
void linphone_friend_update_subscribes(LinphoneFriend *fr, LinphoneProxyConfig *cfg, bool_t only_when_registered);
371
void linphone_friend_notify(LinphoneFriend *lf, LinphonePresenceModel *presence);
372 373
void linphone_friend_add_incoming_subscription(LinphoneFriend *lf, SalOp *op);
void linphone_friend_remove_incoming_subscription(LinphoneFriend *lf, SalOp *op);
374 375
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
376
MSList *linphone_find_friend_by_address(MSList *fl, const LinphoneAddress *addr, LinphoneFriend **lf);
377 378
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);
379

380
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
381

aymeric's avatar
aymeric committed
382 383 384
bool_t host_has_ipv6_network();
bool_t lp_spawn_command_line_sync(const char *command, char **result,int *command_ret);

385
static MS2_INLINE int get_min_bandwidth(int dbw, int ubw){
Simon Morlat's avatar
Simon Morlat committed
386 387
	if (dbw<=0) return ubw;
	if (ubw<=0) return dbw;
aymeric's avatar
aymeric committed
388 389 390
	return MIN(dbw,ubw);
}

391
static MS2_INLINE bool_t bandwidth_is_greater(int bw1, int bw2){
392 393
	if (bw1<=0) return TRUE;
	else if (bw2<=0) return FALSE;
aymeric's avatar
aymeric committed
394 395 396
	else return bw1>=bw2;
}

397
static MS2_INLINE int get_remaining_bandwidth_for_video(int total, int audio){
398 399 400
	int ret = total-audio-10;
	if (ret < 0) ret = 0;
	return ret;
401 402
}

403
static MS2_INLINE void set_string(char **dest, const char *src){
smorlat's avatar
smorlat committed
404 405 406 407 408 409 410 411
	if (*dest){
		ms_free(*dest);
		*dest=NULL;
	}
	if (src)
		*dest=ms_strdup(src);
}

aymeric's avatar
aymeric committed
412
#define PAYLOAD_TYPE_ENABLED	PAYLOAD_TYPE_USER_FLAG_0
413
#define PAYLOAD_TYPE_BITRATE_OVERRIDE PAYLOAD_TYPE_USER_FLAG_3
414
#define PAYLOAD_TYPE_FROZEN_NUMBER	PAYLOAD_TYPE_USER_FLAG_4
aymeric's avatar
aymeric committed
415

416 417
void linphone_process_authentication(LinphoneCore* lc, SalOp *op);
void linphone_authentication_ok(LinphoneCore *lc, SalOp *op);
418
void linphone_subscription_new(LinphoneCore *lc, SalOp *op, const char *from);
419
void linphone_core_send_presence(LinphoneCore *lc, LinphonePresenceModel *presence);
420
void linphone_notify_parse_presence(SalOp *op, const char *content_type, const char *content_subtype, const char *body, SalPresenceModel **result);
421
void linphone_notify_convert_presence_to_xml(SalOp *op, SalPresenceModel *presence, const char *contact, char **content);
422
void linphone_notify_recv(LinphoneCore *lc, SalOp *op, SalSubscribeStatus ss, SalPresenceModel *model);
423
void linphone_proxy_config_process_authentication_failure(LinphoneCore *lc, SalOp *op);
424 425
void linphone_core_soundcard_hint_check(LinphoneCore* lc);

aymeric's avatar
aymeric committed
426

427 428
void linphone_subscription_answered(LinphoneCore *lc, SalOp *op);
void linphone_subscription_closed(LinphoneCore *lc, SalOp *op);
aymeric's avatar
aymeric committed
429

430
void linphone_core_update_allocated_audio_bandwidth(LinphoneCore *lc);
431
void linphone_core_update_allocated_audio_bandwidth_in_call(LinphoneCall *call, const PayloadType *pt, int maxbw);
432

433
LINPHONE_PUBLIC int linphone_core_run_stun_tests(LinphoneCore *lc, LinphoneCall *call);
434
void linphone_core_resolve_stun_server(LinphoneCore *lc);
435
LINPHONE_PUBLIC const struct addrinfo *linphone_core_get_stun_server_addrinfo(LinphoneCore *lc);
Simon Morlat's avatar
Simon Morlat committed
436
void linphone_core_adapt_to_network(LinphoneCore *lc, int ping_time_ms, LinphoneCallParams *params);
437
int linphone_core_gather_ice_candidates(LinphoneCore *lc, LinphoneCall *call);
438
void linphone_core_update_ice_state_in_call_stats(LinphoneCall *call);
Simon Morlat's avatar
Simon Morlat committed
439
void linphone_call_stats_fill(LinphoneCallStats *stats, MediaStream *ms, OrtpEvent *ev);
Simon Morlat's avatar
Simon Morlat committed
440
void linphone_call_stop_ice_for_inactive_streams(LinphoneCall *call);
441 442 443
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);
444
bool_t linphone_core_media_description_contains_video_stream(const SalMediaDescription *md);
aymeric's avatar
aymeric committed
445

446
void linphone_core_send_initial_subscribes(LinphoneCore *lc);
447
void linphone_core_write_friends_config(LinphoneCore* lc);
smorlat's avatar
smorlat committed
448 449 450
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
451
void linphone_proxy_config_update(LinphoneProxyConfig *cfg);
Simon Morlat's avatar
Simon Morlat committed
452
LinphoneProxyConfig * linphone_core_lookup_known_proxy(LinphoneCore *lc, const LinphoneAddress *uri);
453
const char *linphone_core_find_best_identity(LinphoneCore *lc, const LinphoneAddress *to);
454
int linphone_core_get_local_ip_for(int type, const char *dest, char *result);
Ghislain MARY's avatar
Ghislain MARY committed
455
void linphone_core_get_local_ip(LinphoneCore *lc, int af, const char *dest, char *result);
456

jehan's avatar
jehan committed
457
LinphoneProxyConfig *linphone_proxy_config_new_from_config_file(LinphoneCore *lc, int index);
smorlat's avatar
smorlat committed
458 459
void linphone_proxy_config_write_to_config_file(struct _LpConfig* config,LinphoneProxyConfig *obj, int index);

Simon Morlat's avatar
Simon Morlat committed
460
void linphone_core_message_received(LinphoneCore *lc, SalOp *op, const SalMessage *msg);
461
void linphone_core_is_composing_received(LinphoneCore *lc, SalOp *op, const SalIsComposing *is_composing);
Sylvain Berfini's avatar
Sylvain Berfini committed
462
void linphone_core_real_time_text_received(LinphoneCore *lc, LinphoneChatRoom *cr, uint32_t character, LinphoneCall *call);
463

Yann Diorcet's avatar
Yann Diorcet committed
464
void linphone_call_init_stats(LinphoneCallStats *stats, int type);
465
void linphone_call_fix_call_parameters(LinphoneCall *call, SalMediaDescription *rmd);
466 467
void linphone_call_init_audio_stream(LinphoneCall *call);
void linphone_call_init_video_stream(LinphoneCall *call);
468
void linphone_call_init_text_stream(LinphoneCall *call);
469
void linphone_call_init_media_streams(LinphoneCall *call);
470
void linphone_call_start_media_streams(LinphoneCall *call, LinphoneCallState target_state);
471
void linphone_call_start_media_streams_for_ice_gathering(LinphoneCall *call);
472
void linphone_call_stop_media_streams(LinphoneCall *call);
473
void linphone_call_delete_ice_session(LinphoneCall *call);
Yann Diorcet's avatar
Yann Diorcet committed
474
void linphone_call_delete_upnp_session(LinphoneCall *call);
475
void linphone_call_stop_media_streams_for_ice_gathering(LinphoneCall *call);
476
void linphone_call_update_crypto_parameters(LinphoneCall *call, SalMediaDescription *old_md, SalMediaDescription *new_md);
477
void linphone_call_update_remote_session_id_and_ver(LinphoneCall *call);
478
int _linphone_core_apply_transports(LinphoneCore *lc);
479
const char * linphone_core_get_identity(LinphoneCore *lc);
480

481 482 483 484
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);

485
int linphone_core_proceed_with_invite_if_ready(LinphoneCore *lc, LinphoneCall *call, LinphoneProxyConfig *dest_proxy);
486
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
487
int linphone_core_restart_invite(LinphoneCore *lc, LinphoneCall *call);
488 489 490
/*
 * 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 */
491
int linphone_core_start_update_call(LinphoneCore *lc, LinphoneCall *call);
492
int linphone_core_start_accept_call_update(LinphoneCore *lc, LinphoneCall *call, LinphoneCallState next_state, const char *state_info);
493
void linphone_core_notify_incoming_call(LinphoneCore *lc, LinphoneCall *call);
494
bool_t linphone_core_incompatible_security(LinphoneCore *lc, SalMediaDescription *md);
495
extern SalCallbacks linphone_sal_callbacks;
496
bool_t linphone_core_rtcp_enabled(const LinphoneCore *lc);
497
bool_t linphone_core_symmetric_rtp_enabled(LinphoneCore*lc);
498

499 500
void linphone_core_queue_task(LinphoneCore *lc, belle_sip_source_func_t task_fun, void *data, const char *task_description);

501 502 503 504 505 506 507 508
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);
509 510 511
/**
 * unregister without moving the register_enable flag
 */
512
void _linphone_proxy_config_unregister(LinphoneProxyConfig *obj);
513
void _linphone_proxy_config_release_ops(LinphoneProxyConfig *obj);
514

515
/*chat*/
516
void linphone_chat_room_release(LinphoneChatRoom *cr);
jehan's avatar
jehan committed
517
void linphone_chat_message_destroy(LinphoneChatMessage* msg);
518
void linphone_chat_message_update_state(LinphoneChatMessage *msg, LinphoneChatMessageState new_state);
519 520 521 522
void linphone_chat_message_set_state(LinphoneChatMessage *msg, LinphoneChatMessageState state);
void linphone_chat_room_upload_file(LinphoneChatMessage *msg);
void _linphone_chat_room_send_message(LinphoneChatRoom *cr, LinphoneChatMessage *msg);
LinphoneChatMessageCbs *linphone_chat_message_cbs_new(void);
523
LinphoneChatRoom *_linphone_core_create_chat_room_from_call(LinphoneCall *call);
524
/**/
jehan's avatar
jehan committed
525

526 527
struct _LinphoneProxyConfig
{
528 529
	belle_sip_object_t base;
	void *user_data;
530 531 532
	struct _LinphoneCore *lc;
	char *reg_proxy;
	char *reg_identity;
533
	LinphoneAddress* identity_address;
534
	char *reg_route;
535
	char *quality_reporting_collector;
536
	char *realm;
537
	char *contact_params;
538
	char *contact_uri_params;
539
	int expires;
540
	int publish_expires;
541
	SalOp *op;
542
	SalCustomHeader *sent_headers;
543 544 545 546
	char *type;
	struct _SipSetupContext *ssctx;
	int auth_failures;
	char *dial_prefix;
547
	LinphoneRegistrationState state;
Simon Morlat's avatar
Simon Morlat committed
548
	SalOp *publish_op;
549
	LinphoneAVPFMode avpf_mode;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
550

551 552 553 554
	bool_t commit;
	bool_t reg_sendregister;
	bool_t publish;
	bool_t dial_escape_plus;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
555

556
	bool_t send_publish;
557
	bool_t quality_reporting_enabled;
558
	uint8_t avpf_rr_interval;
559
	uint8_t quality_reporting_interval;
Gautier Pelloux-Prayer's avatar
Gautier Pelloux-Prayer committed
560

561
	time_t deletion_date;
jehan's avatar
jehan committed
562
	LinphonePrivacyMask privacy;
563 564 565 566
	/*use to check if server config has changed  between edit() and done()*/
	LinphoneAddress *saved_proxy;
	LinphoneAddress *saved_identity;
	/*---*/
567
	LinphoneAddress *pending_contact; /*use to store previous contact in case of network failure*/
568

569 570
};

571 572
BELLE_SIP_DECLARE_VPTR(LinphoneProxyConfig);

573
struct _LinphoneAuthInfo
574 575 576 577 578 579
{
	char *username;
	char *realm;
	char *userid;
	char *passwd;
	char *ha1;
580
	char *domain;
581 582
};

583 584 585 586 587
typedef enum _LinphoneIsComposingState {
	LinphoneIsComposingIdle,
	LinphoneIsComposingActive
} LinphoneIsComposingState;

588
struct _LinphoneChatRoom{
589 590
	belle_sip_object_t base;
	void *user_data;
591 592 593
	struct _LinphoneCore *lc;
	char  *peer;
	LinphoneAddress *peer_url;
Margaux Clerc's avatar
Margaux Clerc committed
594
	MSList *messages_hist;
595
	MSList *transient_messages;
596
	int unread_count;
597 598 599 600 601
	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;
602 603
	LinphoneCall *call;
	LinphoneChatMessage *pending_message;
604 605
};

606
BELLE_SIP_DECLARE_VPTR(LinphoneChatRoom);
jehan's avatar
jehan committed
607

608

609
struct _LinphoneFriend{
610 611
	belle_sip_object_t base;
	void *user_data;
612
	LinphoneAddress *uri;
613
	MSList *insubs; /*list of SalOp. There can be multiple instances of a same Friend that subscribe to our presence*/
614 615
	SalOp *outsub;
	LinphoneSubscribePolicy pol;
616
	LinphonePresenceModel *presence;
617 618 619 620
	struct _LinphoneCore *lc;
	BuddyInfo *info;
	char *refkey;
	bool_t subscribe;
621
	bool_t subscribe_active;
622
	bool_t inc_subscribe_pending;
623
	bool_t commit;
624
	bool_t initial_subscribes_sent; /*used to know if initial subscribe message was sent or not*/
625
};
626

627 628
BELLE_SIP_DECLARE_VPTR(LinphoneFriend);

jehan's avatar
jehan committed
629

630 631 632 633 634 635 636
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
637
	int in_call_timeout;	/*timeout after a call is hangup */
638
	int delayed_timeout; 	/*timeout after a delayed call is resumed */
639 640
	unsigned int keepalive_period; /* interval in ms between keep alive messages sent to the proxy server*/
	LCSipTransports transports;
641 642 643 644 645
	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;
646
	bool_t register_only_when_upnp_is_ok;
647
	bool_t ping_with_options;
jehan's avatar
jehan committed
648
	bool_t auto_net_state_mon;
649
	bool_t tcp_tls_keepalive;
650
	bool_t vfu_with_info; /*use to enable vfu request using sip info*/
651
	bool_t save_auth_info; // if true, auth infos will be write in the config file when they are added to the list
652 653 654 655
} sip_config_t;

typedef struct rtp_config
{
656 657 658 659
	int audio_rtp_min_port;
	int audio_rtp_max_port;
	int video_rtp_min_port;
	int video_rtp_max_port;
660 661 662
	int audio_jitt_comp;  /*jitter compensation*/
	int video_jitt_comp;  /*jitter compensation*/
	int nortp_timeout;
663
	int disable_upnp;
664
	MSCryptoSuite *srtp_suites;
665
	LinphoneAVPFMode avpf_mode;
666
	bool_t rtp_no_xmit_on_audio_mute;
667
							  /* stop rtp xmit when audio muted */
668 669
	bool_t audio_adaptive_jitt_comp_enabled;
	bool_t video_adaptive_jitt_comp_enabled;
Simon Morlat's avatar
Simon Morlat committed
670
	bool_t pad;
jehan's avatar
jehan committed
671 672 673 674 675 676
	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;
677 678
	int text_rtp_min_port;
	int text_rtp_max_port;
679 680 681 682 683 684
}rtp_config_t;



typedef struct net_config
{
685 686
	char *nat_address; /* may be IP or host name */
	char *nat_address_ip; /* ip translated from nat_address */
687
	char *stun_server;
688
	struct addrinfo *stun_addrinfo;
Simon Morlat's avatar
Simon Morlat committed
689
	SalResolverContext * stun_res;
690 691 692
	int download_bw;
	int upload_bw;
	int mtu;
693
	OrtpNetworkSimulatorParams netsim_params;
694 695 696 697 698 699 700 701 702
	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 */
703
	struct _MSSndCard * lsd_card; /* dummy playback card for Linphone Sound Daemon extension */
704 705
	const char **cards;
	int latency;	/* latency in samples of the current used sound device */
Simon Morlat's avatar