]> sjero.net Git - linphone/blob - coreapi/linphonecall.c
Delay creation of local media description so that edge network detection works with...
[linphone] / coreapi / linphonecall.c
1
2 /*
3 linphone
4 Copyright (C) 2010  Belledonne Communications SARL
5  (simon.morlat@linphone.org)
6
7 This program is free software; you can redistribute it and/or
8 modify it under the terms of the GNU General Public License
9 as published by the Free Software Foundation; either version 2
10 of the License, or (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
20 */
21 #ifdef WIN32
22 #include <time.h>
23 #endif
24 #include "linphonecore.h"
25 #include "sipsetup.h"
26 #include "lpconfig.h"
27 #include "private.h"
28 #include <ortp/event.h>
29 #include <ortp/b64.h>
30
31
32 #include "mediastreamer2/mediastream.h"
33 #include "mediastreamer2/msvolume.h"
34 #include "mediastreamer2/msequalizer.h"
35 #include "mediastreamer2/msfileplayer.h"
36 #include "mediastreamer2/msjpegwriter.h"
37 #include "mediastreamer2/mseventqueue.h"
38 #include "mediastreamer2/mssndcard.h"
39
40 #ifdef VIDEO_ENABLED
41 static MSWebCam *get_nowebcam_device(){
42         return ms_web_cam_manager_get_cam(ms_web_cam_manager_get(),"StaticImage: Static picture");
43 }
44 #endif
45
46 static bool_t generate_b64_crypto_key(int key_length, char* key_out) {
47         int b64_size;
48         uint8_t* tmp = (uint8_t*) malloc(key_length);                   
49         if (ortp_crypto_get_random(tmp, key_length)!=0) {
50                 ms_error("Failed to generate random key");
51                 free(tmp);
52                 return FALSE;
53         }
54         
55         b64_size = b64_encode((const char*)tmp, key_length, NULL, 0);
56         if (b64_size == 0) {
57                 ms_error("Failed to b64 encode key");
58                 free(tmp);
59                 return FALSE;
60         }
61         key_out[b64_size] = '\0';
62         b64_encode((const char*)tmp, key_length, key_out, 40);
63         free(tmp);
64         return TRUE;
65 }
66
67 LinphoneCore *linphone_call_get_core(const LinphoneCall *call){
68         return call->core;
69 }
70
71 const char* linphone_call_get_authentication_token(LinphoneCall *call){
72         return call->auth_token;
73 }
74
75 bool_t linphone_call_get_authentication_token_verified(LinphoneCall *call){
76         return call->auth_token_verified;
77 }
78
79 static bool_t linphone_call_are_all_streams_encrypted(LinphoneCall *call) {
80         // Check ZRTP encryption in audiostream
81         if (!call->audiostream_encrypted) {
82                 return FALSE;
83         }
84
85 #ifdef VIDEO_ENABLED
86         // If video enabled, check ZRTP encryption in videostream
87         const LinphoneCallParams *params=linphone_call_get_current_params(call);
88         if (params->has_video && !call->videostream_encrypted) {
89                 return FALSE;
90         }
91 #endif
92
93         return TRUE;
94 }
95
96 void propagate_encryption_changed(LinphoneCall *call){
97         LinphoneCore *lc=call->core;
98         if (!linphone_call_are_all_streams_encrypted(call)) {
99                 ms_message("Some streams are not encrypted");
100                 call->current_params.media_encryption=LinphoneMediaEncryptionNone;
101                 if (lc->vtable.call_encryption_changed)
102                         lc->vtable.call_encryption_changed(call->core, call, FALSE, call->auth_token);
103         } else {
104                 ms_message("All streams are encrypted");
105                 call->current_params.media_encryption=LinphoneMediaEncryptionZRTP;
106                 if (lc->vtable.call_encryption_changed)
107                         lc->vtable.call_encryption_changed(call->core, call, TRUE, call->auth_token);
108         }
109 }
110
111 #ifdef VIDEO_ENABLED
112 static void linphone_call_videostream_encryption_changed(void *data, bool_t encrypted){
113         ms_message("Video stream is %s", encrypted ? "encrypted" : "not encrypted");
114
115         LinphoneCall *call = (LinphoneCall *)data;
116         call->videostream_encrypted=encrypted;
117         propagate_encryption_changed(call);
118 }
119 #endif
120
121 static void linphone_call_audiostream_encryption_changed(void *data, bool_t encrypted) {
122         char status[255]={0};
123         ms_message("Audio stream is %s ", encrypted ? "encrypted" : "not encrypted");
124
125         LinphoneCall *call = (LinphoneCall *)data;
126         call->audiostream_encrypted=encrypted;
127         
128         if (encrypted && call->core->vtable.display_status != NULL) {
129                 snprintf(status,sizeof(status)-1,_("Authentication token is %s"),call->auth_token);
130                  call->core->vtable.display_status(call->core, status);
131         }
132
133         propagate_encryption_changed(call);
134
135
136 #ifdef VIDEO_ENABLED
137         // Enable video encryption
138         const LinphoneCallParams *params=linphone_call_get_current_params(call);
139         if (params->has_video) {
140                 ms_message("Trying to enable encryption on video stream");
141                 OrtpZrtpParams params;
142                 params.zid_file=NULL; //unused
143                 video_stream_enable_zrtp(call->videostream,call->audiostream,&params);
144         }
145 #endif
146 }
147
148
149 static void linphone_call_audiostream_auth_token_ready(void *data, const char* auth_token, bool_t verified) {
150         LinphoneCall *call=(LinphoneCall *)data;
151         if (call->auth_token != NULL)
152                 ms_free(call->auth_token);
153
154         call->auth_token=ms_strdup(auth_token);
155         call->auth_token_verified=verified;
156
157         ms_message("Authentication token is %s (%s)", auth_token, verified?"verified":"unverified");
158 }
159
160 void linphone_call_set_authentication_token_verified(LinphoneCall *call, bool_t verified){
161         if (call->audiostream==NULL){
162                 ms_error("linphone_call_set_authentication_token_verified(): No audio stream");
163         }
164         if (call->audiostream->ortpZrtpContext==NULL){
165                 ms_error("linphone_call_set_authentication_token_verified(): No zrtp context.");
166         }
167         if (!call->auth_token_verified && verified){
168                 ortp_zrtp_sas_verified(call->audiostream->ortpZrtpContext);
169         }else if (call->auth_token_verified && !verified){
170                 ortp_zrtp_sas_reset_verified(call->audiostream->ortpZrtpContext);
171         }
172         call->auth_token_verified=verified;
173         propagate_encryption_changed(call);
174 }
175
176 static MSList *make_codec_list(LinphoneCore *lc, const MSList *codecs, int bandwidth_limit,int* max_sample_rate){
177         MSList *l=NULL;
178         const MSList *it;
179         if (max_sample_rate) *max_sample_rate=0;
180         for(it=codecs;it!=NULL;it=it->next){
181                 PayloadType *pt=(PayloadType*)it->data;
182                 if (pt->flags & PAYLOAD_TYPE_ENABLED){
183                         if (bandwidth_limit>0 && !linphone_core_is_payload_type_usable_for_bandwidth(lc,pt,bandwidth_limit)){
184                                 ms_message("Codec %s/%i eliminated because of audio bandwidth constraint.",pt->mime_type,pt->clock_rate);
185                                 continue;
186                         }
187                         if (linphone_core_check_payload_type_usability(lc,pt)){
188                                 l=ms_list_append(l,payload_type_clone(pt));
189                                 if (max_sample_rate && payload_type_get_rate(pt)>*max_sample_rate) *max_sample_rate=payload_type_get_rate(pt);
190                         }
191                 }
192         }
193         return l;
194 }
195
196 static void update_media_description_from_stun(SalMediaDescription *md, const StunCandidate *ac, const StunCandidate *vc){
197         if (ac->port!=0){
198                 strcpy(md->streams[0].rtp_addr,ac->addr);
199                 md->streams[0].rtp_port=ac->port;
200                 if ((ac->addr[0]!='\0' && vc->addr[0]!='\0' && strcmp(ac->addr,vc->addr)==0) || md->nstreams==1){
201                         strcpy(md->addr,ac->addr);
202                 }
203         }
204         if (vc->port!=0){
205                 strcpy(md->streams[1].rtp_addr,vc->addr);
206                 md->streams[1].rtp_port=vc->port;
207         }
208         
209 }
210
211
212 static SalMediaDescription *_create_local_media_description(LinphoneCore *lc, LinphoneCall *call, unsigned int session_id, unsigned int session_ver){
213         MSList *l;
214         PayloadType *pt;
215         int i;
216         const char *me=linphone_core_get_identity(lc);
217         LinphoneAddress *addr=linphone_address_new(me);
218         const char *username=linphone_address_get_username (addr);
219         SalMediaDescription *md=sal_media_description_new();
220
221         md->session_id=session_id;
222         md->session_ver=session_ver;
223         md->nstreams=1;
224         strncpy(md->addr,call->localip,sizeof(md->addr));
225         strncpy(md->username,username,sizeof(md->username));
226         
227         if (call->params.down_bw)
228                 md->bandwidth=call->params.down_bw;
229         else md->bandwidth=linphone_core_get_download_bandwidth(lc);
230
231         /*set audio capabilities */
232         strncpy(md->streams[0].rtp_addr,call->localip,sizeof(md->streams[0].rtp_addr));
233         strncpy(md->streams[0].rtcp_addr,call->localip,sizeof(md->streams[0].rtcp_addr));
234         md->streams[0].rtp_port=call->audio_port;
235         md->streams[0].rtcp_port=call->audio_port+1;
236         md->streams[0].proto=(call->params.media_encryption == LinphoneMediaEncryptionSRTP) ? 
237                 SalProtoRtpSavp : SalProtoRtpAvp;
238         md->streams[0].type=SalAudio;
239         if (call->params.down_ptime)
240                 md->streams[0].ptime=call->params.down_ptime;
241         else
242                 md->streams[0].ptime=linphone_core_get_download_ptime(lc);
243         l=make_codec_list(lc,lc->codecs_conf.audio_codecs,call->params.audio_bw,&md->streams[0].max_rate);
244         pt=payload_type_clone(rtp_profile_get_payload_from_mime(&av_profile,"telephone-event"));
245         l=ms_list_append(l,pt);
246         md->streams[0].payloads=l;
247         
248
249
250         if (call->params.has_video){
251                 md->nstreams++;
252                 md->streams[1].rtp_port=call->video_port;
253                 md->streams[1].rtcp_port=call->video_port+1;
254                 md->streams[1].proto=md->streams[0].proto;
255                 md->streams[1].type=SalVideo;
256                 l=make_codec_list(lc,lc->codecs_conf.video_codecs,0,NULL);
257                 md->streams[1].payloads=l;
258         }
259         
260         for(i=0; i<md->nstreams; i++) {
261                 if (md->streams[i].proto == SalProtoRtpSavp) {
262                         md->streams[i].crypto[0].tag = 1;
263                         md->streams[i].crypto[0].algo = AES_128_SHA1_80;
264                         if (!generate_b64_crypto_key(30, md->streams[i].crypto[0].master_key))
265                                 md->streams[i].crypto[0].algo = 0;
266                         md->streams[i].crypto[1].tag = 2;
267                         md->streams[i].crypto[1].algo = AES_128_SHA1_32;
268                         if (!generate_b64_crypto_key(30, md->streams[i].crypto[1].master_key))
269                                 md->streams[i].crypto[1].algo = 0;
270                         md->streams[i].crypto[2].algo = 0;
271                 }
272         }
273         update_media_description_from_stun(md,&call->ac,&call->vc);
274         if (call->ice_session != NULL) {
275                 linphone_core_update_local_media_description_from_ice(md, call->ice_session);
276         }
277         linphone_address_destroy(addr);
278         return md;
279 }
280
281 void update_local_media_description(LinphoneCore *lc, LinphoneCall *call){
282         SalMediaDescription *md=call->localdesc;
283         if (md== NULL) {
284                 call->localdesc = create_local_media_description(lc,call);
285         } else {
286                 call->localdesc = _create_local_media_description(lc,call,md->session_id,md->session_ver+1);
287                 sal_media_description_unref(md);
288         }
289 }
290
291 SalMediaDescription *create_local_media_description(LinphoneCore *lc, LinphoneCall *call){
292         unsigned int id=rand() & 0xfff;
293         return _create_local_media_description(lc,call,id,id);
294 }
295
296 static int find_port_offset(LinphoneCore *lc){
297         int offset;
298         MSList *elem;
299         int audio_port;
300         bool_t already_used=FALSE;
301         for(offset=0;offset<100;offset+=2){
302                 audio_port=linphone_core_get_audio_port (lc)+offset;
303                 already_used=FALSE;
304                 for(elem=lc->calls;elem!=NULL;elem=elem->next){
305                         LinphoneCall *call=(LinphoneCall*)elem->data;
306                         if (call->audio_port==audio_port) {
307                                 already_used=TRUE;
308                                 break;
309                         }
310                 }
311                 if (!already_used) break;
312         }
313         if (offset==100){
314                 ms_error("Could not find any free port !");
315                 return -1;
316         }
317         return offset;
318 }
319
320 static void linphone_call_init_common(LinphoneCall *call, LinphoneAddress *from, LinphoneAddress *to){
321         int port_offset;
322         call->magic=linphone_call_magic;
323         call->refcnt=1;
324         call->state=LinphoneCallIdle;
325         call->transfer_state = LinphoneCallIdle;
326         call->start_time=time(NULL);
327         call->media_start_time=0;
328         call->log=linphone_call_log_new(call, from, to);
329         call->owns_call_log=TRUE;
330         linphone_core_notify_all_friends(call->core,LinphoneStatusOnThePhone);
331         port_offset=find_port_offset (call->core);
332         if (port_offset==-1) return;
333         call->audio_port=linphone_core_get_audio_port(call->core)+port_offset;
334         call->video_port=linphone_core_get_video_port(call->core)+port_offset;
335         linphone_call_init_stats(&call->stats[LINPHONE_CALL_STATS_AUDIO], LINPHONE_CALL_STATS_AUDIO);
336         linphone_call_init_stats(&call->stats[LINPHONE_CALL_STATS_VIDEO], LINPHONE_CALL_STATS_VIDEO);
337 }
338
339 void linphone_call_init_stats(LinphoneCallStats *stats, int type) {
340         stats->type = type;
341         stats->received_rtcp = NULL;
342         stats->sent_rtcp = NULL;
343         stats->ice_state = LinphoneIceStateNotActivated;
344 }
345
346
347 static void discover_mtu(LinphoneCore *lc, const char *remote){
348         int mtu;
349         if (lc->net_conf.mtu==0 ){
350                 /*attempt to discover mtu*/
351                 mtu=ms_discover_mtu(remote);
352                 if (mtu>0){
353                         ms_set_mtu(mtu);
354                         ms_message("Discovered mtu is %i, RTP payload max size is %i",
355                                 mtu, ms_get_payload_max_size());
356                 }
357         }
358 }
359
360 LinphoneCall * linphone_call_new_outgoing(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, const LinphoneCallParams *params)
361 {
362         LinphoneCall *call=ms_new0(LinphoneCall,1);
363         int ping_time=-1;
364         call->dir=LinphoneCallOutgoing;
365         call->op=sal_op_new(lc->sal);
366         sal_op_set_user_pointer(call->op,call);
367         call->core=lc;
368         linphone_core_get_local_ip(lc,linphone_address_get_domain(to),call->localip);
369         linphone_call_init_common(call,from,to);
370         call->params=*params;
371         if (linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseIce) {
372                 call->ice_session = ice_session_new();
373                 ice_session_set_role(call->ice_session, IR_Controlling);
374         }
375         if (linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseStun) {
376                 ping_time=linphone_core_run_stun_tests(call->core,call);
377         }
378         if (ping_time>=0) {
379                 linphone_core_adapt_to_network(lc,ping_time,&call->params);
380         }
381         call->camera_active=params->has_video;
382         
383         discover_mtu(lc,linphone_address_get_domain (to));
384         if (params->referer){
385                 sal_call_set_referer(call->op,params->referer->op);
386                 call->referer=linphone_call_ref(params->referer);
387         }
388         return call;
389 }
390
391 LinphoneCall * linphone_call_new_incoming(LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, SalOp *op){
392         LinphoneCall *call=ms_new0(LinphoneCall,1);
393         char *from_str;
394         int ping_time=-1;
395
396         call->dir=LinphoneCallIncoming;
397         sal_op_set_user_pointer(op,call);
398         call->op=op;
399         call->core=lc;
400
401         if (lc->sip_conf.ping_with_options){
402                 /*the following sends an option request back to the caller so that
403                  we get a chance to discover our nat'd address before answering.*/
404                 call->ping_op=sal_op_new(lc->sal);
405                 from_str=linphone_address_as_string_uri_only(from);
406                 sal_op_set_route(call->ping_op,sal_op_get_network_origin(op));
407                 sal_op_set_user_pointer(call->ping_op,call);
408                 sal_ping(call->ping_op,linphone_core_find_best_identity(lc,from,NULL),from_str);
409                 ms_free(from_str);
410         }
411
412         linphone_address_clean(from);
413         linphone_core_get_local_ip(lc,linphone_address_get_domain(from),call->localip);
414         linphone_call_init_common(call, from, to);
415         linphone_core_init_default_params(lc, &call->params);
416         call->params.has_video &= !!lc->video_policy.automatically_accept;
417         switch (linphone_core_get_firewall_policy(call->core)) {
418                 case LinphonePolicyUseIce:
419                         call->ice_session = ice_session_new();
420                         ice_session_set_role(call->ice_session, IR_Controlled);
421                         linphone_core_update_ice_from_remote_media_description(call, sal_call_get_remote_media_description(op));
422                         if (call->ice_session != NULL) {
423                                 linphone_call_init_media_streams(call);
424                                 linphone_call_start_media_streams_for_ice_gathering(call);
425                                 if (linphone_core_gather_ice_candidates(call->core,call)<0) {
426                                         /* Ice candidates gathering failed, proceed with the call anyway. */
427                                         linphone_call_delete_ice_session(call);
428                                         linphone_call_stop_media_streams(call);
429                                 }
430                         }
431                         break;
432                 case LinphonePolicyUseStun:
433                         ping_time=linphone_core_run_stun_tests(call->core,call);
434                         /* No break to also destroy ice session in this case. */
435                 default:
436                         break;
437         }
438         if (ping_time>=0) {
439                 linphone_core_adapt_to_network(lc,ping_time,&call->params);
440         };
441         call->camera_active=call->params.has_video;
442         
443         discover_mtu(lc,linphone_address_get_domain(from));
444         return call;
445 }
446
447 /* this function is called internally to get rid of a call.
448  It performs the following tasks:
449  - remove the call from the internal list of calls
450  - update the call logs accordingly
451 */
452
453 static void linphone_call_set_terminated(LinphoneCall *call){
454         LinphoneCore *lc=call->core;
455
456         linphone_core_update_allocated_audio_bandwidth(lc);
457
458         call->owns_call_log=FALSE;
459         linphone_call_log_completed(call);
460
461
462         if (call == lc->current_call){
463                 ms_message("Resetting the current call");
464                 lc->current_call=NULL;
465         }
466
467         if (linphone_core_del_call(lc,call) != 0){
468                 ms_error("Could not remove the call from the list !!!");
469         }
470
471         if (ms_list_size(lc->calls)==0)
472                 linphone_core_notify_all_friends(lc,lc->presence_mode);
473
474         linphone_core_conference_check_uninit(lc);
475         if (call->ringing_beep){
476                 linphone_core_stop_dtmf(lc);
477                 call->ringing_beep=FALSE;
478         }
479         if (call->referer){
480                 linphone_call_unref(call->referer);
481                 call->referer=NULL;
482         }
483 }
484
485 void linphone_call_fix_call_parameters(LinphoneCall *call){
486         call->params.has_video=call->current_params.has_video;
487         call->params.media_encryption=call->current_params.media_encryption;
488 }
489
490 const char *linphone_call_state_to_string(LinphoneCallState cs){
491         switch (cs){
492                 case LinphoneCallIdle:
493                         return "LinphoneCallIdle";
494                 case LinphoneCallIncomingReceived:
495                         return "LinphoneCallIncomingReceived";
496                 case LinphoneCallOutgoingInit:
497                         return "LinphoneCallOutgoingInit";
498                 case LinphoneCallOutgoingProgress:
499                         return "LinphoneCallOutgoingProgress";
500                 case LinphoneCallOutgoingRinging:
501                         return "LinphoneCallOutgoingRinging";
502                 case LinphoneCallOutgoingEarlyMedia:
503                         return "LinphoneCallOutgoingEarlyMedia";
504                 case LinphoneCallConnected:
505                         return "LinphoneCallConnected";
506                 case LinphoneCallStreamsRunning:
507                         return "LinphoneCallStreamsRunning";
508                 case LinphoneCallPausing:
509                         return "LinphoneCallPausing";
510                 case LinphoneCallPaused:
511                         return "LinphoneCallPaused";
512                 case LinphoneCallResuming:
513                         return "LinphoneCallResuming";
514                 case LinphoneCallRefered:
515                         return "LinphoneCallRefered";
516                 case LinphoneCallError:
517                         return "LinphoneCallError";
518                 case LinphoneCallEnd:
519                         return "LinphoneCallEnd";
520                 case LinphoneCallPausedByRemote:
521                         return "LinphoneCallPausedByRemote";
522                 case LinphoneCallUpdatedByRemote:
523                         return "LinphoneCallUpdatedByRemote";
524                 case LinphoneCallIncomingEarlyMedia:
525                         return "LinphoneCallIncomingEarlyMedia";
526                 case LinphoneCallUpdated:
527                         return "LinphoneCallUpdated";
528                 case LinphoneCallReleased:
529                         return "LinphoneCallReleased";
530         }
531         return "undefined state";
532 }
533
534 void linphone_call_set_state(LinphoneCall *call, LinphoneCallState cstate, const char *message){
535         LinphoneCore *lc=call->core;
536
537         if (call->state!=cstate){
538                 if (call->state==LinphoneCallEnd || call->state==LinphoneCallError){
539                         if (cstate!=LinphoneCallReleased){
540                                 ms_warning("Spurious call state change from %s to %s, ignored.",linphone_call_state_to_string(call->state),
541                                    linphone_call_state_to_string(cstate));
542                                 return;
543                         }
544                 }
545                 ms_message("Call %p: moving from state %s to %s",call,linphone_call_state_to_string(call->state),
546                            linphone_call_state_to_string(cstate));
547                 if (cstate!=LinphoneCallRefered){
548                         /*LinphoneCallRefered is rather an event, not a state.
549                          Indeed it does not change the state of the call (still paused or running)*/
550                         call->state=cstate;
551                 }
552                 if (cstate==LinphoneCallEnd || cstate==LinphoneCallError){
553                         switch(call->reason){
554                                 case LinphoneReasonDeclined:
555                                         call->log->status=LinphoneCallDeclined;
556                                         break;
557                                 case LinphoneReasonNotAnswered:
558                                         call->log->status=LinphoneCallMissed;
559                                 break;
560                                 default:
561                                 break;
562                         }
563                         linphone_call_set_terminated (call);
564                 }
565                 if (cstate == LinphoneCallConnected) {
566                         call->log->status=LinphoneCallSuccess;
567                         call->media_start_time=time(NULL);
568                 }
569
570                 if (lc->vtable.call_state_changed)
571                         lc->vtable.call_state_changed(lc,call,cstate,message);
572                 if (cstate==LinphoneCallReleased){
573                         if (call->op!=NULL) {
574                                 /* so that we cannot have anymore upcalls for SAL
575                                  concerning this call*/
576                                 sal_op_release(call->op);
577                                 call->op=NULL;
578                         }
579                         linphone_call_unref(call);
580                 }
581         }
582 }
583
584 static void linphone_call_destroy(LinphoneCall *obj)
585 {
586         if (obj->op!=NULL) {
587                 sal_op_release(obj->op);
588                 obj->op=NULL;
589         }
590         if (obj->resultdesc!=NULL) {
591                 sal_media_description_unref(obj->resultdesc);
592                 obj->resultdesc=NULL;
593         }
594         if (obj->localdesc!=NULL) {
595                 sal_media_description_unref(obj->localdesc);
596                 obj->localdesc=NULL;
597         }
598         if (obj->ping_op) {
599                 sal_op_release(obj->ping_op);
600         }
601         if (obj->refer_to){
602                 ms_free(obj->refer_to);
603         }
604         if (obj->owns_call_log)
605                 linphone_call_log_destroy(obj->log);
606         if (obj->auth_token) {
607                 ms_free(obj->auth_token);
608         }
609         if (obj->ice_session) {
610                 ice_session_destroy(obj->ice_session);
611         }
612
613         ms_free(obj);
614 }
615
616 /**
617  * @addtogroup call_control
618  * @{
619 **/
620
621 /**
622  * Increments the call 's reference count.
623  * An application that wishes to retain a pointer to call object
624  * must use this function to unsure the pointer remains
625  * valid. Once the application no more needs this pointer,
626  * it must call linphone_call_unref().
627 **/
628 LinphoneCall * linphone_call_ref(LinphoneCall *obj){
629         obj->refcnt++;
630         return obj;
631 }
632
633 /**
634  * Decrements the call object reference count.
635  * See linphone_call_ref().
636 **/
637 void linphone_call_unref(LinphoneCall *obj){
638         obj->refcnt--;
639         if (obj->refcnt==0){
640                 linphone_call_destroy(obj);
641         }
642 }
643
644 /**
645  * Returns current parameters associated to the call.
646 **/
647 const LinphoneCallParams * linphone_call_get_current_params(const LinphoneCall *call){
648         return &call->current_params;
649 }
650
651 static bool_t is_video_active(const SalStreamDescription *sd){
652         return sd->rtp_port!=0 && sd->dir!=SalStreamInactive;
653 }
654
655 /**
656  * Returns call parameters proposed by remote.
657  * 
658  * This is useful when receiving an incoming call, to know whether the remote party
659  * supports video, encryption or whatever.
660 **/
661 const LinphoneCallParams * linphone_call_get_remote_params(LinphoneCall *call){
662         LinphoneCallParams *cp=&call->remote_params;
663         memset(cp,0,sizeof(*cp));
664         if (call->op){
665                 SalMediaDescription *md=sal_call_get_remote_media_description(call->op);
666                 if (md){
667                         SalStreamDescription *asd,*vsd,*secure_asd,*secure_vsd;
668
669                         asd=sal_media_description_find_stream(md,SalProtoRtpAvp,SalAudio);
670                         vsd=sal_media_description_find_stream(md,SalProtoRtpAvp,SalVideo);
671                         secure_asd=sal_media_description_find_stream(md,SalProtoRtpSavp,SalAudio);
672                         secure_vsd=sal_media_description_find_stream(md,SalProtoRtpSavp,SalVideo);
673                         if (secure_vsd){
674                                 cp->has_video=is_video_active(secure_vsd);
675                                 if (secure_asd || asd==NULL)
676                                         cp->media_encryption=LinphoneMediaEncryptionSRTP;
677                         }else if (vsd){
678                                 cp->has_video=is_video_active(vsd);
679                         }
680                         return cp;
681                 }
682         }
683         return NULL;
684 }
685
686 /**
687  * Returns the remote address associated to this call
688  *
689 **/
690 const LinphoneAddress * linphone_call_get_remote_address(const LinphoneCall *call){
691         return call->dir==LinphoneCallIncoming ? call->log->from : call->log->to;
692 }
693
694 /**
695  * Returns the remote address associated to this call as a string.
696  *
697  * The result string must be freed by user using ms_free().
698 **/
699 char *linphone_call_get_remote_address_as_string(const LinphoneCall *call){
700         return linphone_address_as_string(linphone_call_get_remote_address(call));
701 }
702
703 /**
704  * Retrieves the call's current state.
705 **/
706 LinphoneCallState linphone_call_get_state(const LinphoneCall *call){
707         return call->state;
708 }
709
710 /**
711  * Returns the reason for a call termination (either error or normal termination)
712 **/
713 LinphoneReason linphone_call_get_reason(const LinphoneCall *call){
714         return call->reason;
715 }
716
717 /**
718  * Get the user_pointer in the LinphoneCall
719  *
720  * @ingroup call_control
721  *
722  * return user_pointer an opaque user pointer that can be retrieved at any time
723 **/
724 void *linphone_call_get_user_pointer(LinphoneCall *call)
725 {
726         return call->user_pointer;
727 }
728
729 /**
730  * Set the user_pointer in the LinphoneCall
731  *
732  * @ingroup call_control
733  *
734  * the user_pointer is an opaque user pointer that can be retrieved at any time in the LinphoneCall
735 **/
736 void linphone_call_set_user_pointer(LinphoneCall *call, void *user_pointer)
737 {
738         call->user_pointer = user_pointer;
739 }
740
741 /**
742  * Returns the call log associated to this call.
743 **/
744 LinphoneCallLog *linphone_call_get_call_log(const LinphoneCall *call){
745         return call->log;
746 }
747
748 /**
749  * Returns the refer-to uri (if the call was transfered).
750 **/
751 const char *linphone_call_get_refer_to(const LinphoneCall *call){
752         return call->refer_to;
753 }
754
755 /**
756  * Returns direction of the call (incoming or outgoing).
757 **/
758 LinphoneCallDir linphone_call_get_dir(const LinphoneCall *call){
759         return call->log->dir;
760 }
761
762 /**
763  * Returns the far end's user agent description string, if available.
764 **/
765 const char *linphone_call_get_remote_user_agent(LinphoneCall *call){
766         if (call->op){
767                 return sal_op_get_remote_ua (call->op);
768         }
769         return NULL;
770 }
771
772 /**
773  * Returns true if this calls has received a transfer that has not been
774  * executed yet.
775  * Pending transfers are executed when this call is being paused or closed,
776  * locally or by remote endpoint.
777  * If the call is already paused while receiving the transfer request, the
778  * transfer immediately occurs.
779 **/
780 bool_t linphone_call_has_transfer_pending(const LinphoneCall *call){
781         return call->refer_pending;
782 }
783
784 /**
785  * Returns call's duration in seconds.
786 **/
787 int linphone_call_get_duration(const LinphoneCall *call){
788         if (call->media_start_time==0) return 0;
789         return time(NULL)-call->media_start_time;
790 }
791
792 /**
793  * Returns the call object this call is replacing, if any.
794  * Call replacement can occur during call transfers.
795  * By default, the core automatically terminates the replaced call and accept the new one.
796  * This function allows the application to know whether a new incoming call is a one that replaces another one.
797 **/
798 LinphoneCall *linphone_call_get_replaced_call(LinphoneCall *call){
799         SalOp *op=sal_call_get_replaces(call->op);
800         if (op){
801                 return (LinphoneCall*)sal_op_get_user_pointer(op);
802         }
803         return NULL;
804 }
805
806 /**
807  * Indicate whether camera input should be sent to remote end.
808 **/
809 void linphone_call_enable_camera (LinphoneCall *call, bool_t enable){
810 #ifdef VIDEO_ENABLED
811         if (call->videostream!=NULL && call->videostream->ticker!=NULL){
812                 LinphoneCore *lc=call->core;
813                 MSWebCam *nowebcam=get_nowebcam_device();
814                 if (call->camera_active!=enable && lc->video_conf.device!=nowebcam){
815                         video_stream_change_camera(call->videostream,
816                                      enable ? lc->video_conf.device : nowebcam);
817                 }
818         }
819         call->camera_active=enable;
820 #endif
821 }
822
823 /**
824  * Take a photo of currently received video and write it into a jpeg file.
825 **/
826 int linphone_call_take_video_snapshot(LinphoneCall *call, const char *file){
827 #ifdef VIDEO_ENABLED
828         if (call->videostream!=NULL && call->videostream->jpegwriter!=NULL){
829                 return ms_filter_call_method(call->videostream->jpegwriter,MS_JPEG_WRITER_TAKE_SNAPSHOT,(void*)file);
830         }
831         ms_warning("Cannot take snapshot: no currently running video stream on this call.");
832         return -1;
833 #endif
834         return -1;
835 }
836
837 /**
838  * Returns TRUE if camera pictures are sent to the remote party.
839 **/
840 bool_t linphone_call_camera_enabled (const LinphoneCall *call){
841         return call->camera_active;
842 }
843
844 /**
845  * Enable video stream.
846 **/
847 void linphone_call_params_enable_video(LinphoneCallParams *cp, bool_t enabled){
848         cp->has_video=enabled;
849 }
850
851 const PayloadType* linphone_call_params_get_used_audio_codec(const LinphoneCallParams *cp) {
852         return cp->audio_codec;
853 }
854
855 const PayloadType* linphone_call_params_get_used_video_codec(const LinphoneCallParams *cp) {
856         return cp->video_codec;
857 }
858
859 /**
860  * Returns whether video is enabled.
861 **/
862 bool_t linphone_call_params_video_enabled(const LinphoneCallParams *cp){
863         return cp->has_video;
864 }
865
866 enum LinphoneMediaEncryption linphone_call_params_get_media_encryption(const LinphoneCallParams *cp) {
867         return cp->media_encryption;
868 }
869
870 void linphone_call_params_set_media_encryption(LinphoneCallParams *cp, enum LinphoneMediaEncryption e) {
871         cp->media_encryption = e;
872 }
873
874
875 /**
876  * Enable sending of real early media (during outgoing calls).
877 **/
878 void linphone_call_params_enable_early_media_sending(LinphoneCallParams *cp, bool_t enabled){
879         cp->real_early_media=enabled;
880 }
881
882 bool_t linphone_call_params_early_media_sending_enabled(const LinphoneCallParams *cp){
883         return cp->real_early_media;
884 }
885
886 /**
887  * Returns true if the call is part of the locally managed conference.
888 **/
889 bool_t linphone_call_params_local_conference_mode(const LinphoneCallParams *cp){
890         return cp->in_conference;
891 }
892
893 /**
894  * Refine bandwidth settings for this call by setting a bandwidth limit for audio streams.
895  * As a consequence, codecs whose bitrates are not compatible with this limit won't be used.
896 **/
897 void linphone_call_params_set_audio_bandwidth_limit(LinphoneCallParams *cp, int bandwidth){
898         cp->audio_bw=bandwidth;
899 }
900
901 #ifdef VIDEO_ENABLED
902 /**
903  * Request remote side to send us a Video Fast Update.
904 **/
905 void linphone_call_send_vfu_request(LinphoneCall *call)
906 {
907         if (LinphoneCallStreamsRunning == linphone_call_get_state(call))
908                 sal_call_send_vfu_request(call->op);
909 }
910 #endif
911
912 /**
913  *
914 **/
915 LinphoneCallParams * linphone_call_params_copy(const LinphoneCallParams *cp){
916         LinphoneCallParams *ncp=ms_new0(LinphoneCallParams,1);
917         memcpy(ncp,cp,sizeof(LinphoneCallParams));
918         return ncp;
919 }
920
921 /**
922  *
923 **/
924 void linphone_call_params_destroy(LinphoneCallParams *p){
925         ms_free(p);
926 }
927
928 /**
929  * @}
930 **/
931
932
933 #ifdef TEST_EXT_RENDERER
934 static void rendercb(void *data, const MSPicture *local, const MSPicture *remote){
935         ms_message("rendercb, local buffer=%p, remote buffer=%p",
936                    local ? local->planes[0] : NULL, remote? remote->planes[0] : NULL);
937 }
938 #endif
939
940 #ifdef VIDEO_ENABLED
941 static void video_stream_event_cb(void *user_pointer, const MSFilter *f, const unsigned int event_id, const void *args){
942     LinphoneCall* call = (LinphoneCall*) user_pointer;
943         ms_warning("In linphonecall.c: video_stream_event_cb");
944         switch (event_id) {
945                 case MS_VIDEO_DECODER_DECODING_ERRORS:
946                         ms_warning("Case is MS_VIDEO_DECODER_DECODING_ERRORS");
947                         linphone_call_send_vfu_request(call);
948                         break;
949         case MS_VIDEO_DECODER_FIRST_IMAGE_DECODED:
950             ms_message("First video frame decoded successfully");
951             if (call->nextVideoFrameDecoded._func != NULL)
952                 call->nextVideoFrameDecoded._func(call, call->nextVideoFrameDecoded._user_data);
953             break;
954                 default:
955                         ms_warning("Unhandled event %i", event_id);
956                         break;
957         }
958 }
959 #endif
960
961 void linphone_call_set_next_video_frame_decoded_callback(LinphoneCall *call, LinphoneCallCbFunc cb, void* user_data) {
962     call->nextVideoFrameDecoded._func = cb;
963     call->nextVideoFrameDecoded._user_data = user_data;
964 #ifdef VIDEO_ENABLED
965     ms_filter_call_method_noarg(call->videostream->decoder, MS_VIDEO_DECODER_RESET_FIRST_IMAGE_NOTIFICATION);
966 #endif
967 }
968
969 void linphone_call_init_audio_stream(LinphoneCall *call){
970         LinphoneCore *lc=call->core;
971         AudioStream *audiostream;
972         int dscp=linphone_core_get_audio_dscp(lc);
973
974         call->audiostream=audiostream=audio_stream_new(call->audio_port,call->audio_port+1,linphone_core_ipv6_enabled(lc));
975         if (dscp!=-1)
976                 audio_stream_set_dscp(audiostream,dscp);
977         if (linphone_core_echo_limiter_enabled(lc)){
978                 const char *type=lp_config_get_string(lc->config,"sound","el_type","mic");
979                 if (strcasecmp(type,"mic")==0)
980                         audio_stream_enable_echo_limiter(audiostream,ELControlMic);
981                 else if (strcasecmp(type,"full")==0)
982                         audio_stream_enable_echo_limiter(audiostream,ELControlFull);
983         }
984         audio_stream_enable_gain_control(audiostream,TRUE);
985         if (linphone_core_echo_cancellation_enabled(lc)){
986                 int len,delay,framesize;
987                 const char *statestr=lp_config_get_string(lc->config,"sound","ec_state",NULL);
988                 len=lp_config_get_int(lc->config,"sound","ec_tail_len",0);
989                 delay=lp_config_get_int(lc->config,"sound","ec_delay",0);
990                 framesize=lp_config_get_int(lc->config,"sound","ec_framesize",0);
991                 audio_stream_set_echo_canceller_params(audiostream,len,delay,framesize);
992                 if (statestr && audiostream->ec){
993                         ms_filter_call_method(audiostream->ec,MS_ECHO_CANCELLER_SET_STATE_STRING,(void*)statestr);
994                 }
995         }
996         audio_stream_enable_automatic_gain_control(audiostream,linphone_core_agc_enabled(lc));
997         {
998                 int enabled=lp_config_get_int(lc->config,"sound","noisegate",0);
999                 audio_stream_enable_noise_gate(audiostream,enabled);
1000         }
1001
1002         audio_stream_set_features(audiostream,linphone_core_get_audio_features(lc));
1003
1004         if (lc->rtptf){
1005                 RtpTransport *artp=lc->rtptf->audio_rtp_func(lc->rtptf->audio_rtp_func_data, call->audio_port);
1006                 RtpTransport *artcp=lc->rtptf->audio_rtcp_func(lc->rtptf->audio_rtcp_func_data, call->audio_port+1);
1007                 rtp_session_set_transports(audiostream->session,artp,artcp);
1008         }
1009         if ((linphone_core_get_firewall_policy(lc) == LinphonePolicyUseIce) && (call->ice_session != NULL)){
1010                 rtp_session_set_pktinfo(audiostream->session, TRUE);
1011                 rtp_session_set_symmetric_rtp(audiostream->session, FALSE);
1012                 if (ice_session_check_list(call->ice_session, 0) == NULL) {
1013                         ice_session_add_check_list(call->ice_session, ice_check_list_new());
1014                 }
1015                 audiostream->ice_check_list = ice_session_check_list(call->ice_session, 0);
1016                 ice_check_list_set_rtp_session(audiostream->ice_check_list, audiostream->session);
1017         }
1018
1019         call->audiostream_app_evq = ortp_ev_queue_new();
1020         rtp_session_register_event_queue(audiostream->session,call->audiostream_app_evq);
1021 }
1022
1023 void linphone_call_init_video_stream(LinphoneCall *call){
1024 #ifdef VIDEO_ENABLED
1025         LinphoneCore *lc=call->core;
1026
1027         if ((lc->video_conf.display || lc->video_conf.capture) && call->params.has_video){
1028                 int video_recv_buf_size=lp_config_get_int(lc->config,"video","recv_buf_size",0);
1029                 int dscp=linphone_core_get_video_dscp(lc);
1030                 
1031                 call->videostream=video_stream_new(call->video_port,call->video_port+1,linphone_core_ipv6_enabled(lc));
1032                 if (dscp!=-1)
1033                         video_stream_set_dscp(call->videostream,dscp);
1034                 video_stream_enable_display_filter_auto_rotate(call->videostream, lp_config_get_int(lc->config,"video","display_filter_auto_rotate",0));
1035                 if (video_recv_buf_size>0) rtp_session_set_recv_buf_size(call->videostream->session,video_recv_buf_size);
1036
1037                 if( lc->video_conf.displaytype != NULL)
1038                         video_stream_set_display_filter_name(call->videostream,lc->video_conf.displaytype);
1039                 video_stream_set_event_callback(call->videostream,video_stream_event_cb, call);
1040                 if (lc->rtptf){
1041                         RtpTransport *vrtp=lc->rtptf->video_rtp_func(lc->rtptf->video_rtp_func_data, call->video_port);
1042                         RtpTransport *vrtcp=lc->rtptf->video_rtcp_func(lc->rtptf->video_rtcp_func_data, call->video_port+1);
1043                         rtp_session_set_transports(call->videostream->session,vrtp,vrtcp);
1044                 }
1045                 if ((linphone_core_get_firewall_policy(lc) == LinphonePolicyUseIce) && (call->ice_session != NULL) && (ice_session_check_list(call->ice_session, 1))){
1046                         rtp_session_set_pktinfo(call->videostream->session, TRUE);
1047                         rtp_session_set_symmetric_rtp(call->videostream->session, FALSE);
1048                         if (ice_session_check_list(call->ice_session, 1) == NULL) {
1049                                 ice_session_add_check_list(call->ice_session, ice_check_list_new());
1050                         }
1051                         call->videostream->ice_check_list = ice_session_check_list(call->ice_session, 1);
1052                         ice_check_list_set_rtp_session(call->videostream->ice_check_list, call->videostream->session);
1053                 }
1054                 call->videostream_app_evq = ortp_ev_queue_new();
1055                 rtp_session_register_event_queue(call->videostream->session,call->videostream_app_evq);
1056 #ifdef TEST_EXT_RENDERER
1057                 video_stream_set_render_callback(call->videostream,rendercb,NULL);
1058 #endif
1059         }
1060 #else
1061         call->videostream=NULL;
1062 #endif
1063 }
1064
1065 void linphone_call_init_media_streams(LinphoneCall *call){
1066         linphone_call_init_audio_stream(call);
1067         linphone_call_init_video_stream(call);
1068 }
1069
1070
1071 static int dtmf_tab[16]={'0','1','2','3','4','5','6','7','8','9','*','#','A','B','C','D'};
1072
1073 static void linphone_core_dtmf_received(RtpSession* s, int dtmf, void* user_data){
1074         LinphoneCore* lc = (LinphoneCore*)user_data;
1075         if (dtmf<0 || dtmf>15){
1076                 ms_warning("Bad dtmf value %i",dtmf);
1077                 return;
1078         }
1079         if (lc->vtable.dtmf_received != NULL)
1080                 lc->vtable.dtmf_received(lc, linphone_core_get_current_call(lc), dtmf_tab[dtmf]);
1081 }
1082
1083 static void parametrize_equalizer(LinphoneCore *lc, AudioStream *st){
1084         if (st->equalizer){
1085                 MSFilter *f=st->equalizer;
1086                 int enabled=lp_config_get_int(lc->config,"sound","eq_active",0);
1087                 const char *gains=lp_config_get_string(lc->config,"sound","eq_gains",NULL);
1088                 ms_filter_call_method(f,MS_EQUALIZER_SET_ACTIVE,&enabled);
1089                 if (enabled){
1090                         if (gains){
1091                                 do{
1092                                         int bytes;
1093                                         MSEqualizerGain g;
1094                                         if (sscanf(gains,"%f:%f:%f %n",&g.frequency,&g.gain,&g.width,&bytes)==3){
1095                                                 ms_message("Read equalizer gains: %f(~%f) --> %f",g.frequency,g.width,g.gain);
1096                                                 ms_filter_call_method(f,MS_EQUALIZER_SET_GAIN,&g);
1097                                                 gains+=bytes;
1098                                         }else break;
1099                                 }while(1);
1100                         }
1101                 }
1102         }
1103 }
1104
1105 void _post_configure_audio_stream(AudioStream *st, LinphoneCore *lc, bool_t muted){
1106         float mic_gain=lp_config_get_float(lc->config,"sound","mic_gain",1);
1107         float thres = 0;
1108         float recv_gain;
1109         float ng_thres=lp_config_get_float(lc->config,"sound","ng_thres",0.05);
1110         float ng_floorgain=lp_config_get_float(lc->config,"sound","ng_floorgain",0);
1111         int dc_removal=lp_config_get_int(lc->config,"sound","dc_removal",0);
1112
1113         if (!muted)
1114                 audio_stream_set_mic_gain(st,mic_gain);
1115         else
1116                 audio_stream_set_mic_gain(st,0);
1117
1118         recv_gain = lc->sound_conf.soft_play_lev;
1119         if (recv_gain != 0) {
1120                 linphone_core_set_playback_gain_db (lc,recv_gain);
1121         }
1122         
1123         if (st->volsend){
1124                 ms_filter_call_method(st->volsend,MS_VOLUME_REMOVE_DC,&dc_removal);
1125                 float speed=lp_config_get_float(lc->config,"sound","el_speed",-1);
1126                 thres=lp_config_get_float(lc->config,"sound","el_thres",-1);
1127                 float force=lp_config_get_float(lc->config,"sound","el_force",-1);
1128                 int sustain=lp_config_get_int(lc->config,"sound","el_sustain",-1);
1129                 float transmit_thres=lp_config_get_float(lc->config,"sound","el_transmit_thres",-1);
1130                 MSFilter *f=NULL;
1131                 f=st->volsend;
1132                 if (speed==-1) speed=0.03;
1133                 if (force==-1) force=25;
1134                 ms_filter_call_method(f,MS_VOLUME_SET_EA_SPEED,&speed);
1135                 ms_filter_call_method(f,MS_VOLUME_SET_EA_FORCE,&force);
1136                 if (thres!=-1)
1137                         ms_filter_call_method(f,MS_VOLUME_SET_EA_THRESHOLD,&thres);
1138                 if (sustain!=-1)
1139                         ms_filter_call_method(f,MS_VOLUME_SET_EA_SUSTAIN,&sustain);
1140                 if (transmit_thres!=-1)
1141                                 ms_filter_call_method(f,MS_VOLUME_SET_EA_TRANSMIT_THRESHOLD,&transmit_thres);
1142
1143                 ms_filter_call_method(st->volsend,MS_VOLUME_SET_NOISE_GATE_THRESHOLD,&ng_thres);
1144                 ms_filter_call_method(st->volsend,MS_VOLUME_SET_NOISE_GATE_FLOORGAIN,&ng_floorgain);
1145         }
1146         if (st->volrecv){
1147                 /* parameters for a limited noise-gate effect, using echo limiter threshold */
1148                 float floorgain = 1/mic_gain;
1149                 int spk_agc=lp_config_get_int(lc->config,"sound","speaker_agc_enabled",0);
1150                 ms_filter_call_method(st->volrecv, MS_VOLUME_ENABLE_AGC, &spk_agc);
1151                 ms_filter_call_method(st->volrecv,MS_VOLUME_SET_NOISE_GATE_THRESHOLD,&ng_thres);
1152                 ms_filter_call_method(st->volrecv,MS_VOLUME_SET_NOISE_GATE_FLOORGAIN,&floorgain);
1153         }
1154         parametrize_equalizer(lc,st);
1155 }
1156
1157 static void post_configure_audio_streams(LinphoneCall*call){
1158         AudioStream *st=call->audiostream;
1159         LinphoneCore *lc=call->core;
1160         _post_configure_audio_stream(st,lc,call->audio_muted);
1161         if (lc->vtable.dtmf_received!=NULL){
1162                 /* replace by our default action*/
1163                 audio_stream_play_received_dtmfs(call->audiostream,FALSE);
1164                 rtp_session_signal_connect(call->audiostream->session,"telephone-event",(RtpCallback)linphone_core_dtmf_received,(unsigned long)lc);
1165         }
1166 }
1167
1168 static RtpProfile *make_profile(LinphoneCall *call, const SalMediaDescription *md, const SalStreamDescription *desc, int *used_pt){
1169         int bw;
1170         const MSList *elem;
1171         RtpProfile *prof=rtp_profile_new("Call profile");
1172         bool_t first=TRUE;
1173         int remote_bw=0;
1174         LinphoneCore *lc=call->core;
1175         int up_ptime=0;
1176         const LinphoneCallParams *params=&call->params;
1177         *used_pt=-1;
1178
1179         for(elem=desc->payloads;elem!=NULL;elem=elem->next){
1180                 PayloadType *pt=(PayloadType*)elem->data;
1181                 int number;
1182
1183                 if ((pt->flags & PAYLOAD_TYPE_FLAG_CAN_SEND) && first) {
1184                         if (desc->type==SalAudio){
1185                                 linphone_core_update_allocated_audio_bandwidth_in_call(call,pt);
1186                                 if (params->up_ptime)
1187                                         up_ptime=params->up_ptime;
1188                                 else up_ptime=linphone_core_get_upload_ptime(lc);
1189                         }
1190                         *used_pt=payload_type_get_number(pt);
1191                         first=FALSE;
1192                 }
1193                 if (desc->bandwidth>0) remote_bw=desc->bandwidth;
1194                 else if (md->bandwidth>0) {
1195                         /*case where b=AS is given globally, not per stream*/
1196                         remote_bw=md->bandwidth;
1197                         if (desc->type==SalVideo){
1198                                 remote_bw=get_video_bandwidth(remote_bw,call->audio_bw);
1199                         }
1200                 }
1201
1202                 if (desc->type==SalAudio){
1203                         int audio_bw=call->audio_bw;
1204                         if (params->up_bw){
1205                                 if (params->up_bw< audio_bw)
1206                                         audio_bw=params->up_bw;
1207                         }
1208                         bw=get_min_bandwidth(audio_bw,remote_bw);
1209                 }else bw=get_min_bandwidth(get_video_bandwidth(linphone_core_get_upload_bandwidth (lc),call->audio_bw),remote_bw);
1210                 if (bw>0) pt->normal_bitrate=bw*1000;
1211                 else if (desc->type==SalAudio){
1212                         pt->normal_bitrate=-1;
1213                 }
1214                 if (desc->ptime>0){
1215                         up_ptime=desc->ptime;
1216                 }
1217                 if (up_ptime>0){
1218                         char tmp[40];
1219                         snprintf(tmp,sizeof(tmp),"ptime=%i",up_ptime);
1220                         payload_type_append_send_fmtp(pt,tmp);
1221                 }
1222                 number=payload_type_get_number(pt);
1223                 if (rtp_profile_get_payload(prof,number)!=NULL){
1224                         ms_warning("A payload type with number %i already exists in profile !",number);
1225                 }else
1226                         rtp_profile_set_payload(prof,number,pt);
1227         }
1228         return prof;
1229 }
1230
1231
1232 static void setup_ring_player(LinphoneCore *lc, LinphoneCall *call){
1233         int pause_time=3000;
1234         audio_stream_play(call->audiostream,lc->sound_conf.ringback_tone);
1235         ms_filter_call_method(call->audiostream->soundread,MS_FILE_PLAYER_LOOP,&pause_time);
1236 }
1237
1238 #define LINPHONE_RTCP_SDES_TOOL "Linphone-" LINPHONE_VERSION
1239
1240 static bool_t linphone_call_sound_resources_available(LinphoneCall *call){
1241         LinphoneCore *lc=call->core;
1242         LinphoneCall *current=linphone_core_get_current_call(lc);
1243         return !linphone_core_is_in_conference(lc) && 
1244                 (current==NULL || current==call);
1245 }
1246 static int find_crypto_index_from_tag(const SalSrtpCryptoAlgo crypto[],unsigned char tag) {
1247     int i;
1248     for(i=0; i<SAL_CRYPTO_ALGO_MAX; i++) {
1249         if (crypto[i].tag == tag) {
1250             return i;
1251         }
1252     }
1253     return -1;
1254 }
1255 static void linphone_call_start_audio_stream(LinphoneCall *call, const char *cname, bool_t muted, bool_t send_ringbacktone, bool_t use_arc){
1256         LinphoneCore *lc=call->core;
1257         int used_pt=-1;
1258         /* look for savp stream first */
1259         const SalStreamDescription *stream=sal_media_description_find_stream(call->resultdesc,
1260                                                 SalProtoRtpSavp,SalAudio);
1261         /* no savp audio stream, use avp */
1262         if (!stream)
1263                 stream=sal_media_description_find_stream(call->resultdesc,
1264                                                 SalProtoRtpAvp,SalAudio);
1265
1266         if (stream && stream->dir!=SalStreamInactive && stream->rtp_port!=0){
1267                 MSSndCard *playcard=lc->sound_conf.lsd_card ?
1268                         lc->sound_conf.lsd_card : lc->sound_conf.play_sndcard;
1269                 MSSndCard *captcard=lc->sound_conf.capt_sndcard;
1270                 const char *playfile=lc->play_file;
1271                 const char *recfile=lc->rec_file;
1272                 call->audio_profile=make_profile(call,call->resultdesc,stream,&used_pt);
1273                 bool_t use_ec;
1274
1275                 if (used_pt!=-1){
1276                         call->current_params.audio_codec = rtp_profile_get_payload(call->audio_profile, used_pt);
1277                         if (playcard==NULL) {
1278                                 ms_warning("No card defined for playback !");
1279                         }
1280                         if (captcard==NULL) {
1281                                 ms_warning("No card defined for capture !");
1282                         }
1283                         /*Replace soundcard filters by inactive file players or recorders
1284                          when placed in recvonly or sendonly mode*/
1285                         if (stream->rtp_port==0 || stream->dir==SalStreamRecvOnly){
1286                                 captcard=NULL;
1287                                 playfile=NULL;
1288                         }else if (stream->dir==SalStreamSendOnly){
1289                                 playcard=NULL;
1290                                 captcard=NULL;
1291                                 recfile=NULL;
1292                                 /*And we will eventually play "playfile" if set by the user*/
1293                                 /*playfile=NULL;*/
1294                         }
1295                         if (send_ringbacktone){
1296                                 captcard=NULL;
1297                                 playfile=NULL;/* it is setup later*/
1298                         }
1299                         /*if playfile are supplied don't use soundcards*/
1300                         if (lc->use_files) {
1301                                 captcard=NULL;
1302                                 playcard=NULL;
1303                         }
1304                         if (call->params.in_conference){
1305                                 /* first create the graph without soundcard resources*/
1306                                 captcard=playcard=NULL;
1307                         }
1308                         if (!linphone_call_sound_resources_available(call)){
1309                                 ms_message("Sound resources are used by another call, not using soundcard.");
1310                                 captcard=playcard=NULL;
1311                         }
1312                         use_ec=captcard==NULL ? FALSE : linphone_core_echo_cancellation_enabled(lc);
1313                         if (playcard &&  stream->max_rate>0) ms_snd_card_set_preferred_sample_rate(playcard, stream->max_rate);
1314                         if (captcard &&  stream->max_rate>0) ms_snd_card_set_preferred_sample_rate(captcard, stream->max_rate);
1315                         audio_stream_enable_adaptive_bitrate_control(call->audiostream,use_arc);
1316                         audio_stream_enable_adaptive_jittcomp(call->audiostream, linphone_core_audio_adaptive_jittcomp_enabled(lc));
1317                         audio_stream_start_full(
1318                                 call->audiostream,
1319                                 call->audio_profile,
1320                                 stream->rtp_addr[0]!='\0' ? stream->rtp_addr : call->resultdesc->addr,
1321                                 stream->rtp_port,
1322                                 stream->rtcp_addr[0]!='\0' ? stream->rtcp_addr : call->resultdesc->addr,
1323                                 linphone_core_rtcp_enabled(lc) ? (stream->rtcp_port) : 0,
1324                                 used_pt,
1325                                 linphone_core_get_audio_jittcomp(lc),
1326                                 playfile,
1327                                 recfile,
1328                                 playcard,
1329                                 captcard,
1330                                 use_ec
1331                                 );
1332                         post_configure_audio_streams(call);
1333                         if (muted && !send_ringbacktone){
1334                                 audio_stream_set_mic_gain(call->audiostream,0);
1335                         }
1336                         if (stream->dir==SalStreamSendOnly && playfile!=NULL){
1337                                 int pause_time=500;
1338                                 ms_filter_call_method(call->audiostream->soundread,MS_FILE_PLAYER_LOOP,&pause_time);
1339                         }
1340                         if (send_ringbacktone){
1341                                 setup_ring_player(lc,call);
1342                         }
1343                         audio_stream_set_rtcp_information(call->audiostream, cname, LINPHONE_RTCP_SDES_TOOL);
1344                         
1345             /* valid local tags are > 0 */
1346                         if (stream->proto == SalProtoRtpSavp) {
1347                 const SalStreamDescription *local_st_desc=sal_media_description_find_stream(call->localdesc,
1348                                                                                             SalProtoRtpSavp,SalAudio);
1349                 int crypto_idx = find_crypto_index_from_tag(local_st_desc->crypto, stream->crypto_local_tag);
1350                 
1351                 if (crypto_idx >= 0) {
1352                     audio_stream_enable_strp(
1353                                              call->audiostream, 
1354                                              stream->crypto[0].algo,
1355                                              local_st_desc->crypto[crypto_idx].master_key,
1356                                              stream->crypto[0].master_key);
1357                     call->audiostream_encrypted=TRUE;
1358                 } else {
1359                     ms_warning("Failed to find local crypto algo with tag: %d", stream->crypto_local_tag);
1360                     call->audiostream_encrypted=FALSE;
1361                 }
1362                         }else call->audiostream_encrypted=FALSE;
1363                         if (call->params.in_conference){
1364                                 /*transform the graph to connect it to the conference filter */
1365                                 bool_t mute=stream->dir==SalStreamRecvOnly;
1366                                 linphone_call_add_to_conf(call, mute);
1367                         }
1368                         call->current_params.in_conference=call->params.in_conference;
1369                 }else ms_warning("No audio stream accepted ?");
1370         }
1371 }
1372
1373 static void linphone_call_start_video_stream(LinphoneCall *call, const char *cname,bool_t all_inputs_muted){
1374 #ifdef VIDEO_ENABLED
1375         LinphoneCore *lc=call->core;
1376         int used_pt=-1;
1377         /* look for savp stream first */
1378         const SalStreamDescription *vstream=sal_media_description_find_stream(call->resultdesc,
1379                                                 SalProtoRtpSavp,SalVideo);
1380         /* no savp audio stream, use avp */
1381         if (!vstream)
1382                 vstream=sal_media_description_find_stream(call->resultdesc,
1383                                                 SalProtoRtpAvp,SalVideo);
1384                                                 
1385         /* shutdown preview */
1386         if (lc->previewstream!=NULL) {
1387                 video_preview_stop(lc->previewstream);
1388                 lc->previewstream=NULL;
1389         }
1390         
1391         if (vstream!=NULL && vstream->dir!=SalStreamInactive && vstream->rtp_port!=0) {
1392                 const char *rtp_addr=vstream->rtp_addr[0]!='\0' ? vstream->rtp_addr : call->resultdesc->addr;
1393                 const char *rtcp_addr=vstream->rtcp_addr[0]!='\0' ? vstream->rtcp_addr : call->resultdesc->addr;
1394                 call->video_profile=make_profile(call,call->resultdesc,vstream,&used_pt);
1395                 if (used_pt!=-1){
1396                         call->current_params.video_codec = rtp_profile_get_payload(call->video_profile, used_pt);
1397                         VideoStreamDir dir=VideoStreamSendRecv;
1398                         MSWebCam *cam=lc->video_conf.device;
1399                         bool_t is_inactive=FALSE;
1400
1401                         call->current_params.has_video=TRUE;
1402
1403                         video_stream_enable_adaptive_bitrate_control(call->videostream,
1404                                                                   linphone_core_adaptive_rate_control_enabled(lc));
1405                         video_stream_enable_adaptive_jittcomp(call->videostream, linphone_core_video_adaptive_jittcomp_enabled(lc));
1406                         video_stream_set_sent_video_size(call->videostream,linphone_core_get_preferred_video_size(lc));
1407                         video_stream_enable_self_view(call->videostream,lc->video_conf.selfview);
1408                         if (lc->video_window_id!=0)
1409                                 video_stream_set_native_window_id(call->videostream,lc->video_window_id);
1410                         if (lc->preview_window_id!=0)
1411                                 video_stream_set_native_preview_window_id (call->videostream,lc->preview_window_id);
1412                         video_stream_use_preview_video_window (call->videostream,lc->use_preview_window);
1413                         
1414                         if (vstream->dir==SalStreamSendOnly && lc->video_conf.capture ){
1415                                 cam=get_nowebcam_device();
1416                                 dir=VideoStreamSendOnly;
1417                         }else if (vstream->dir==SalStreamRecvOnly && lc->video_conf.display ){
1418                                 dir=VideoStreamRecvOnly;
1419                         }else if (vstream->dir==SalStreamSendRecv){
1420                                 if (lc->video_conf.display && lc->video_conf.capture)
1421                                         dir=VideoStreamSendRecv;
1422                                 else if (lc->video_conf.display)
1423                                         dir=VideoStreamRecvOnly;
1424                                 else
1425                                         dir=VideoStreamSendOnly;
1426                         }else{
1427                                 ms_warning("video stream is inactive.");
1428                                 /*either inactive or incompatible with local capabilities*/
1429                                 is_inactive=TRUE;
1430                         }
1431                         if (call->camera_active==FALSE || all_inputs_muted){
1432                                 cam=get_nowebcam_device();
1433                         }
1434                         if (!is_inactive){
1435                 call->log->video_enabled = TRUE;
1436                                 video_stream_set_direction (call->videostream, dir);
1437                                 ms_message("%s lc rotation:%d\n", __FUNCTION__, lc->device_rotation);
1438                                 video_stream_set_device_rotation(call->videostream, lc->device_rotation);
1439                                 video_stream_start(call->videostream,
1440                                         call->video_profile, rtp_addr, vstream->rtp_port,
1441                                         rtcp_addr, linphone_core_rtcp_enabled(lc) ? (vstream->rtcp_port) : 0,
1442                                         used_pt, linphone_core_get_video_jittcomp(lc), cam);
1443                                 video_stream_set_rtcp_information(call->videostream, cname,LINPHONE_RTCP_SDES_TOOL);
1444                         }
1445                         
1446                         if (vstream->proto == SalProtoRtpSavp) {
1447                                 const SalStreamDescription *local_st_desc=sal_media_description_find_stream(call->localdesc,
1448                                                 SalProtoRtpSavp,SalVideo);
1449                                                 
1450                                 video_stream_enable_strp(
1451                                         call->videostream, 
1452                                         vstream->crypto[0].algo,
1453                                         local_st_desc->crypto[0].master_key, 
1454                                         vstream->crypto[0].master_key
1455                                         );
1456                                 call->videostream_encrypted=TRUE;
1457                         }else{
1458                                 call->videostream_encrypted=FALSE;
1459                         }
1460                 }else ms_warning("No video stream accepted.");
1461         }else{
1462                 ms_warning("No valid video stream defined.");
1463         }
1464 #endif
1465 }
1466
1467 void linphone_call_start_media_streams(LinphoneCall *call, bool_t all_inputs_muted, bool_t send_ringbacktone){
1468         LinphoneCore *lc=call->core;
1469
1470         call->current_params.audio_codec = NULL;
1471         call->current_params.video_codec = NULL;
1472
1473         LinphoneAddress *me=linphone_core_get_primary_contact_parsed(lc);
1474         char *cname;
1475         bool_t use_arc=linphone_core_adaptive_rate_control_enabled(lc);
1476 #ifdef VIDEO_ENABLED
1477         const SalStreamDescription *vstream=sal_media_description_find_stream(call->resultdesc,
1478                                                         SalProtoRtpAvp,SalVideo);
1479 #endif
1480
1481         if ((call->audiostream == NULL) && (call->videostream == NULL)) {
1482                 ms_fatal("start_media_stream() called without prior init !");
1483                 return;
1484         }
1485         cname=linphone_address_as_string_uri_only(me);
1486
1487 #if defined(VIDEO_ENABLED)
1488         if (vstream!=NULL && vstream->dir!=SalStreamInactive && vstream->payloads!=NULL){
1489                 /*when video is used, do not make adaptive rate control on audio, it is stupid.*/
1490                 use_arc=FALSE;
1491         }
1492 #endif
1493         if (call->audiostream!=NULL) {
1494                 linphone_call_start_audio_stream(call,cname,all_inputs_muted,send_ringbacktone,use_arc);
1495         }
1496         call->current_params.has_video=FALSE;
1497         if (call->videostream!=NULL) {
1498                 linphone_call_start_video_stream(call,cname,all_inputs_muted);
1499         }
1500
1501         call->all_muted=all_inputs_muted;
1502         call->playing_ringbacktone=send_ringbacktone;
1503         call->up_bw=linphone_core_get_upload_bandwidth(lc);
1504
1505         if (call->params.media_encryption==LinphoneMediaEncryptionZRTP) {
1506                 OrtpZrtpParams params;
1507                 /*will be set later when zrtp is activated*/
1508                 call->current_params.media_encryption=LinphoneMediaEncryptionNone;
1509                 
1510                 params.zid_file=lc->zrtp_secrets_cache;
1511                 audio_stream_enable_zrtp(call->audiostream,&params);
1512         }else if (call->params.media_encryption==LinphoneMediaEncryptionSRTP){
1513                 call->current_params.media_encryption=linphone_call_are_all_streams_encrypted(call) ?
1514                         LinphoneMediaEncryptionSRTP : LinphoneMediaEncryptionNone;
1515         }
1516
1517         /*also reflect the change if the "wished" params, in order to avoid to propose SAVP or video again
1518          * further in the call, for example during pause,resume, conferencing reINVITEs*/
1519         linphone_call_fix_call_parameters(call);
1520         if ((call->ice_session != NULL) && (ice_session_state(call->ice_session) != IS_Completed)) {
1521                 ice_session_start_connectivity_checks(call->ice_session);
1522         }
1523
1524         goto end;
1525         end:
1526                 ms_free(cname);
1527                 linphone_address_destroy(me);
1528 }
1529
1530 void linphone_call_start_media_streams_for_ice_gathering(LinphoneCall *call){
1531         audio_stream_prepare_sound(call->audiostream, NULL, NULL);
1532 #ifdef VIDEO_ENABLED
1533         if (call->videostream) {
1534                 video_stream_prepare_video(call->videostream);
1535         }
1536 #endif
1537 }
1538
1539 void linphone_call_delete_ice_session(LinphoneCall *call){
1540         if (call->ice_session != NULL) {
1541                 ice_session_destroy(call->ice_session);
1542                 call->ice_session = NULL;
1543                 if (call->audiostream != NULL) call->audiostream->ice_check_list = NULL;
1544                 if (call->videostream != NULL) call->videostream->ice_check_list = NULL;
1545                 call->stats[LINPHONE_CALL_STATS_AUDIO].ice_state = LinphoneIceStateNotActivated;
1546                 call->stats[LINPHONE_CALL_STATS_VIDEO].ice_state = LinphoneIceStateNotActivated;
1547         }
1548 }
1549
1550 static void linphone_call_log_fill_stats(LinphoneCallLog *log, AudioStream *st){
1551         audio_stream_get_local_rtp_stats (st,&log->local_stats);
1552         log->quality=audio_stream_get_average_quality_rating(st);
1553 }
1554
1555 void linphone_call_stop_media_streams(LinphoneCall *call){
1556         if (call->audiostream!=NULL) {
1557                 call->audiostream->ice_check_list = NULL;
1558                 rtp_session_unregister_event_queue(call->audiostream->session,call->audiostream_app_evq);
1559                 ortp_ev_queue_flush(call->audiostream_app_evq);
1560                 ortp_ev_queue_destroy(call->audiostream_app_evq);
1561                 call->audiostream_app_evq=NULL;
1562
1563                 if (call->audiostream->ec){
1564                         const char *state_str=NULL;
1565                         ms_filter_call_method(call->audiostream->ec,MS_ECHO_CANCELLER_GET_STATE_STRING,&state_str);
1566                         if (state_str){
1567                                 ms_message("Writing echo canceler state, %i bytes",(int)strlen(state_str));
1568                                 lp_config_set_string(call->core->config,"sound","ec_state",state_str);
1569                         }
1570                 }
1571                 linphone_call_log_fill_stats (call->log,call->audiostream);
1572                 if (call->endpoint){
1573                         linphone_call_remove_from_conf(call);
1574                 }
1575                 audio_stream_stop(call->audiostream);
1576                 call->audiostream=NULL;
1577         }
1578
1579
1580 #ifdef VIDEO_ENABLED
1581         if (call->videostream!=NULL){
1582                 call->videostream->ice_check_list = NULL;
1583                 rtp_session_unregister_event_queue(call->videostream->session,call->videostream_app_evq);
1584                 ortp_ev_queue_flush(call->videostream_app_evq);
1585                 ortp_ev_queue_destroy(call->videostream_app_evq);
1586                 call->videostream_app_evq=NULL;
1587                 video_stream_stop(call->videostream);
1588                 call->videostream=NULL;
1589         }
1590 #endif
1591         ms_event_queue_skip(call->core->msevq);
1592         
1593         if (call->audio_profile){
1594                 rtp_profile_clear_all(call->audio_profile);
1595                 rtp_profile_destroy(call->audio_profile);
1596                 call->audio_profile=NULL;
1597         }
1598         if (call->video_profile){
1599                 rtp_profile_clear_all(call->video_profile);
1600                 rtp_profile_destroy(call->video_profile);
1601                 call->video_profile=NULL;
1602         }
1603 }
1604
1605
1606
1607 void linphone_call_enable_echo_cancellation(LinphoneCall *call, bool_t enable) {
1608         if (call!=NULL && call->audiostream!=NULL && call->audiostream->ec){
1609                 bool_t bypass_mode = !enable;
1610                 ms_filter_call_method(call->audiostream->ec,MS_ECHO_CANCELLER_SET_BYPASS_MODE,&bypass_mode);
1611         }
1612 }
1613 bool_t linphone_call_echo_cancellation_enabled(LinphoneCall *call) {
1614         if (call!=NULL && call->audiostream!=NULL && call->audiostream->ec){
1615                 bool_t val;
1616                 ms_filter_call_method(call->audiostream->ec,MS_ECHO_CANCELLER_GET_BYPASS_MODE,&val);
1617                 return !val;
1618         } else {
1619                 return linphone_core_echo_cancellation_enabled(call->core);
1620         }
1621 }
1622
1623 void linphone_call_enable_echo_limiter(LinphoneCall *call, bool_t val){
1624         if (call!=NULL && call->audiostream!=NULL ) {
1625                 if (val) {
1626                 const char *type=lp_config_get_string(call->core->config,"sound","el_type","mic");
1627                 if (strcasecmp(type,"mic")==0)
1628                         audio_stream_enable_echo_limiter(call->audiostream,ELControlMic);
1629                 else if (strcasecmp(type,"full")==0)
1630                         audio_stream_enable_echo_limiter(call->audiostream,ELControlFull);
1631                 } else {
1632                         audio_stream_enable_echo_limiter(call->audiostream,ELInactive);
1633                 }
1634         }
1635 }
1636
1637 bool_t linphone_call_echo_limiter_enabled(const LinphoneCall *call){
1638         if (call!=NULL && call->audiostream!=NULL ){
1639                 return call->audiostream->el_type !=ELInactive ;
1640         } else {
1641                 return linphone_core_echo_limiter_enabled(call->core);
1642         }
1643 }
1644
1645 /**
1646  * @addtogroup call_misc
1647  * @{
1648 **/
1649
1650 /**
1651  * Returns the measured sound volume played locally (received from remote).
1652  * It is expressed in dbm0.
1653 **/
1654 float linphone_call_get_play_volume(LinphoneCall *call){
1655         AudioStream *st=call->audiostream;
1656         if (st && st->volrecv){
1657                 float vol=0;
1658                 ms_filter_call_method(st->volrecv,MS_VOLUME_GET,&vol);
1659                 return vol;
1660
1661         }
1662         return LINPHONE_VOLUME_DB_LOWEST;
1663 }
1664
1665 /**
1666  * Returns the measured sound volume recorded locally (sent to remote).
1667  * It is expressed in dbm0.
1668 **/
1669 float linphone_call_get_record_volume(LinphoneCall *call){
1670         AudioStream *st=call->audiostream;
1671         if (st && st->volsend && !call->audio_muted && call->state==LinphoneCallStreamsRunning){
1672                 float vol=0;
1673                 ms_filter_call_method(st->volsend,MS_VOLUME_GET,&vol);
1674                 return vol;
1675
1676         }
1677         return LINPHONE_VOLUME_DB_LOWEST;
1678 }
1679
1680 /**
1681  * Obtain real-time quality rating of the call
1682  *
1683  * Based on local RTP statistics and RTCP feedback, a quality rating is computed and updated
1684  * during all the duration of the call. This function returns its value at the time of the function call.
1685  * It is expected that the rating is updated at least every 5 seconds or so.
1686  * The rating is a floating point number comprised between 0 and 5.
1687  *
1688  * 4-5 = good quality <br>
1689  * 3-4 = average quality <br>
1690  * 2-3 = poor quality <br>
1691  * 1-2 = very poor quality <br>
1692  * 0-1 = can't be worse, mostly unusable <br>
1693  *
1694  * @returns The function returns -1 if no quality measurement is available, for example if no
1695  * active audio stream exist. Otherwise it returns the quality rating.
1696 **/
1697 float linphone_call_get_current_quality(LinphoneCall *call){
1698         if (call->audiostream){
1699                 return audio_stream_get_quality_rating(call->audiostream);
1700         }
1701         return -1;
1702 }
1703
1704 /**
1705  * Returns call quality averaged over all the duration of the call.
1706  *
1707  * See linphone_call_get_current_quality() for more details about quality measurement.
1708 **/
1709 float linphone_call_get_average_quality(LinphoneCall *call){
1710         if (call->audiostream){
1711                 return audio_stream_get_average_quality_rating(call->audiostream);
1712         }
1713         return -1;
1714 }
1715
1716 /**
1717  * Access last known statistics for audio stream, for a given call.
1718 **/
1719 const LinphoneCallStats *linphone_call_get_audio_stats(const LinphoneCall *call) {
1720         return &call->stats[LINPHONE_CALL_STATS_AUDIO];
1721 }
1722
1723 /**
1724  * Access last known statistics for video stream, for a given call.
1725 **/
1726 const LinphoneCallStats *linphone_call_get_video_stats(const LinphoneCall *call) {
1727         return &call->stats[LINPHONE_CALL_STATS_VIDEO];
1728 }
1729
1730
1731 /**
1732  * @}
1733 **/
1734
1735 static void report_bandwidth(LinphoneCall *call, RtpSession *as, RtpSession *vs){
1736         call->stats[LINPHONE_CALL_STATS_AUDIO].download_bandwidth=(as!=NULL) ? (rtp_session_compute_recv_bandwidth(as)*1e-3) : 0;
1737         call->stats[LINPHONE_CALL_STATS_AUDIO].upload_bandwidth=(as!=NULL) ? (rtp_session_compute_send_bandwidth(as)*1e-3) : 0;
1738         call->stats[LINPHONE_CALL_STATS_VIDEO].download_bandwidth=(vs!=NULL) ? (rtp_session_compute_recv_bandwidth(vs)*1e-3) : 0;
1739         call->stats[LINPHONE_CALL_STATS_VIDEO].upload_bandwidth=(vs!=NULL) ? (rtp_session_compute_send_bandwidth(vs)*1e-3) : 0;
1740         ms_message("bandwidth usage: audio=[d=%.1f,u=%.1f] video=[d=%.1f,u=%.1f] kbit/sec",
1741                 call->stats[LINPHONE_CALL_STATS_AUDIO].download_bandwidth,
1742                 call->stats[LINPHONE_CALL_STATS_AUDIO].upload_bandwidth ,
1743                 call->stats[LINPHONE_CALL_STATS_VIDEO].download_bandwidth,
1744                 call->stats[LINPHONE_CALL_STATS_VIDEO].upload_bandwidth
1745         );
1746 }
1747
1748 static void linphone_core_disconnected(LinphoneCore *lc, LinphoneCall *call){
1749         char temp[256];
1750         char *from=NULL;
1751         if(call)
1752                 from = linphone_call_get_remote_address_as_string(call);
1753         if (from)
1754         {
1755                 snprintf(temp,sizeof(temp),"Remote end %s seems to have disconnected, the call is going to be closed.",from);
1756                 free(from);
1757         }
1758         else
1759         {
1760                 snprintf(temp,sizeof(temp),"Remote end seems to have disconnected, the call is going to be closed.");
1761         }
1762         if (lc->vtable.display_warning!=NULL)
1763                 lc->vtable.display_warning(lc,temp);
1764         linphone_core_terminate_call(lc,call);
1765 }
1766
1767 static void handle_ice_events(LinphoneCall *call, OrtpEvent *ev){
1768         OrtpEventType evt=ortp_event_get_type(ev);
1769         OrtpEventData *evd=ortp_event_get_data(ev);
1770
1771         if (evt == ORTP_EVENT_ICE_SESSION_PROCESSING_FINISHED) {
1772                 switch (ice_session_state(call->ice_session)) {
1773                         case IS_Completed:
1774                                 ice_session_select_candidates(call->ice_session);
1775                                 if (ice_session_role(call->ice_session) == IR_Controlling) {
1776                                         linphone_core_update_call(call->core, call, &call->current_params);
1777                                 }
1778                                 break;
1779                         case IS_Failed:
1780                                 if (ice_session_has_completed_check_list(call->ice_session) == TRUE) {
1781                                         ice_session_select_candidates(call->ice_session);
1782                                         if (ice_session_role(call->ice_session) == IR_Controlling) {
1783                                                 /* At least one ICE session has succeeded, so perform a call update. */
1784                                                 linphone_core_update_call(call->core, call, &call->current_params);
1785                                         }
1786                                 }
1787                                 break;
1788                         default:
1789                                 break;
1790                 }
1791                 linphone_core_update_ice_state_in_call_stats(call);
1792         } else if (evt == ORTP_EVENT_ICE_GATHERING_FINISHED) {
1793                 int ping_time = -1;
1794                 if (evd->info.ice_processing_successful==TRUE) {
1795                         ice_session_compute_candidates_foundations(call->ice_session);
1796                         ice_session_eliminate_redundant_candidates(call->ice_session);
1797                         ice_session_choose_default_candidates(call->ice_session);
1798                         ping_time = ice_session_gathering_duration(call->ice_session);
1799                         if (ping_time >=0) {
1800                                 ping_time /= ice_session_nb_check_lists(call->ice_session);
1801                         }
1802                 } else {
1803                         ms_warning("No STUN answer from [%s], disabling ICE",linphone_core_get_stun_server(call->core));
1804                         linphone_call_delete_ice_session(call);
1805                 }
1806                 switch (call->state) {
1807                         case LinphoneCallStreamsRunning:
1808                                 linphone_core_start_update_call(call->core, call);
1809                                 break;
1810                         case LinphoneCallUpdatedByRemote:
1811                                 linphone_core_start_accept_call_update(call->core, call);
1812                                 break;
1813                         case LinphoneCallOutgoingInit:
1814                                 if (ping_time >= 0) {
1815                                         linphone_core_adapt_to_network(call->core, ping_time, &call->params);
1816                                 }
1817                                 linphone_call_stop_media_streams(call);
1818                                 linphone_core_proceed_with_invite_if_ready(call->core, call, NULL);
1819                                 break;
1820                         default:
1821                                 if (ping_time >= 0) {
1822                                         linphone_core_adapt_to_network(call->core, ping_time, &call->params);
1823                                 }
1824                                 linphone_call_stop_media_streams(call);
1825                                 linphone_core_notify_incoming_call(call->core, call);
1826                                 break;
1827                 }
1828         } else if (evt == ORTP_EVENT_ICE_LOSING_PAIRS_COMPLETED) {
1829                 linphone_core_start_accept_call_update(call->core, call);
1830         } else if (evt == ORTP_EVENT_ICE_RESTART_NEEDED) {
1831                 ice_session_restart(call->ice_session);
1832                 ice_session_set_role(call->ice_session, IR_Controlling);
1833                 linphone_core_update_call(call->core, call, &call->current_params);
1834         }
1835 }
1836
1837 void linphone_call_background_tasks(LinphoneCall *call, bool_t one_second_elapsed){
1838         LinphoneCore* lc = call->core;
1839         int disconnect_timeout = linphone_core_get_nortp_timeout(call->core);
1840         bool_t disconnected=FALSE;
1841
1842         if (call->state==LinphoneCallStreamsRunning && one_second_elapsed){
1843                 RtpSession *as=NULL,*vs=NULL;
1844                 float audio_load=0, video_load=0;
1845                 if (call->audiostream!=NULL){
1846                         as=call->audiostream->session;
1847                         if (call->audiostream->ticker)
1848                                 audio_load=ms_ticker_get_average_load(call->audiostream->ticker);
1849                 }
1850                 if (call->videostream!=NULL){
1851                         if (call->videostream->ticker)
1852                                 video_load=ms_ticker_get_average_load(call->videostream->ticker);
1853                         vs=call->videostream->session;
1854                 }
1855                 report_bandwidth(call,as,vs);
1856                 ms_message("Thread processing load: audio=%f\tvideo=%f",audio_load,video_load);
1857         }
1858 #ifdef VIDEO_ENABLED
1859         if (call->videostream!=NULL) {
1860                 OrtpEvent *ev;
1861
1862                 /* Ensure there is no dangling ICE check list. */
1863                 if (call->ice_session == NULL) call->videostream->ice_check_list = NULL;
1864
1865                 // Beware that the application queue should not depend on treatments fron the
1866                 // mediastreamer queue.
1867                 video_stream_iterate(call->videostream);
1868
1869                 while (call->videostream_app_evq && (NULL != (ev=ortp_ev_queue_get(call->videostream_app_evq)))){
1870                         OrtpEventType evt=ortp_event_get_type(ev);
1871                         OrtpEventData *evd=ortp_event_get_data(ev);
1872                         if (evt == ORTP_EVENT_ZRTP_ENCRYPTION_CHANGED){
1873                                 linphone_call_videostream_encryption_changed(call, evd->info.zrtp_stream_encrypted);
1874                         } else if (evt == ORTP_EVENT_RTCP_PACKET_RECEIVED) {
1875                                 call->stats[LINPHONE_CALL_STATS_VIDEO].round_trip_delay = rtp_session_get_round_trip_propagation(call->videostream->session);
1876                                 if(call->stats[LINPHONE_CALL_STATS_VIDEO].received_rtcp != NULL)
1877                                         freemsg(call->stats[LINPHONE_CALL_STATS_VIDEO].received_rtcp);
1878                                 call->stats[LINPHONE_CALL_STATS_VIDEO].received_rtcp = evd->packet;
1879                                 evd->packet = NULL;
1880                                 if (lc->vtable.call_stats_updated)
1881                                         lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_VIDEO]);
1882                         } else if (evt == ORTP_EVENT_RTCP_PACKET_EMITTED) {
1883                                 memcpy(&call->stats[LINPHONE_CALL_STATS_VIDEO].jitter_stats, rtp_session_get_jitter_stats(call->videostream->session), sizeof(jitter_stats_t));
1884                                 if(call->stats[LINPHONE_CALL_STATS_VIDEO].sent_rtcp != NULL)
1885                                         freemsg(call->stats[LINPHONE_CALL_STATS_VIDEO].sent_rtcp);
1886                                 call->stats[LINPHONE_CALL_STATS_VIDEO].sent_rtcp = evd->packet;
1887                                 evd->packet = NULL;
1888                                 if (lc->vtable.call_stats_updated)
1889                                         lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_VIDEO]);
1890                         } else if ((evt == ORTP_EVENT_ICE_SESSION_PROCESSING_FINISHED) || (evt == ORTP_EVENT_ICE_GATHERING_FINISHED)
1891                                 || (evt == ORTP_EVENT_ICE_LOSING_PAIRS_COMPLETED) || (evt == ORTP_EVENT_ICE_RESTART_NEEDED)) {
1892                                 handle_ice_events(call, ev);
1893                         }
1894                         ortp_event_destroy(ev);
1895                 }
1896         }
1897 #endif
1898         if (call->audiostream!=NULL) {
1899                 OrtpEvent *ev;
1900
1901                 /* Ensure there is no dangling ICE check list. */
1902                 if (call->ice_session == NULL) call->audiostream->ice_check_list = NULL;
1903
1904                 // Beware that the application queue should not depend on treatments fron the
1905                 // mediastreamer queue.
1906                 audio_stream_iterate(call->audiostream);
1907
1908                 while (call->audiostream_app_evq && (NULL != (ev=ortp_ev_queue_get(call->audiostream_app_evq)))){
1909                         OrtpEventType evt=ortp_event_get_type(ev);
1910                         OrtpEventData *evd=ortp_event_get_data(ev);
1911                         if (evt == ORTP_EVENT_ZRTP_ENCRYPTION_CHANGED){
1912                                 linphone_call_audiostream_encryption_changed(call, evd->info.zrtp_stream_encrypted);
1913                         } else if (evt == ORTP_EVENT_ZRTP_SAS_READY) {
1914                                 linphone_call_audiostream_auth_token_ready(call, evd->info.zrtp_sas.sas, evd->info.zrtp_sas.verified);
1915                         } else if (evt == ORTP_EVENT_RTCP_PACKET_RECEIVED) {
1916                                 call->stats[LINPHONE_CALL_STATS_AUDIO].round_trip_delay = rtp_session_get_round_trip_propagation(call->audiostream->session);
1917                                 if(call->stats[LINPHONE_CALL_STATS_AUDIO].received_rtcp != NULL)
1918                                         freemsg(call->stats[LINPHONE_CALL_STATS_AUDIO].received_rtcp);
1919                                 call->stats[LINPHONE_CALL_STATS_AUDIO].received_rtcp = evd->packet;
1920                                 evd->packet = NULL;
1921                                 if (lc->vtable.call_stats_updated)
1922                                         lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_AUDIO]);
1923                         } else if (evt == ORTP_EVENT_RTCP_PACKET_EMITTED) {
1924                                 memcpy(&call->stats[LINPHONE_CALL_STATS_AUDIO].jitter_stats, rtp_session_get_jitter_stats(call->audiostream->session), sizeof(jitter_stats_t));
1925                                 if(call->stats[LINPHONE_CALL_STATS_AUDIO].sent_rtcp != NULL)
1926                                         freemsg(call->stats[LINPHONE_CALL_STATS_AUDIO].sent_rtcp);
1927                                 call->stats[LINPHONE_CALL_STATS_AUDIO].sent_rtcp = evd->packet;
1928                                 evd->packet = NULL;
1929                                 if (lc->vtable.call_stats_updated)
1930                                         lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_AUDIO]);
1931                         } else if ((evt == ORTP_EVENT_ICE_SESSION_PROCESSING_FINISHED) || (evt == ORTP_EVENT_ICE_GATHERING_FINISHED)
1932                                 || (evt == ORTP_EVENT_ICE_LOSING_PAIRS_COMPLETED) || (evt == ORTP_EVENT_ICE_RESTART_NEEDED)) {
1933                                 handle_ice_events(call, ev);
1934                         }
1935                         ortp_event_destroy(ev);
1936                 }
1937         }
1938         if (call->state==LinphoneCallStreamsRunning && one_second_elapsed && call->audiostream!=NULL && disconnect_timeout>0 )
1939                 disconnected=!audio_stream_alive(call->audiostream,disconnect_timeout);
1940         if (disconnected)
1941                 linphone_core_disconnected(call->core,call);
1942 }
1943
1944 void linphone_call_log_completed(LinphoneCall *call){
1945         LinphoneCore *lc=call->core;
1946
1947         call->log->duration=time(NULL)-call->start_time;
1948
1949         if (call->log->status==LinphoneCallMissed){
1950                 char *info;
1951                 lc->missed_calls++;
1952                 info=ortp_strdup_printf(ngettext("You have missed %i call.",
1953                                          "You have missed %i calls.", lc->missed_calls),
1954                                 lc->missed_calls);
1955         if (lc->vtable.display_status!=NULL)
1956             lc->vtable.display_status(lc,info);
1957                 ms_free(info);
1958         }
1959         lc->call_logs=ms_list_prepend(lc->call_logs,(void *)call->log);
1960         if (ms_list_size(lc->call_logs)>lc->max_call_logs){
1961                 MSList *elem,*prevelem=NULL;
1962                 /*find the last element*/
1963                 for(elem=lc->call_logs;elem!=NULL;elem=elem->next){
1964                         prevelem=elem;
1965                 }
1966                 elem=prevelem;
1967                 linphone_call_log_destroy((LinphoneCallLog*)elem->data);
1968                 lc->call_logs=ms_list_remove_link(lc->call_logs,elem);
1969         }
1970         if (lc->vtable.call_log_updated!=NULL){
1971                 lc->vtable.call_log_updated(lc,call->log);
1972         }
1973         call_logs_write_to_config_file(lc);
1974 }
1975
1976 LinphoneCallState linphone_call_get_transfer_state(LinphoneCall *call) {
1977         return call->transfer_state;
1978 }
1979
1980 void linphone_call_set_transfer_state(LinphoneCall* call, LinphoneCallState state) {
1981         if (state != call->transfer_state) {
1982                 LinphoneCore* lc = call->core;
1983                 call->transfer_state = state;
1984                 if (lc->vtable.transfer_state_changed)
1985                         lc->vtable.transfer_state_changed(lc, call, state);
1986         }
1987 }
1988
1989 bool_t linphone_call_is_in_conference(const LinphoneCall *call) {
1990         return call->params.in_conference;
1991 }