4 Copyright (C) 2010 Belledonne Communications SARL
5 (simon.morlat@linphone.org)
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.
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.
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.
24 #include "linphonecore.h"
28 #include <ortp/event.h>
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"
41 static MSWebCam *get_nowebcam_device(){
42 return ms_web_cam_manager_get_cam(ms_web_cam_manager_get(),"StaticImage: Static picture");
46 static bool_t generate_b64_crypto_key(int key_length, char* key_out) {
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");
55 b64_size = b64_encode((const char*)tmp, key_length, NULL, 0);
57 ms_error("Failed to b64 encode key");
61 key_out[b64_size] = '\0';
62 b64_encode((const char*)tmp, key_length, key_out, 40);
67 LinphoneCore *linphone_call_get_core(const LinphoneCall *call){
71 const char* linphone_call_get_authentication_token(LinphoneCall *call){
72 return call->auth_token;
75 bool_t linphone_call_get_authentication_token_verified(LinphoneCall *call){
76 return call->auth_token_verified;
79 static bool_t linphone_call_are_all_streams_encrypted(LinphoneCall *call) {
80 // Check ZRTP encryption in audiostream
81 if (!call->audiostream_encrypted) {
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) {
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);
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);
112 static void linphone_call_videostream_encryption_changed(void *data, bool_t encrypted){
113 ms_message("Video stream is %s", encrypted ? "encrypted" : "not encrypted");
115 LinphoneCall *call = (LinphoneCall *)data;
116 call->videostream_encrypted=encrypted;
117 propagate_encryption_changed(call);
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");
125 LinphoneCall *call = (LinphoneCall *)data;
126 call->audiostream_encrypted=encrypted;
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);
133 propagate_encryption_changed(call);
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,¶ms);
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);
154 call->auth_token=ms_strdup(auth_token);
155 call->auth_token_verified=verified;
157 ms_message("Authentication token is %s (%s)", auth_token, verified?"verified":"unverified");
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");
164 if (call->audiostream->ortpZrtpContext==NULL){
165 ms_error("linphone_call_set_authentication_token_verified(): No zrtp context.");
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);
172 call->auth_token_verified=verified;
173 propagate_encryption_changed(call);
176 static MSList *make_codec_list(LinphoneCore *lc, const MSList *codecs, int bandwidth_limit,int* max_sample_rate){
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);
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);
196 static SalMediaDescription *_create_local_media_description(LinphoneCore *lc, LinphoneCall *call, unsigned int session_id, unsigned int session_ver){
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();
205 md->session_id=session_id;
206 md->session_ver=session_ver;
208 strncpy(md->addr,call->localip,sizeof(md->addr));
209 strncpy(md->username,username,sizeof(md->username));
211 if (call->params.down_bw)
212 md->bandwidth=call->params.down_bw;
213 else md->bandwidth=linphone_core_get_download_bandwidth(lc);
215 /*set audio capabilities */
216 strncpy(md->streams[0].rtp_addr,call->localip,sizeof(md->streams[0].rtp_addr));
217 strncpy(md->streams[0].rtcp_addr,call->localip,sizeof(md->streams[0].rtcp_addr));
218 md->streams[0].rtp_port=call->audio_port;
219 md->streams[0].rtcp_port=call->audio_port+1;
220 md->streams[0].proto=(call->params.media_encryption == LinphoneMediaEncryptionSRTP) ?
221 SalProtoRtpSavp : SalProtoRtpAvp;
222 md->streams[0].type=SalAudio;
223 if (call->params.down_ptime)
224 md->streams[0].ptime=call->params.down_ptime;
226 md->streams[0].ptime=linphone_core_get_download_ptime(lc);
227 l=make_codec_list(lc,lc->codecs_conf.audio_codecs,call->params.audio_bw,&md->streams[0].max_rate);
228 pt=payload_type_clone(rtp_profile_get_payload_from_mime(&av_profile,"telephone-event"));
229 l=ms_list_append(l,pt);
230 md->streams[0].payloads=l;
234 if (call->params.has_video){
236 md->streams[1].rtp_port=call->video_port;
237 md->streams[1].rtcp_port=call->video_port+1;
238 md->streams[1].proto=md->streams[0].proto;
239 md->streams[1].type=SalVideo;
240 l=make_codec_list(lc,lc->codecs_conf.video_codecs,0,NULL);
241 md->streams[1].payloads=l;
244 for(i=0; i<md->nstreams; i++) {
245 if (md->streams[i].proto == SalProtoRtpSavp) {
246 md->streams[i].crypto[0].tag = 1;
247 md->streams[i].crypto[0].algo = AES_128_SHA1_80;
248 if (!generate_b64_crypto_key(30, md->streams[i].crypto[0].master_key))
249 md->streams[i].crypto[0].algo = 0;
250 md->streams[i].crypto[1].tag = 2;
251 md->streams[i].crypto[1].algo = AES_128_SHA1_32;
252 if (!generate_b64_crypto_key(30, md->streams[i].crypto[1].master_key))
253 md->streams[i].crypto[1].algo = 0;
254 md->streams[i].crypto[2].algo = 0;
256 if ((linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseIce) && (call->ice_session != NULL) && (ice_session_check_list(call->ice_session, i) == NULL)) {
257 ice_session_add_check_list(call->ice_session, ice_check_list_new());
261 linphone_address_destroy(addr);
265 void update_local_media_description(LinphoneCore *lc, LinphoneCall *call){
266 SalMediaDescription *md=call->localdesc;
268 call->localdesc = create_local_media_description(lc,call);
270 call->localdesc = _create_local_media_description(lc,call,md->session_id,md->session_ver+1);
271 sal_media_description_unref(md);
275 SalMediaDescription *create_local_media_description(LinphoneCore *lc, LinphoneCall *call){
276 unsigned int id=rand() & 0xfff;
277 return _create_local_media_description(lc,call,id,id);
280 static int find_port_offset(LinphoneCore *lc){
284 bool_t already_used=FALSE;
285 for(offset=0;offset<100;offset+=2){
286 audio_port=linphone_core_get_audio_port (lc)+offset;
288 for(elem=lc->calls;elem!=NULL;elem=elem->next){
289 LinphoneCall *call=(LinphoneCall*)elem->data;
290 if (call->audio_port==audio_port) {
295 if (!already_used) break;
298 ms_error("Could not find any free port !");
304 static void linphone_call_init_common(LinphoneCall *call, LinphoneAddress *from, LinphoneAddress *to){
306 call->magic=linphone_call_magic;
308 call->state=LinphoneCallIdle;
309 call->transfer_state = LinphoneCallIdle;
310 call->start_time=time(NULL);
311 call->media_start_time=0;
312 call->log=linphone_call_log_new(call, from, to);
313 call->owns_call_log=TRUE;
314 linphone_core_notify_all_friends(call->core,LinphoneStatusOnThePhone);
315 port_offset=find_port_offset (call->core);
316 if (port_offset==-1) return;
317 call->audio_port=linphone_core_get_audio_port(call->core)+port_offset;
318 call->video_port=linphone_core_get_video_port(call->core)+port_offset;
319 linphone_call_init_stats(&call->stats[LINPHONE_CALL_STATS_AUDIO], LINPHONE_CALL_STATS_AUDIO);
320 linphone_call_init_stats(&call->stats[LINPHONE_CALL_STATS_VIDEO], LINPHONE_CALL_STATS_VIDEO);
323 void linphone_call_init_stats(LinphoneCallStats *stats, int type) {
325 stats->received_rtcp = NULL;
326 stats->sent_rtcp = NULL;
327 stats->ice_state = LinphoneIceStateNotActivated;
330 static void update_media_description_from_stun(SalMediaDescription *md, const StunCandidate *ac, const StunCandidate *vc){
332 strcpy(md->streams[0].rtp_addr,ac->addr);
333 md->streams[0].rtp_port=ac->port;
334 if ((ac->addr[0]!='\0' && vc->addr[0]!='\0' && strcmp(ac->addr,vc->addr)==0) || md->nstreams==1){
335 strcpy(md->addr,ac->addr);
339 strcpy(md->streams[1].rtp_addr,vc->addr);
340 md->streams[1].rtp_port=vc->port;
345 static void discover_mtu(LinphoneCore *lc, const char *remote){
347 if (lc->net_conf.mtu==0 ){
348 /*attempt to discover mtu*/
349 mtu=ms_discover_mtu(remote);
352 ms_message("Discovered mtu is %i, RTP payload max size is %i",
353 mtu, ms_get_payload_max_size());
358 #define STUN_CANDIDATE_INIT {{0},0}
360 LinphoneCall * linphone_call_new_outgoing(struct _LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, const LinphoneCallParams *params)
362 LinphoneCall *call=ms_new0(LinphoneCall,1);
363 StunCandidate ac=STUN_CANDIDATE_INIT,vc=STUN_CANDIDATE_INIT;
365 call->dir=LinphoneCallOutgoing;
366 call->op=sal_op_new(lc->sal);
367 sal_op_set_user_pointer(call->op,call);
369 linphone_core_get_local_ip(lc,linphone_address_get_domain(to),call->localip);
370 linphone_call_init_common(call,from,to);
371 call->params=*params;
372 if (linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseIce) {
373 call->ice_session = ice_session_new();
374 ice_session_set_role(call->ice_session, IR_Controlling);
376 if (linphone_core_get_firewall_policy(call->core) == LinphonePolicyUseStun) {
377 ping_time=linphone_core_run_stun_tests(call->core,call,&ac, &vc);
380 linphone_core_adapt_to_network(lc,ping_time,&call->params);
382 call->localdesc=create_local_media_description(lc,call);
383 update_media_description_from_stun(call->localdesc,&ac,&vc);
384 call->camera_active=params->has_video;
386 discover_mtu(lc,linphone_address_get_domain (to));
387 if (params->referer){
388 sal_call_set_referer(call->op,params->referer->op);
389 call->referer=linphone_call_ref(params->referer);
394 LinphoneCall * linphone_call_new_incoming(LinphoneCore *lc, LinphoneAddress *from, LinphoneAddress *to, SalOp *op){
395 LinphoneCall *call=ms_new0(LinphoneCall,1);
398 StunCandidate ac=STUN_CANDIDATE_INIT,vc=STUN_CANDIDATE_INIT;
400 call->dir=LinphoneCallIncoming;
401 sal_op_set_user_pointer(op,call);
405 if (lc->sip_conf.ping_with_options){
406 /*the following sends an option request back to the caller so that
407 we get a chance to discover our nat'd address before answering.*/
408 call->ping_op=sal_op_new(lc->sal);
409 from_str=linphone_address_as_string_uri_only(from);
410 sal_op_set_route(call->ping_op,sal_op_get_network_origin(op));
411 sal_op_set_user_pointer(call->ping_op,call);
412 sal_ping(call->ping_op,linphone_core_find_best_identity(lc,from,NULL),from_str);
416 linphone_address_clean(from);
417 linphone_core_get_local_ip(lc,linphone_address_get_domain(from),call->localip);
418 linphone_call_init_common(call, from, to);
419 linphone_core_init_default_params(lc, &call->params);
420 call->params.has_video &= !!lc->video_policy.automatically_accept;
421 switch (linphone_core_get_firewall_policy(call->core)) {
422 case LinphonePolicyUseIce:
423 call->ice_session = ice_session_new();
424 ice_session_set_role(call->ice_session, IR_Controlled);
425 linphone_core_update_ice_from_remote_media_description(call, sal_call_get_remote_media_description(op));
426 if (call->ice_session != NULL) {
427 linphone_call_init_media_streams(call);
428 linphone_call_start_media_streams_for_ice_gathering(call);
429 if (linphone_core_gather_ice_candidates(call->core,call)<0) {
430 /* Ice candidates gathering failed, proceed with the call anyway. */
431 linphone_call_delete_ice_session(call);
432 linphone_call_stop_media_streams(call);
436 case LinphonePolicyUseStun:
437 ping_time=linphone_core_run_stun_tests(call->core,call,&ac, &vc);
438 /* No break to also destroy ice session in this case. */
443 linphone_core_adapt_to_network(lc,ping_time,&call->params);
445 call->localdesc=create_local_media_description(lc,call);
446 update_media_description_from_stun(call->localdesc,&ac,&vc);
447 call->camera_active=call->params.has_video;
449 discover_mtu(lc,linphone_address_get_domain(from));
453 /* this function is called internally to get rid of a call.
454 It performs the following tasks:
455 - remove the call from the internal list of calls
456 - update the call logs accordingly
459 static void linphone_call_set_terminated(LinphoneCall *call){
460 LinphoneCore *lc=call->core;
462 linphone_core_update_allocated_audio_bandwidth(lc);
464 call->owns_call_log=FALSE;
465 linphone_call_log_completed(call);
468 if (call == lc->current_call){
469 ms_message("Resetting the current call");
470 lc->current_call=NULL;
473 if (linphone_core_del_call(lc,call) != 0){
474 ms_error("Could not remove the call from the list !!!");
477 if (ms_list_size(lc->calls)==0)
478 linphone_core_notify_all_friends(lc,lc->presence_mode);
480 linphone_core_conference_check_uninit(lc);
481 if (call->ringing_beep){
482 linphone_core_stop_dtmf(lc);
483 call->ringing_beep=FALSE;
486 linphone_call_unref(call->referer);
491 void linphone_call_fix_call_parameters(LinphoneCall *call){
492 call->params.has_video=call->current_params.has_video;
493 call->params.media_encryption=call->current_params.media_encryption;
496 const char *linphone_call_state_to_string(LinphoneCallState cs){
498 case LinphoneCallIdle:
499 return "LinphoneCallIdle";
500 case LinphoneCallIncomingReceived:
501 return "LinphoneCallIncomingReceived";
502 case LinphoneCallOutgoingInit:
503 return "LinphoneCallOutgoingInit";
504 case LinphoneCallOutgoingProgress:
505 return "LinphoneCallOutgoingProgress";
506 case LinphoneCallOutgoingRinging:
507 return "LinphoneCallOutgoingRinging";
508 case LinphoneCallOutgoingEarlyMedia:
509 return "LinphoneCallOutgoingEarlyMedia";
510 case LinphoneCallConnected:
511 return "LinphoneCallConnected";
512 case LinphoneCallStreamsRunning:
513 return "LinphoneCallStreamsRunning";
514 case LinphoneCallPausing:
515 return "LinphoneCallPausing";
516 case LinphoneCallPaused:
517 return "LinphoneCallPaused";
518 case LinphoneCallResuming:
519 return "LinphoneCallResuming";
520 case LinphoneCallRefered:
521 return "LinphoneCallRefered";
522 case LinphoneCallError:
523 return "LinphoneCallError";
524 case LinphoneCallEnd:
525 return "LinphoneCallEnd";
526 case LinphoneCallPausedByRemote:
527 return "LinphoneCallPausedByRemote";
528 case LinphoneCallUpdatedByRemote:
529 return "LinphoneCallUpdatedByRemote";
530 case LinphoneCallIncomingEarlyMedia:
531 return "LinphoneCallIncomingEarlyMedia";
532 case LinphoneCallUpdated:
533 return "LinphoneCallUpdated";
534 case LinphoneCallReleased:
535 return "LinphoneCallReleased";
537 return "undefined state";
540 void linphone_call_set_state(LinphoneCall *call, LinphoneCallState cstate, const char *message){
541 LinphoneCore *lc=call->core;
543 if (call->state!=cstate){
544 if (call->state==LinphoneCallEnd || call->state==LinphoneCallError){
545 if (cstate!=LinphoneCallReleased){
546 ms_warning("Spurious call state change from %s to %s, ignored.",linphone_call_state_to_string(call->state),
547 linphone_call_state_to_string(cstate));
551 ms_message("Call %p: moving from state %s to %s",call,linphone_call_state_to_string(call->state),
552 linphone_call_state_to_string(cstate));
553 if (cstate!=LinphoneCallRefered){
554 /*LinphoneCallRefered is rather an event, not a state.
555 Indeed it does not change the state of the call (still paused or running)*/
558 if (cstate==LinphoneCallEnd || cstate==LinphoneCallError){
559 switch(call->reason){
560 case LinphoneReasonDeclined:
561 call->log->status=LinphoneCallDeclined;
563 case LinphoneReasonNotAnswered:
564 call->log->status=LinphoneCallMissed;
569 linphone_call_set_terminated (call);
571 if (cstate == LinphoneCallConnected) {
572 call->log->status=LinphoneCallSuccess;
573 call->media_start_time=time(NULL);
576 if (lc->vtable.call_state_changed)
577 lc->vtable.call_state_changed(lc,call,cstate,message);
578 if (cstate==LinphoneCallReleased){
579 if (call->op!=NULL) {
580 /* so that we cannot have anymore upcalls for SAL
581 concerning this call*/
582 sal_op_release(call->op);
585 linphone_call_unref(call);
590 static void linphone_call_destroy(LinphoneCall *obj)
593 sal_op_release(obj->op);
596 if (obj->resultdesc!=NULL) {
597 sal_media_description_unref(obj->resultdesc);
598 obj->resultdesc=NULL;
600 if (obj->localdesc!=NULL) {
601 sal_media_description_unref(obj->localdesc);
605 sal_op_release(obj->ping_op);
608 ms_free(obj->refer_to);
610 if (obj->owns_call_log)
611 linphone_call_log_destroy(obj->log);
612 if (obj->auth_token) {
613 ms_free(obj->auth_token);
615 if (obj->ice_session) {
616 ice_session_destroy(obj->ice_session);
623 * @addtogroup call_control
628 * Increments the call 's reference count.
629 * An application that wishes to retain a pointer to call object
630 * must use this function to unsure the pointer remains
631 * valid. Once the application no more needs this pointer,
632 * it must call linphone_call_unref().
634 LinphoneCall * linphone_call_ref(LinphoneCall *obj){
640 * Decrements the call object reference count.
641 * See linphone_call_ref().
643 void linphone_call_unref(LinphoneCall *obj){
646 linphone_call_destroy(obj);
651 * Returns current parameters associated to the call.
653 const LinphoneCallParams * linphone_call_get_current_params(const LinphoneCall *call){
654 return &call->current_params;
657 static bool_t is_video_active(const SalStreamDescription *sd){
658 return sd->rtp_port!=0 && sd->dir!=SalStreamInactive;
662 * Returns call parameters proposed by remote.
664 * This is useful when receiving an incoming call, to know whether the remote party
665 * supports video, encryption or whatever.
667 const LinphoneCallParams * linphone_call_get_remote_params(LinphoneCall *call){
668 LinphoneCallParams *cp=&call->remote_params;
669 memset(cp,0,sizeof(*cp));
671 SalMediaDescription *md=sal_call_get_remote_media_description(call->op);
673 SalStreamDescription *asd,*vsd,*secure_asd,*secure_vsd;
675 asd=sal_media_description_find_stream(md,SalProtoRtpAvp,SalAudio);
676 vsd=sal_media_description_find_stream(md,SalProtoRtpAvp,SalVideo);
677 secure_asd=sal_media_description_find_stream(md,SalProtoRtpSavp,SalAudio);
678 secure_vsd=sal_media_description_find_stream(md,SalProtoRtpSavp,SalVideo);
680 cp->has_video=is_video_active(secure_vsd);
681 if (secure_asd || asd==NULL)
682 cp->media_encryption=LinphoneMediaEncryptionSRTP;
684 cp->has_video=is_video_active(vsd);
693 * Returns the remote address associated to this call
696 const LinphoneAddress * linphone_call_get_remote_address(const LinphoneCall *call){
697 return call->dir==LinphoneCallIncoming ? call->log->from : call->log->to;
701 * Returns the remote address associated to this call as a string.
703 * The result string must be freed by user using ms_free().
705 char *linphone_call_get_remote_address_as_string(const LinphoneCall *call){
706 return linphone_address_as_string(linphone_call_get_remote_address(call));
710 * Retrieves the call's current state.
712 LinphoneCallState linphone_call_get_state(const LinphoneCall *call){
717 * Returns the reason for a call termination (either error or normal termination)
719 LinphoneReason linphone_call_get_reason(const LinphoneCall *call){
724 * Get the user_pointer in the LinphoneCall
726 * @ingroup call_control
728 * return user_pointer an opaque user pointer that can be retrieved at any time
730 void *linphone_call_get_user_pointer(LinphoneCall *call)
732 return call->user_pointer;
736 * Set the user_pointer in the LinphoneCall
738 * @ingroup call_control
740 * the user_pointer is an opaque user pointer that can be retrieved at any time in the LinphoneCall
742 void linphone_call_set_user_pointer(LinphoneCall *call, void *user_pointer)
744 call->user_pointer = user_pointer;
748 * Returns the call log associated to this call.
750 LinphoneCallLog *linphone_call_get_call_log(const LinphoneCall *call){
755 * Returns the refer-to uri (if the call was transfered).
757 const char *linphone_call_get_refer_to(const LinphoneCall *call){
758 return call->refer_to;
762 * Returns direction of the call (incoming or outgoing).
764 LinphoneCallDir linphone_call_get_dir(const LinphoneCall *call){
765 return call->log->dir;
769 * Returns the far end's user agent description string, if available.
771 const char *linphone_call_get_remote_user_agent(LinphoneCall *call){
773 return sal_op_get_remote_ua (call->op);
779 * Returns true if this calls has received a transfer that has not been
781 * Pending transfers are executed when this call is being paused or closed,
782 * locally or by remote endpoint.
783 * If the call is already paused while receiving the transfer request, the
784 * transfer immediately occurs.
786 bool_t linphone_call_has_transfer_pending(const LinphoneCall *call){
787 return call->refer_pending;
791 * Returns call's duration in seconds.
793 int linphone_call_get_duration(const LinphoneCall *call){
794 if (call->media_start_time==0) return 0;
795 return time(NULL)-call->media_start_time;
799 * Returns the call object this call is replacing, if any.
800 * Call replacement can occur during call transfers.
801 * By default, the core automatically terminates the replaced call and accept the new one.
802 * This function allows the application to know whether a new incoming call is a one that replaces another one.
804 LinphoneCall *linphone_call_get_replaced_call(LinphoneCall *call){
805 SalOp *op=sal_call_get_replaces(call->op);
807 return (LinphoneCall*)sal_op_get_user_pointer(op);
813 * Indicate whether camera input should be sent to remote end.
815 void linphone_call_enable_camera (LinphoneCall *call, bool_t enable){
817 if (call->videostream!=NULL && call->videostream->ticker!=NULL){
818 LinphoneCore *lc=call->core;
819 MSWebCam *nowebcam=get_nowebcam_device();
820 if (call->camera_active!=enable && lc->video_conf.device!=nowebcam){
821 video_stream_change_camera(call->videostream,
822 enable ? lc->video_conf.device : nowebcam);
825 call->camera_active=enable;
830 * Take a photo of currently received video and write it into a jpeg file.
832 int linphone_call_take_video_snapshot(LinphoneCall *call, const char *file){
834 if (call->videostream!=NULL && call->videostream->jpegwriter!=NULL){
835 return ms_filter_call_method(call->videostream->jpegwriter,MS_JPEG_WRITER_TAKE_SNAPSHOT,(void*)file);
837 ms_warning("Cannot take snapshot: no currently running video stream on this call.");
844 * Returns TRUE if camera pictures are sent to the remote party.
846 bool_t linphone_call_camera_enabled (const LinphoneCall *call){
847 return call->camera_active;
851 * Enable video stream.
853 void linphone_call_params_enable_video(LinphoneCallParams *cp, bool_t enabled){
854 cp->has_video=enabled;
857 const PayloadType* linphone_call_params_get_used_audio_codec(const LinphoneCallParams *cp) {
858 return cp->audio_codec;
861 const PayloadType* linphone_call_params_get_used_video_codec(const LinphoneCallParams *cp) {
862 return cp->video_codec;
866 * Returns whether video is enabled.
868 bool_t linphone_call_params_video_enabled(const LinphoneCallParams *cp){
869 return cp->has_video;
872 enum LinphoneMediaEncryption linphone_call_params_get_media_encryption(const LinphoneCallParams *cp) {
873 return cp->media_encryption;
876 void linphone_call_params_set_media_encryption(LinphoneCallParams *cp, enum LinphoneMediaEncryption e) {
877 cp->media_encryption = e;
882 * Enable sending of real early media (during outgoing calls).
884 void linphone_call_params_enable_early_media_sending(LinphoneCallParams *cp, bool_t enabled){
885 cp->real_early_media=enabled;
888 bool_t linphone_call_params_early_media_sending_enabled(const LinphoneCallParams *cp){
889 return cp->real_early_media;
893 * Returns true if the call is part of the locally managed conference.
895 bool_t linphone_call_params_local_conference_mode(const LinphoneCallParams *cp){
896 return cp->in_conference;
900 * Refine bandwidth settings for this call by setting a bandwidth limit for audio streams.
901 * As a consequence, codecs whose bitrates are not compatible with this limit won't be used.
903 void linphone_call_params_set_audio_bandwidth_limit(LinphoneCallParams *cp, int bandwidth){
904 cp->audio_bw=bandwidth;
909 * Request remote side to send us a Video Fast Update.
911 void linphone_call_send_vfu_request(LinphoneCall *call)
913 if (LinphoneCallStreamsRunning == linphone_call_get_state(call))
914 sal_call_send_vfu_request(call->op);
921 LinphoneCallParams * linphone_call_params_copy(const LinphoneCallParams *cp){
922 LinphoneCallParams *ncp=ms_new0(LinphoneCallParams,1);
923 memcpy(ncp,cp,sizeof(LinphoneCallParams));
930 void linphone_call_params_destroy(LinphoneCallParams *p){
939 #ifdef TEST_EXT_RENDERER
940 static void rendercb(void *data, const MSPicture *local, const MSPicture *remote){
941 ms_message("rendercb, local buffer=%p, remote buffer=%p",
942 local ? local->planes[0] : NULL, remote? remote->planes[0] : NULL);
947 static void video_stream_event_cb(void *user_pointer, const MSFilter *f, const unsigned int event_id, const void *args){
948 LinphoneCall* call = (LinphoneCall*) user_pointer;
949 ms_warning("In linphonecall.c: video_stream_event_cb");
951 case MS_VIDEO_DECODER_DECODING_ERRORS:
952 ms_warning("Case is MS_VIDEO_DECODER_DECODING_ERRORS");
953 linphone_call_send_vfu_request(call);
955 case MS_VIDEO_DECODER_FIRST_IMAGE_DECODED:
956 ms_message("First video frame decoded successfully");
957 if (call->nextVideoFrameDecoded._func != NULL)
958 call->nextVideoFrameDecoded._func(call, call->nextVideoFrameDecoded._user_data);
961 ms_warning("Unhandled event %i", event_id);
967 void linphone_call_set_next_video_frame_decoded_callback(LinphoneCall *call, LinphoneCallCbFunc cb, void* user_data) {
968 call->nextVideoFrameDecoded._func = cb;
969 call->nextVideoFrameDecoded._user_data = user_data;
971 ms_filter_call_method_noarg(call->videostream->decoder, MS_VIDEO_DECODER_RESET_FIRST_IMAGE_NOTIFICATION);
975 void linphone_call_init_audio_stream(LinphoneCall *call){
976 LinphoneCore *lc=call->core;
977 AudioStream *audiostream;
978 int dscp=linphone_core_get_audio_dscp(lc);
980 call->audiostream=audiostream=audio_stream_new(call->audio_port,call->audio_port+1,linphone_core_ipv6_enabled(lc));
982 audio_stream_set_dscp(audiostream,dscp);
983 if (linphone_core_echo_limiter_enabled(lc)){
984 const char *type=lp_config_get_string(lc->config,"sound","el_type","mic");
985 if (strcasecmp(type,"mic")==0)
986 audio_stream_enable_echo_limiter(audiostream,ELControlMic);
987 else if (strcasecmp(type,"full")==0)
988 audio_stream_enable_echo_limiter(audiostream,ELControlFull);
990 audio_stream_enable_gain_control(audiostream,TRUE);
991 if (linphone_core_echo_cancellation_enabled(lc)){
992 int len,delay,framesize;
993 const char *statestr=lp_config_get_string(lc->config,"sound","ec_state",NULL);
994 len=lp_config_get_int(lc->config,"sound","ec_tail_len",0);
995 delay=lp_config_get_int(lc->config,"sound","ec_delay",0);
996 framesize=lp_config_get_int(lc->config,"sound","ec_framesize",0);
997 audio_stream_set_echo_canceller_params(audiostream,len,delay,framesize);
998 if (statestr && audiostream->ec){
999 ms_filter_call_method(audiostream->ec,MS_ECHO_CANCELLER_SET_STATE_STRING,(void*)statestr);
1002 audio_stream_enable_automatic_gain_control(audiostream,linphone_core_agc_enabled(lc));
1004 int enabled=lp_config_get_int(lc->config,"sound","noisegate",0);
1005 audio_stream_enable_noise_gate(audiostream,enabled);
1008 audio_stream_set_features(audiostream,linphone_core_get_audio_features(lc));
1011 RtpTransport *artp=lc->rtptf->audio_rtp_func(lc->rtptf->audio_rtp_func_data, call->audio_port);
1012 RtpTransport *artcp=lc->rtptf->audio_rtcp_func(lc->rtptf->audio_rtcp_func_data, call->audio_port+1);
1013 rtp_session_set_transports(audiostream->session,artp,artcp);
1015 if ((linphone_core_get_firewall_policy(lc) == LinphonePolicyUseIce) && (call->ice_session != NULL)){
1016 rtp_session_set_pktinfo(audiostream->session, TRUE);
1017 rtp_session_set_symmetric_rtp(audiostream->session, FALSE);
1018 audiostream->ice_check_list = ice_session_check_list(call->ice_session, 0);
1019 ice_check_list_set_rtp_session(audiostream->ice_check_list, audiostream->session);
1022 call->audiostream_app_evq = ortp_ev_queue_new();
1023 rtp_session_register_event_queue(audiostream->session,call->audiostream_app_evq);
1026 void linphone_call_init_video_stream(LinphoneCall *call){
1027 #ifdef VIDEO_ENABLED
1028 LinphoneCore *lc=call->core;
1030 if ((lc->video_conf.display || lc->video_conf.capture) && call->params.has_video){
1031 int video_recv_buf_size=lp_config_get_int(lc->config,"video","recv_buf_size",0);
1032 int dscp=linphone_core_get_video_dscp(lc);
1034 call->videostream=video_stream_new(call->video_port,call->video_port+1,linphone_core_ipv6_enabled(lc));
1036 video_stream_set_dscp(call->videostream,dscp);
1037 video_stream_enable_display_filter_auto_rotate(call->videostream, lp_config_get_int(lc->config,"video","display_filter_auto_rotate",0));
1038 if (video_recv_buf_size>0) rtp_session_set_recv_buf_size(call->videostream->session,video_recv_buf_size);
1040 if( lc->video_conf.displaytype != NULL)
1041 video_stream_set_display_filter_name(call->videostream,lc->video_conf.displaytype);
1042 video_stream_set_event_callback(call->videostream,video_stream_event_cb, call);
1044 RtpTransport *vrtp=lc->rtptf->video_rtp_func(lc->rtptf->video_rtp_func_data, call->video_port);
1045 RtpTransport *vrtcp=lc->rtptf->video_rtcp_func(lc->rtptf->video_rtcp_func_data, call->video_port+1);
1046 rtp_session_set_transports(call->videostream->session,vrtp,vrtcp);
1048 if ((linphone_core_get_firewall_policy(lc) == LinphonePolicyUseIce) && (call->ice_session != NULL) && (ice_session_check_list(call->ice_session, 1))){
1049 rtp_session_set_pktinfo(call->videostream->session, TRUE);
1050 rtp_session_set_symmetric_rtp(call->videostream->session, FALSE);
1051 call->videostream->ice_check_list = ice_session_check_list(call->ice_session, 1);
1052 ice_check_list_set_rtp_session(call->videostream->ice_check_list, call->videostream->session);
1054 call->videostream_app_evq = ortp_ev_queue_new();
1055 rtp_session_register_event_queue(call->videostream->session,call->videostream_app_evq);
1056 #ifdef TEST_EXT_RENDERER
1057 video_stream_set_render_callback(call->videostream,rendercb,NULL);
1061 call->videostream=NULL;
1065 void linphone_call_init_media_streams(LinphoneCall *call){
1066 linphone_call_init_audio_stream(call);
1067 linphone_call_init_video_stream(call);
1071 static int dtmf_tab[16]={'0','1','2','3','4','5','6','7','8','9','*','#','A','B','C','D'};
1073 static void linphone_core_dtmf_received(RtpSession* s, int dtmf, void* user_data){
1074 LinphoneCore* lc = (LinphoneCore*)user_data;
1075 if (dtmf<0 || dtmf>15){
1076 ms_warning("Bad dtmf value %i",dtmf);
1079 if (lc->vtable.dtmf_received != NULL)
1080 lc->vtable.dtmf_received(lc, linphone_core_get_current_call(lc), dtmf_tab[dtmf]);
1083 static void parametrize_equalizer(LinphoneCore *lc, AudioStream *st){
1085 MSFilter *f=st->equalizer;
1086 int enabled=lp_config_get_int(lc->config,"sound","eq_active",0);
1087 const char *gains=lp_config_get_string(lc->config,"sound","eq_gains",NULL);
1088 ms_filter_call_method(f,MS_EQUALIZER_SET_ACTIVE,&enabled);
1094 if (sscanf(gains,"%f:%f:%f %n",&g.frequency,&g.gain,&g.width,&bytes)==3){
1095 ms_message("Read equalizer gains: %f(~%f) --> %f",g.frequency,g.width,g.gain);
1096 ms_filter_call_method(f,MS_EQUALIZER_SET_GAIN,&g);
1105 void _post_configure_audio_stream(AudioStream *st, LinphoneCore *lc, bool_t muted){
1106 float mic_gain=lp_config_get_float(lc->config,"sound","mic_gain",1);
1109 float ng_thres=lp_config_get_float(lc->config,"sound","ng_thres",0.05);
1110 float ng_floorgain=lp_config_get_float(lc->config,"sound","ng_floorgain",0);
1111 int dc_removal=lp_config_get_int(lc->config,"sound","dc_removal",0);
1114 audio_stream_set_mic_gain(st,mic_gain);
1116 audio_stream_set_mic_gain(st,0);
1118 recv_gain = lc->sound_conf.soft_play_lev;
1119 if (recv_gain != 0) {
1120 linphone_core_set_playback_gain_db (lc,recv_gain);
1124 ms_filter_call_method(st->volsend,MS_VOLUME_REMOVE_DC,&dc_removal);
1125 float speed=lp_config_get_float(lc->config,"sound","el_speed",-1);
1126 thres=lp_config_get_float(lc->config,"sound","el_thres",-1);
1127 float force=lp_config_get_float(lc->config,"sound","el_force",-1);
1128 int sustain=lp_config_get_int(lc->config,"sound","el_sustain",-1);
1129 float transmit_thres=lp_config_get_float(lc->config,"sound","el_transmit_thres",-1);
1132 if (speed==-1) speed=0.03;
1133 if (force==-1) force=25;
1134 ms_filter_call_method(f,MS_VOLUME_SET_EA_SPEED,&speed);
1135 ms_filter_call_method(f,MS_VOLUME_SET_EA_FORCE,&force);
1137 ms_filter_call_method(f,MS_VOLUME_SET_EA_THRESHOLD,&thres);
1139 ms_filter_call_method(f,MS_VOLUME_SET_EA_SUSTAIN,&sustain);
1140 if (transmit_thres!=-1)
1141 ms_filter_call_method(f,MS_VOLUME_SET_EA_TRANSMIT_THRESHOLD,&transmit_thres);
1143 ms_filter_call_method(st->volsend,MS_VOLUME_SET_NOISE_GATE_THRESHOLD,&ng_thres);
1144 ms_filter_call_method(st->volsend,MS_VOLUME_SET_NOISE_GATE_FLOORGAIN,&ng_floorgain);
1147 /* parameters for a limited noise-gate effect, using echo limiter threshold */
1148 float floorgain = 1/mic_gain;
1149 int spk_agc=lp_config_get_int(lc->config,"sound","speaker_agc_enabled",0);
1150 ms_filter_call_method(st->volrecv, MS_VOLUME_ENABLE_AGC, &spk_agc);
1151 ms_filter_call_method(st->volrecv,MS_VOLUME_SET_NOISE_GATE_THRESHOLD,&ng_thres);
1152 ms_filter_call_method(st->volrecv,MS_VOLUME_SET_NOISE_GATE_FLOORGAIN,&floorgain);
1154 parametrize_equalizer(lc,st);
1157 static void post_configure_audio_streams(LinphoneCall*call){
1158 AudioStream *st=call->audiostream;
1159 LinphoneCore *lc=call->core;
1160 _post_configure_audio_stream(st,lc,call->audio_muted);
1161 if (lc->vtable.dtmf_received!=NULL){
1162 /* replace by our default action*/
1163 audio_stream_play_received_dtmfs(call->audiostream,FALSE);
1164 rtp_session_signal_connect(call->audiostream->session,"telephone-event",(RtpCallback)linphone_core_dtmf_received,(unsigned long)lc);
1168 static RtpProfile *make_profile(LinphoneCall *call, const SalMediaDescription *md, const SalStreamDescription *desc, int *used_pt){
1171 RtpProfile *prof=rtp_profile_new("Call profile");
1174 LinphoneCore *lc=call->core;
1176 const LinphoneCallParams *params=&call->params;
1179 for(elem=desc->payloads;elem!=NULL;elem=elem->next){
1180 PayloadType *pt=(PayloadType*)elem->data;
1183 if ((pt->flags & PAYLOAD_TYPE_FLAG_CAN_SEND) && first) {
1184 if (desc->type==SalAudio){
1185 linphone_core_update_allocated_audio_bandwidth_in_call(call,pt);
1186 if (params->up_ptime)
1187 up_ptime=params->up_ptime;
1188 else up_ptime=linphone_core_get_upload_ptime(lc);
1190 *used_pt=payload_type_get_number(pt);
1193 if (desc->bandwidth>0) remote_bw=desc->bandwidth;
1194 else if (md->bandwidth>0) {
1195 /*case where b=AS is given globally, not per stream*/
1196 remote_bw=md->bandwidth;
1197 if (desc->type==SalVideo){
1198 remote_bw=get_video_bandwidth(remote_bw,call->audio_bw);
1202 if (desc->type==SalAudio){
1203 int audio_bw=call->audio_bw;
1205 if (params->up_bw< audio_bw)
1206 audio_bw=params->up_bw;
1208 bw=get_min_bandwidth(audio_bw,remote_bw);
1209 }else bw=get_min_bandwidth(get_video_bandwidth(linphone_core_get_upload_bandwidth (lc),call->audio_bw),remote_bw);
1210 if (bw>0) pt->normal_bitrate=bw*1000;
1211 else if (desc->type==SalAudio){
1212 pt->normal_bitrate=-1;
1215 up_ptime=desc->ptime;
1219 snprintf(tmp,sizeof(tmp),"ptime=%i",up_ptime);
1220 payload_type_append_send_fmtp(pt,tmp);
1222 number=payload_type_get_number(pt);
1223 if (rtp_profile_get_payload(prof,number)!=NULL){
1224 ms_warning("A payload type with number %i already exists in profile !",number);
1226 rtp_profile_set_payload(prof,number,pt);
1232 static void setup_ring_player(LinphoneCore *lc, LinphoneCall *call){
1233 int pause_time=3000;
1234 audio_stream_play(call->audiostream,lc->sound_conf.ringback_tone);
1235 ms_filter_call_method(call->audiostream->soundread,MS_FILE_PLAYER_LOOP,&pause_time);
1238 #define LINPHONE_RTCP_SDES_TOOL "Linphone-" LINPHONE_VERSION
1240 static bool_t linphone_call_sound_resources_available(LinphoneCall *call){
1241 LinphoneCore *lc=call->core;
1242 LinphoneCall *current=linphone_core_get_current_call(lc);
1243 return !linphone_core_is_in_conference(lc) &&
1244 (current==NULL || current==call);
1246 static int find_crypto_index_from_tag(const SalSrtpCryptoAlgo crypto[],unsigned char tag) {
1248 for(i=0; i<SAL_CRYPTO_ALGO_MAX; i++) {
1249 if (crypto[i].tag == tag) {
1255 static void linphone_call_start_audio_stream(LinphoneCall *call, const char *cname, bool_t muted, bool_t send_ringbacktone, bool_t use_arc){
1256 LinphoneCore *lc=call->core;
1258 /* look for savp stream first */
1259 const SalStreamDescription *stream=sal_media_description_find_stream(call->resultdesc,
1260 SalProtoRtpSavp,SalAudio);
1261 /* no savp audio stream, use avp */
1263 stream=sal_media_description_find_stream(call->resultdesc,
1264 SalProtoRtpAvp,SalAudio);
1266 if (stream && stream->dir!=SalStreamInactive && stream->rtp_port!=0){
1267 MSSndCard *playcard=lc->sound_conf.lsd_card ?
1268 lc->sound_conf.lsd_card : lc->sound_conf.play_sndcard;
1269 MSSndCard *captcard=lc->sound_conf.capt_sndcard;
1270 const char *playfile=lc->play_file;
1271 const char *recfile=lc->rec_file;
1272 call->audio_profile=make_profile(call,call->resultdesc,stream,&used_pt);
1276 call->current_params.audio_codec = rtp_profile_get_payload(call->audio_profile, used_pt);
1277 if (playcard==NULL) {
1278 ms_warning("No card defined for playback !");
1280 if (captcard==NULL) {
1281 ms_warning("No card defined for capture !");
1283 /*Replace soundcard filters by inactive file players or recorders
1284 when placed in recvonly or sendonly mode*/
1285 if (stream->rtp_port==0 || stream->dir==SalStreamRecvOnly){
1288 }else if (stream->dir==SalStreamSendOnly){
1292 /*And we will eventually play "playfile" if set by the user*/
1295 if (send_ringbacktone){
1297 playfile=NULL;/* it is setup later*/
1299 /*if playfile are supplied don't use soundcards*/
1300 if (lc->use_files) {
1304 if (call->params.in_conference){
1305 /* first create the graph without soundcard resources*/
1306 captcard=playcard=NULL;
1308 if (!linphone_call_sound_resources_available(call)){
1309 ms_message("Sound resources are used by another call, not using soundcard.");
1310 captcard=playcard=NULL;
1312 use_ec=captcard==NULL ? FALSE : linphone_core_echo_cancellation_enabled(lc);
1313 if (playcard && stream->max_rate>0) ms_snd_card_set_preferred_sample_rate(playcard, stream->max_rate);
1314 if (captcard && stream->max_rate>0) ms_snd_card_set_preferred_sample_rate(captcard, stream->max_rate);
1315 audio_stream_enable_adaptive_bitrate_control(call->audiostream,use_arc);
1316 audio_stream_enable_adaptive_jittcomp(call->audiostream, linphone_core_audio_adaptive_jittcomp_enabled(lc));
1317 audio_stream_start_full(
1319 call->audio_profile,
1320 stream->rtp_addr[0]!='\0' ? stream->rtp_addr : call->resultdesc->addr,
1322 stream->rtcp_addr[0]!='\0' ? stream->rtcp_addr : call->resultdesc->addr,
1323 linphone_core_rtcp_enabled(lc) ? (stream->rtcp_port) : 0,
1325 linphone_core_get_audio_jittcomp(lc),
1332 post_configure_audio_streams(call);
1333 if (muted && !send_ringbacktone){
1334 audio_stream_set_mic_gain(call->audiostream,0);
1336 if (stream->dir==SalStreamSendOnly && playfile!=NULL){
1338 ms_filter_call_method(call->audiostream->soundread,MS_FILE_PLAYER_LOOP,&pause_time);
1340 if (send_ringbacktone){
1341 setup_ring_player(lc,call);
1343 audio_stream_set_rtcp_information(call->audiostream, cname, LINPHONE_RTCP_SDES_TOOL);
1345 /* valid local tags are > 0 */
1346 if (stream->proto == SalProtoRtpSavp) {
1347 const SalStreamDescription *local_st_desc=sal_media_description_find_stream(call->localdesc,
1348 SalProtoRtpSavp,SalAudio);
1349 int crypto_idx = find_crypto_index_from_tag(local_st_desc->crypto, stream->crypto_local_tag);
1351 if (crypto_idx >= 0) {
1352 audio_stream_enable_strp(
1354 stream->crypto[0].algo,
1355 local_st_desc->crypto[crypto_idx].master_key,
1356 stream->crypto[0].master_key);
1357 call->audiostream_encrypted=TRUE;
1359 ms_warning("Failed to find local crypto algo with tag: %d", stream->crypto_local_tag);
1360 call->audiostream_encrypted=FALSE;
1362 }else call->audiostream_encrypted=FALSE;
1363 if (call->params.in_conference){
1364 /*transform the graph to connect it to the conference filter */
1365 bool_t mute=stream->dir==SalStreamRecvOnly;
1366 linphone_call_add_to_conf(call, mute);
1368 call->current_params.in_conference=call->params.in_conference;
1369 }else ms_warning("No audio stream accepted ?");
1373 static void linphone_call_start_video_stream(LinphoneCall *call, const char *cname,bool_t all_inputs_muted){
1374 #ifdef VIDEO_ENABLED
1375 LinphoneCore *lc=call->core;
1377 /* look for savp stream first */
1378 const SalStreamDescription *vstream=sal_media_description_find_stream(call->resultdesc,
1379 SalProtoRtpSavp,SalVideo);
1380 /* no savp audio stream, use avp */
1382 vstream=sal_media_description_find_stream(call->resultdesc,
1383 SalProtoRtpAvp,SalVideo);
1385 /* shutdown preview */
1386 if (lc->previewstream!=NULL) {
1387 video_preview_stop(lc->previewstream);
1388 lc->previewstream=NULL;
1391 if (vstream!=NULL && vstream->dir!=SalStreamInactive && vstream->rtp_port!=0) {
1392 const char *rtp_addr=vstream->rtp_addr[0]!='\0' ? vstream->rtp_addr : call->resultdesc->addr;
1393 const char *rtcp_addr=vstream->rtcp_addr[0]!='\0' ? vstream->rtcp_addr : call->resultdesc->addr;
1394 call->video_profile=make_profile(call,call->resultdesc,vstream,&used_pt);
1396 call->current_params.video_codec = rtp_profile_get_payload(call->video_profile, used_pt);
1397 VideoStreamDir dir=VideoStreamSendRecv;
1398 MSWebCam *cam=lc->video_conf.device;
1399 bool_t is_inactive=FALSE;
1401 call->current_params.has_video=TRUE;
1403 video_stream_enable_adaptive_bitrate_control(call->videostream,
1404 linphone_core_adaptive_rate_control_enabled(lc));
1405 video_stream_enable_adaptive_jittcomp(call->videostream, linphone_core_video_adaptive_jittcomp_enabled(lc));
1406 video_stream_set_sent_video_size(call->videostream,linphone_core_get_preferred_video_size(lc));
1407 video_stream_enable_self_view(call->videostream,lc->video_conf.selfview);
1408 if (lc->video_window_id!=0)
1409 video_stream_set_native_window_id(call->videostream,lc->video_window_id);
1410 if (lc->preview_window_id!=0)
1411 video_stream_set_native_preview_window_id (call->videostream,lc->preview_window_id);
1412 video_stream_use_preview_video_window (call->videostream,lc->use_preview_window);
1414 if (vstream->dir==SalStreamSendOnly && lc->video_conf.capture ){
1415 cam=get_nowebcam_device();
1416 dir=VideoStreamSendOnly;
1417 }else if (vstream->dir==SalStreamRecvOnly && lc->video_conf.display ){
1418 dir=VideoStreamRecvOnly;
1419 }else if (vstream->dir==SalStreamSendRecv){
1420 if (lc->video_conf.display && lc->video_conf.capture)
1421 dir=VideoStreamSendRecv;
1422 else if (lc->video_conf.display)
1423 dir=VideoStreamRecvOnly;
1425 dir=VideoStreamSendOnly;
1427 ms_warning("video stream is inactive.");
1428 /*either inactive or incompatible with local capabilities*/
1431 if (call->camera_active==FALSE || all_inputs_muted){
1432 cam=get_nowebcam_device();
1435 call->log->video_enabled = TRUE;
1436 video_stream_set_direction (call->videostream, dir);
1437 ms_message("%s lc rotation:%d\n", __FUNCTION__, lc->device_rotation);
1438 video_stream_set_device_rotation(call->videostream, lc->device_rotation);
1439 video_stream_start(call->videostream,
1440 call->video_profile, rtp_addr, vstream->rtp_port,
1441 rtcp_addr, linphone_core_rtcp_enabled(lc) ? (vstream->rtcp_port) : 0,
1442 used_pt, linphone_core_get_video_jittcomp(lc), cam);
1443 video_stream_set_rtcp_information(call->videostream, cname,LINPHONE_RTCP_SDES_TOOL);
1446 if (vstream->proto == SalProtoRtpSavp) {
1447 const SalStreamDescription *local_st_desc=sal_media_description_find_stream(call->localdesc,
1448 SalProtoRtpSavp,SalVideo);
1450 video_stream_enable_strp(
1452 vstream->crypto[0].algo,
1453 local_st_desc->crypto[0].master_key,
1454 vstream->crypto[0].master_key
1456 call->videostream_encrypted=TRUE;
1458 call->videostream_encrypted=FALSE;
1460 }else ms_warning("No video stream accepted.");
1462 ms_warning("No valid video stream defined.");
1467 void linphone_call_start_media_streams(LinphoneCall *call, bool_t all_inputs_muted, bool_t send_ringbacktone){
1468 LinphoneCore *lc=call->core;
1470 call->current_params.audio_codec = NULL;
1471 call->current_params.video_codec = NULL;
1473 LinphoneAddress *me=linphone_core_get_primary_contact_parsed(lc);
1475 bool_t use_arc=linphone_core_adaptive_rate_control_enabled(lc);
1476 #ifdef VIDEO_ENABLED
1477 const SalStreamDescription *vstream=sal_media_description_find_stream(call->resultdesc,
1478 SalProtoRtpAvp,SalVideo);
1481 if ((call->audiostream == NULL) && (call->videostream == NULL)) {
1482 ms_fatal("start_media_stream() called without prior init !");
1485 cname=linphone_address_as_string_uri_only(me);
1487 #if defined(VIDEO_ENABLED)
1488 if (vstream!=NULL && vstream->dir!=SalStreamInactive && vstream->payloads!=NULL){
1489 /*when video is used, do not make adaptive rate control on audio, it is stupid.*/
1493 if (call->audiostream!=NULL) {
1494 linphone_call_start_audio_stream(call,cname,all_inputs_muted,send_ringbacktone,use_arc);
1496 call->current_params.has_video=FALSE;
1497 if (call->videostream!=NULL) {
1498 linphone_call_start_video_stream(call,cname,all_inputs_muted);
1501 call->all_muted=all_inputs_muted;
1502 call->playing_ringbacktone=send_ringbacktone;
1503 call->up_bw=linphone_core_get_upload_bandwidth(lc);
1505 if (call->params.media_encryption==LinphoneMediaEncryptionZRTP) {
1506 OrtpZrtpParams params;
1507 /*will be set later when zrtp is activated*/
1508 call->current_params.media_encryption=LinphoneMediaEncryptionNone;
1510 params.zid_file=lc->zrtp_secrets_cache;
1511 audio_stream_enable_zrtp(call->audiostream,¶ms);
1512 }else if (call->params.media_encryption==LinphoneMediaEncryptionSRTP){
1513 call->current_params.media_encryption=linphone_call_are_all_streams_encrypted(call) ?
1514 LinphoneMediaEncryptionSRTP : LinphoneMediaEncryptionNone;
1517 /*also reflect the change if the "wished" params, in order to avoid to propose SAVP or video again
1518 * further in the call, for example during pause,resume, conferencing reINVITEs*/
1519 linphone_call_fix_call_parameters(call);
1520 if ((call->ice_session != NULL) && (ice_session_state(call->ice_session) != IS_Completed)) {
1521 ice_session_start_connectivity_checks(call->ice_session);
1527 linphone_address_destroy(me);
1530 void linphone_call_start_media_streams_for_ice_gathering(LinphoneCall *call){
1531 audio_stream_prepare_sound(call->audiostream, NULL, NULL);
1532 #ifdef VIDEO_ENABLED
1533 if (call->videostream) {
1534 video_stream_prepare_video(call->videostream);
1539 void linphone_call_delete_ice_session(LinphoneCall *call){
1540 if (call->ice_session != NULL) {
1541 ice_session_destroy(call->ice_session);
1542 call->ice_session = NULL;
1543 if (call->audiostream != NULL) call->audiostream->ice_check_list = NULL;
1544 if (call->videostream != NULL) call->videostream->ice_check_list = NULL;
1545 call->stats[LINPHONE_CALL_STATS_AUDIO].ice_state = LinphoneIceStateNotActivated;
1546 call->stats[LINPHONE_CALL_STATS_VIDEO].ice_state = LinphoneIceStateNotActivated;
1550 static void linphone_call_log_fill_stats(LinphoneCallLog *log, AudioStream *st){
1551 audio_stream_get_local_rtp_stats (st,&log->local_stats);
1552 log->quality=audio_stream_get_average_quality_rating(st);
1555 void linphone_call_stop_media_streams(LinphoneCall *call){
1556 if (call->audiostream!=NULL) {
1557 call->audiostream->ice_check_list = NULL;
1558 rtp_session_unregister_event_queue(call->audiostream->session,call->audiostream_app_evq);
1559 ortp_ev_queue_flush(call->audiostream_app_evq);
1560 ortp_ev_queue_destroy(call->audiostream_app_evq);
1561 call->audiostream_app_evq=NULL;
1563 if (call->audiostream->ec){
1564 const char *state_str=NULL;
1565 ms_filter_call_method(call->audiostream->ec,MS_ECHO_CANCELLER_GET_STATE_STRING,&state_str);
1567 ms_message("Writing echo canceler state, %i bytes",(int)strlen(state_str));
1568 lp_config_set_string(call->core->config,"sound","ec_state",state_str);
1571 linphone_call_log_fill_stats (call->log,call->audiostream);
1572 if (call->endpoint){
1573 linphone_call_remove_from_conf(call);
1575 audio_stream_stop(call->audiostream);
1576 call->audiostream=NULL;
1580 #ifdef VIDEO_ENABLED
1581 if (call->videostream!=NULL){
1582 call->videostream->ice_check_list = NULL;
1583 rtp_session_unregister_event_queue(call->videostream->session,call->videostream_app_evq);
1584 ortp_ev_queue_flush(call->videostream_app_evq);
1585 ortp_ev_queue_destroy(call->videostream_app_evq);
1586 call->videostream_app_evq=NULL;
1587 video_stream_stop(call->videostream);
1588 call->videostream=NULL;
1591 ms_event_queue_skip(call->core->msevq);
1593 if (call->audio_profile){
1594 rtp_profile_clear_all(call->audio_profile);
1595 rtp_profile_destroy(call->audio_profile);
1596 call->audio_profile=NULL;
1598 if (call->video_profile){
1599 rtp_profile_clear_all(call->video_profile);
1600 rtp_profile_destroy(call->video_profile);
1601 call->video_profile=NULL;
1607 void linphone_call_enable_echo_cancellation(LinphoneCall *call, bool_t enable) {
1608 if (call!=NULL && call->audiostream!=NULL && call->audiostream->ec){
1609 bool_t bypass_mode = !enable;
1610 ms_filter_call_method(call->audiostream->ec,MS_ECHO_CANCELLER_SET_BYPASS_MODE,&bypass_mode);
1613 bool_t linphone_call_echo_cancellation_enabled(LinphoneCall *call) {
1614 if (call!=NULL && call->audiostream!=NULL && call->audiostream->ec){
1616 ms_filter_call_method(call->audiostream->ec,MS_ECHO_CANCELLER_GET_BYPASS_MODE,&val);
1619 return linphone_core_echo_cancellation_enabled(call->core);
1623 void linphone_call_enable_echo_limiter(LinphoneCall *call, bool_t val){
1624 if (call!=NULL && call->audiostream!=NULL ) {
1626 const char *type=lp_config_get_string(call->core->config,"sound","el_type","mic");
1627 if (strcasecmp(type,"mic")==0)
1628 audio_stream_enable_echo_limiter(call->audiostream,ELControlMic);
1629 else if (strcasecmp(type,"full")==0)
1630 audio_stream_enable_echo_limiter(call->audiostream,ELControlFull);
1632 audio_stream_enable_echo_limiter(call->audiostream,ELInactive);
1637 bool_t linphone_call_echo_limiter_enabled(const LinphoneCall *call){
1638 if (call!=NULL && call->audiostream!=NULL ){
1639 return call->audiostream->el_type !=ELInactive ;
1641 return linphone_core_echo_limiter_enabled(call->core);
1646 * @addtogroup call_misc
1651 * Returns the measured sound volume played locally (received from remote).
1652 * It is expressed in dbm0.
1654 float linphone_call_get_play_volume(LinphoneCall *call){
1655 AudioStream *st=call->audiostream;
1656 if (st && st->volrecv){
1658 ms_filter_call_method(st->volrecv,MS_VOLUME_GET,&vol);
1662 return LINPHONE_VOLUME_DB_LOWEST;
1666 * Returns the measured sound volume recorded locally (sent to remote).
1667 * It is expressed in dbm0.
1669 float linphone_call_get_record_volume(LinphoneCall *call){
1670 AudioStream *st=call->audiostream;
1671 if (st && st->volsend && !call->audio_muted && call->state==LinphoneCallStreamsRunning){
1673 ms_filter_call_method(st->volsend,MS_VOLUME_GET,&vol);
1677 return LINPHONE_VOLUME_DB_LOWEST;
1681 * Obtain real-time quality rating of the call
1683 * Based on local RTP statistics and RTCP feedback, a quality rating is computed and updated
1684 * during all the duration of the call. This function returns its value at the time of the function call.
1685 * It is expected that the rating is updated at least every 5 seconds or so.
1686 * The rating is a floating point number comprised between 0 and 5.
1688 * 4-5 = good quality <br>
1689 * 3-4 = average quality <br>
1690 * 2-3 = poor quality <br>
1691 * 1-2 = very poor quality <br>
1692 * 0-1 = can't be worse, mostly unusable <br>
1694 * @returns The function returns -1 if no quality measurement is available, for example if no
1695 * active audio stream exist. Otherwise it returns the quality rating.
1697 float linphone_call_get_current_quality(LinphoneCall *call){
1698 if (call->audiostream){
1699 return audio_stream_get_quality_rating(call->audiostream);
1705 * Returns call quality averaged over all the duration of the call.
1707 * See linphone_call_get_current_quality() for more details about quality measurement.
1709 float linphone_call_get_average_quality(LinphoneCall *call){
1710 if (call->audiostream){
1711 return audio_stream_get_average_quality_rating(call->audiostream);
1717 * Access last known statistics for audio stream, for a given call.
1719 const LinphoneCallStats *linphone_call_get_audio_stats(const LinphoneCall *call) {
1720 return &call->stats[LINPHONE_CALL_STATS_AUDIO];
1724 * Access last known statistics for video stream, for a given call.
1726 const LinphoneCallStats *linphone_call_get_video_stats(const LinphoneCall *call) {
1727 return &call->stats[LINPHONE_CALL_STATS_VIDEO];
1735 static void display_bandwidth(RtpSession *as, RtpSession *vs){
1736 ms_message("bandwidth usage: audio=[d=%.1f,u=%.1f] video=[d=%.1f,u=%.1f] kbit/sec",
1737 (as!=NULL) ? (rtp_session_compute_recv_bandwidth(as)*1e-3) : 0,
1738 (as!=NULL) ? (rtp_session_compute_send_bandwidth(as)*1e-3) : 0,
1739 (vs!=NULL) ? (rtp_session_compute_recv_bandwidth(vs)*1e-3) : 0,
1740 (vs!=NULL) ? (rtp_session_compute_send_bandwidth(vs)*1e-3) : 0);
1743 static void linphone_core_disconnected(LinphoneCore *lc, LinphoneCall *call){
1747 from = linphone_call_get_remote_address_as_string(call);
1750 snprintf(temp,sizeof(temp),"Remote end %s seems to have disconnected, the call is going to be closed.",from);
1755 snprintf(temp,sizeof(temp),"Remote end seems to have disconnected, the call is going to be closed.");
1757 if (lc->vtable.display_warning!=NULL)
1758 lc->vtable.display_warning(lc,temp);
1759 linphone_core_terminate_call(lc,call);
1762 static void handle_ice_events(LinphoneCall *call, OrtpEvent *ev){
1763 OrtpEventType evt=ortp_event_get_type(ev);
1764 OrtpEventData *evd=ortp_event_get_data(ev);
1766 if (evt == ORTP_EVENT_ICE_SESSION_PROCESSING_FINISHED) {
1767 switch (ice_session_state(call->ice_session)) {
1769 if (ice_session_role(call->ice_session) == IR_Controlling) {
1770 ice_session_select_candidates(call->ice_session);
1771 linphone_core_update_call(call->core, call, &call->current_params);
1772 linphone_core_update_ice_state_in_call_stats(call);
1776 if (ice_session_has_completed_check_list(call->ice_session) == TRUE) {
1777 if (ice_session_role(call->ice_session) == IR_Controlling) {
1778 /* At least one ICE session has succeeded, so perform a call update. */
1779 ice_session_select_candidates(call->ice_session);
1780 linphone_core_update_call(call->core, call, &call->current_params);
1781 linphone_core_update_ice_state_in_call_stats(call);
1788 } else if (evt == ORTP_EVENT_ICE_GATHERING_FINISHED) {
1790 if (evd->info.ice_processing_successful==TRUE) {
1791 ice_session_compute_candidates_foundations(call->ice_session);
1792 ice_session_eliminate_redundant_candidates(call->ice_session);
1793 ice_session_choose_default_candidates(call->ice_session);
1794 ping_time = ice_session_gathering_duration(call->ice_session);
1795 if (ping_time >=0) {
1796 ping_time /= ice_session_nb_check_lists(call->ice_session);
1799 ms_warning("No STUN answer from [%s], disabling ICE",linphone_core_get_stun_server(call->core));
1800 linphone_call_delete_ice_session(call);
1802 switch (call->state) {
1803 case LinphoneCallStreamsRunning:
1804 linphone_core_start_update_call(call->core, call);
1806 case LinphoneCallUpdatedByRemote:
1807 linphone_core_start_accept_call_update(call->core, call);
1809 case LinphoneCallOutgoingInit:
1810 if (ping_time >= 0) {
1811 linphone_core_adapt_to_network(call->core, ping_time, &call->params);
1813 linphone_call_stop_media_streams(call);
1814 linphone_core_proceed_with_invite_if_ready(call->core, call, NULL);
1817 if (ping_time >= 0) {
1818 linphone_core_adapt_to_network(call->core, ping_time, &call->params);
1820 linphone_call_stop_media_streams(call);
1821 linphone_core_notify_incoming_call(call->core, call);
1824 } else if (evt == ORTP_EVENT_ICE_LOSING_PAIRS_COMPLETED) {
1825 linphone_core_start_accept_call_update(call->core, call);
1826 } else if (evt == ORTP_EVENT_ICE_RESTART_NEEDED) {
1827 ice_session_restart(call->ice_session);
1828 ice_session_set_role(call->ice_session, IR_Controlling);
1829 linphone_core_update_call(call->core, call, &call->current_params);
1833 void linphone_call_background_tasks(LinphoneCall *call, bool_t one_second_elapsed){
1834 LinphoneCore* lc = call->core;
1835 int disconnect_timeout = linphone_core_get_nortp_timeout(call->core);
1836 bool_t disconnected=FALSE;
1838 if (call->state==LinphoneCallStreamsRunning && one_second_elapsed){
1839 RtpSession *as=NULL,*vs=NULL;
1840 float audio_load=0, video_load=0;
1841 if (call->audiostream!=NULL){
1842 as=call->audiostream->session;
1843 if (call->audiostream->ticker)
1844 audio_load=ms_ticker_get_average_load(call->audiostream->ticker);
1846 if (call->videostream!=NULL){
1847 if (call->videostream->ticker)
1848 video_load=ms_ticker_get_average_load(call->videostream->ticker);
1849 vs=call->videostream->session;
1851 display_bandwidth(as,vs);
1852 ms_message("Thread processing load: audio=%f\tvideo=%f",audio_load,video_load);
1854 #ifdef VIDEO_ENABLED
1855 if (call->videostream!=NULL) {
1858 /* Ensure there is no dangling ICE check list. */
1859 if (call->ice_session == NULL) call->videostream->ice_check_list = NULL;
1861 // Beware that the application queue should not depend on treatments fron the
1862 // mediastreamer queue.
1863 video_stream_iterate(call->videostream);
1865 while (call->videostream_app_evq && (NULL != (ev=ortp_ev_queue_get(call->videostream_app_evq)))){
1866 OrtpEventType evt=ortp_event_get_type(ev);
1867 OrtpEventData *evd=ortp_event_get_data(ev);
1868 if (evt == ORTP_EVENT_ZRTP_ENCRYPTION_CHANGED){
1869 linphone_call_videostream_encryption_changed(call, evd->info.zrtp_stream_encrypted);
1870 } else if (evt == ORTP_EVENT_RTCP_PACKET_RECEIVED) {
1871 call->stats[LINPHONE_CALL_STATS_VIDEO].round_trip_delay = rtp_session_get_round_trip_propagation(call->videostream->session);
1872 if(call->stats[LINPHONE_CALL_STATS_VIDEO].received_rtcp != NULL)
1873 freemsg(call->stats[LINPHONE_CALL_STATS_VIDEO].received_rtcp);
1874 call->stats[LINPHONE_CALL_STATS_VIDEO].received_rtcp = evd->packet;
1876 if (lc->vtable.call_stats_updated)
1877 lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_VIDEO]);
1878 } else if (evt == ORTP_EVENT_RTCP_PACKET_EMITTED) {
1879 memcpy(&call->stats[LINPHONE_CALL_STATS_VIDEO].jitter_stats, rtp_session_get_jitter_stats(call->videostream->session), sizeof(jitter_stats_t));
1880 if(call->stats[LINPHONE_CALL_STATS_VIDEO].sent_rtcp != NULL)
1881 freemsg(call->stats[LINPHONE_CALL_STATS_VIDEO].sent_rtcp);
1882 call->stats[LINPHONE_CALL_STATS_VIDEO].sent_rtcp = evd->packet;
1884 if (lc->vtable.call_stats_updated)
1885 lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_VIDEO]);
1886 } else if ((evt == ORTP_EVENT_ICE_SESSION_PROCESSING_FINISHED) || (evt == ORTP_EVENT_ICE_GATHERING_FINISHED)
1887 || (evt == ORTP_EVENT_ICE_LOSING_PAIRS_COMPLETED) || (evt == ORTP_EVENT_ICE_RESTART_NEEDED)) {
1888 handle_ice_events(call, ev);
1890 ortp_event_destroy(ev);
1894 if (call->audiostream!=NULL) {
1897 /* Ensure there is no dangling ICE check list. */
1898 if (call->ice_session == NULL) call->audiostream->ice_check_list = NULL;
1900 // Beware that the application queue should not depend on treatments fron the
1901 // mediastreamer queue.
1902 audio_stream_iterate(call->audiostream);
1904 while (call->audiostream_app_evq && (NULL != (ev=ortp_ev_queue_get(call->audiostream_app_evq)))){
1905 OrtpEventType evt=ortp_event_get_type(ev);
1906 OrtpEventData *evd=ortp_event_get_data(ev);
1907 if (evt == ORTP_EVENT_ZRTP_ENCRYPTION_CHANGED){
1908 linphone_call_audiostream_encryption_changed(call, evd->info.zrtp_stream_encrypted);
1909 } else if (evt == ORTP_EVENT_ZRTP_SAS_READY) {
1910 linphone_call_audiostream_auth_token_ready(call, evd->info.zrtp_sas.sas, evd->info.zrtp_sas.verified);
1911 } else if (evt == ORTP_EVENT_RTCP_PACKET_RECEIVED) {
1912 call->stats[LINPHONE_CALL_STATS_AUDIO].round_trip_delay = rtp_session_get_round_trip_propagation(call->audiostream->session);
1913 if(call->stats[LINPHONE_CALL_STATS_AUDIO].received_rtcp != NULL)
1914 freemsg(call->stats[LINPHONE_CALL_STATS_AUDIO].received_rtcp);
1915 call->stats[LINPHONE_CALL_STATS_AUDIO].received_rtcp = evd->packet;
1917 if (lc->vtable.call_stats_updated)
1918 lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_AUDIO]);
1919 } else if (evt == ORTP_EVENT_RTCP_PACKET_EMITTED) {
1920 memcpy(&call->stats[LINPHONE_CALL_STATS_AUDIO].jitter_stats, rtp_session_get_jitter_stats(call->audiostream->session), sizeof(jitter_stats_t));
1921 if(call->stats[LINPHONE_CALL_STATS_AUDIO].sent_rtcp != NULL)
1922 freemsg(call->stats[LINPHONE_CALL_STATS_AUDIO].sent_rtcp);
1923 call->stats[LINPHONE_CALL_STATS_AUDIO].sent_rtcp = evd->packet;
1925 if (lc->vtable.call_stats_updated)
1926 lc->vtable.call_stats_updated(lc, call, &call->stats[LINPHONE_CALL_STATS_AUDIO]);
1927 } else if ((evt == ORTP_EVENT_ICE_SESSION_PROCESSING_FINISHED) || (evt == ORTP_EVENT_ICE_GATHERING_FINISHED)
1928 || (evt == ORTP_EVENT_ICE_LOSING_PAIRS_COMPLETED) || (evt == ORTP_EVENT_ICE_RESTART_NEEDED)) {
1929 handle_ice_events(call, ev);
1931 ortp_event_destroy(ev);
1934 if (call->state==LinphoneCallStreamsRunning && one_second_elapsed && call->audiostream!=NULL && disconnect_timeout>0 )
1935 disconnected=!audio_stream_alive(call->audiostream,disconnect_timeout);
1937 linphone_core_disconnected(call->core,call);
1940 void linphone_call_log_completed(LinphoneCall *call){
1941 LinphoneCore *lc=call->core;
1943 call->log->duration=time(NULL)-call->start_time;
1945 if (call->log->status==LinphoneCallMissed){
1948 info=ortp_strdup_printf(ngettext("You have missed %i call.",
1949 "You have missed %i calls.", lc->missed_calls),
1951 if (lc->vtable.display_status!=NULL)
1952 lc->vtable.display_status(lc,info);
1955 lc->call_logs=ms_list_prepend(lc->call_logs,(void *)call->log);
1956 if (ms_list_size(lc->call_logs)>lc->max_call_logs){
1957 MSList *elem,*prevelem=NULL;
1958 /*find the last element*/
1959 for(elem=lc->call_logs;elem!=NULL;elem=elem->next){
1963 linphone_call_log_destroy((LinphoneCallLog*)elem->data);
1964 lc->call_logs=ms_list_remove_link(lc->call_logs,elem);
1966 if (lc->vtable.call_log_updated!=NULL){
1967 lc->vtable.call_log_updated(lc,call->log);
1969 call_logs_write_to_config_file(lc);
1972 LinphoneCallState linphone_call_get_transfer_state(LinphoneCall *call) {
1973 return call->transfer_state;
1976 void linphone_call_set_transfer_state(LinphoneCall* call, LinphoneCallState state) {
1977 if (state != call->transfer_state) {
1978 LinphoneCore* lc = call->core;
1979 call->transfer_state = state;
1980 if (lc->vtable.transfer_state_changed)
1981 lc->vtable.transfer_state_changed(lc, call, state);
1985 bool_t linphone_call_is_in_conference(const LinphoneCall *call) {
1986 return call->params.in_conference;