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