linphone源码分析----初始化部分

这几天比较轻松，所以打算好好来看看linphone的代码，源码版本为3.5.2。从linphone初始化的过程开始，首先来看linphone_core_new函数。　

LinphoneCore *linphone_core_new(const LinphoneCoreVTable *vtable,
						const char *config_path, const char *factory_config_path, void * userdata)
{
	LinphoneCore *core=ms_new(LinphoneCore,1);
	linphone_core_init(core,vtable,config_path, factory_config_path, userdata);
	return core;
}

主要工作基本上在函数linphone_core_init中实现

static void linphone_core_init (LinphoneCore * lc, const LinphoneCoreVTable *vtable, const char *config_path,
    const char *factory_config_path, void * userdata)
{
	memset (lc, 0, sizeof (LinphoneCore));
	lc->data=userdata;
	lc->ringstream_autorelease=TRUE;


	memcpy(&lc->vtable,vtable,sizeof(LinphoneCoreVTable));  //保存了回调函数表


	linphone_core_set_state(lc,LinphoneGlobalStartup,"Starting up");  //设置linphone内部状态
	ortp_init();  //ortp模块初始化
	lc->dyn_pt=96;  //负载类型从96开始都是动态负载类型
	linphone_core_assign_payload_type(lc,&payload_type_pcmu8000,0,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_gsm,3,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_pcma8000,8,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_speex_nb,110,"vbr=on");
	linphone_core_assign_payload_type(lc,&payload_type_speex_wb,111,"vbr=on");
	linphone_core_assign_payload_type(lc,&payload_type_speex_uwb,112,"vbr=on");
	linphone_core_assign_payload_type(lc,&payload_type_telephone_event,101,"0-11");
	linphone_core_assign_payload_type(lc,&payload_type_g722,9,NULL);


#if defined(ANDROID) || defined (__IPHONE_OS_VERSION_MIN_REQUIRED)
	/*shorten the DNS lookup time and send more retransmissions on mobiles:
	 - to workaround potential packet losses
	 - to avoid hanging for 30 seconds when the network doesn't work despite the phone thinks it does.
	 */
	_linphone_core_configure_resolver();
#endif


#ifdef ENABLE_NONSTANDARD_GSM
	{
		PayloadType *pt;
		pt=payload_type_clone(&payload_type_gsm);
		pt->clock_rate=11025;
		linphone_core_assign_payload_type(lc,pt,-1,NULL);
		pt->clock_rate=22050;
		linphone_core_assign_payload_type(lc,pt,-1,NULL);
		payload_type_destroy(pt);
	}
#endif


#ifdef VIDEO_ENABLED
	linphone_core_assign_payload_type(lc,&payload_type_h263,34,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_theora,97,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_h263_1998,98,"CIF=1;QCIF=1");
	linphone_core_assign_payload_type(lc,&payload_type_mp4v,99,"profile-level-id=3");
	linphone_core_assign_payload_type(lc,&payload_type_h264,102,"profile-level-id=428014");
	linphone_core_assign_payload_type(lc,&payload_type_vp8,103,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_x_snow,-1,NULL);
	/* due to limited space in SDP, we have to disable this h264 line which is normally no more necessary */
	/* linphone_core_assign_payload_type(&payload_type_h264,-1,"packetization-mode=1;profile-level-id=428014");*/
#endif


    //下面的这些负载类型，没有指定类型号
	/*add all payload type for which we don't care about the number */
	linphone_core_assign_payload_type(lc,&payload_type_ilbc,-1,"mode=30");
	linphone_core_assign_payload_type(lc,&payload_type_amr,-1,"octet-align=1");
        linphone_core_assign_payload_type(lc,&payload_type_amrwb,-1,"octet-align=1");
	linphone_core_assign_payload_type(lc,&payload_type_lpc1015,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_g726_16,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_g726_24,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_g726_32,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_g726_40,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_16,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_24,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_32,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_aal2_g726_40,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_silk_nb,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_silk_mb,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_silk_wb,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_silk_swb,-1,NULL);
	linphone_core_assign_payload_type(lc,&payload_type_g729,18,"annexb=no");
	
	ms_init();  //初始化mediastreamer模块
	/* create a mediastreamer2 event queue and set it as global */
	/* This allows to run event's callback in linphone_core_iterate() */
	lc->msevq=ms_event_queue_new();  //事件队列，linphone_core_iterate函数中取出事件并调用相应的回调函数
	ms_set_global_event_queue(lc->msevq);  //队列指针保存到一个全局的变量ms_global_event_queue里


	lc->config=lp_config_new(config_path);  //读取配置文件，config保存的是一个ini文档，类似xml文档　　
	if (factory_config_path)  //出厂配置文件是只读的，用于恢复出厂配置
		lp_config_read_file(lc->config,factory_config_path);


	lc->sal=sal_init();  //初始化exosip模块，sal是什么的缩写呢？
	sal_set_user_pointer(lc->sal,lc);
	sal_set_callbacks(lc->sal,&linphone_sal_callbacks);  //设置sal回调函数


	sip_setup_register_all();  //这里将加载所有插件
	sound_config_read(lc);  //读取音频相关配置
	net_config_read(lc);  //读取网络相关配置
	rtp_config_read(lc);  //读取rtp相关配置
	codecs_config_read(lc);  //读取编码器相关配置
	sip_config_read(lc);   //读取sip协议相关配置，/* this will start eXosip*/
	video_config_read(lc);　//视频相关配置
	//autoreplier_config_init(&lc->autoreplier_conf);
	lc->presence_mode=LinphoneStatusOnline;  //在线、离线，还是其它
	misc_config_read(lc);  //配置最大历史记录条数等
	ui_config_read(lc);  //读取联系人(朋友)，读取通话记录
#ifdef TUNNEL_ENABLED
	lc->tunnel=linphone_core_tunnel_new(lc);
	if (lc->tunnel) linphone_tunnel_configure(lc->tunnel);
#endif
	if (lc->vtable.display_status)
		lc->vtable.display_status(lc,_("Ready"));  //更新状态
	lc->auto_net_state_mon=lc->sip_conf.auto_net_state_mon;
	linphone_core_set_state(lc,LinphoneGlobalOn,"Ready");  //这里将会调用状态改变的回调函数
}

上面的代码做了大量的工作，分配负载类型，初始化了各子模块，如ortp、sal(对exosip的封装吧)、mediastream2，加载了所有的插件，最后读取配置文件。

再来看看分配负载类型的函数linphone_core_assign_payload_type的实现

static void linphone_core_assign_payload_type(LinphoneCore *lc, PayloadType *const_pt, int number, const char *recv_fmtp){
	PayloadType *pt;
	pt=payload_type_clone(const_pt);


    //找一个未分配的负载类型码，分配给本负载类型
	if (number==-1){
		/*look for a free number */
		MSList *elem;
		int i;
		for(i=lc->dyn_pt;i<=127;++i){
			bool_t already_assigned=FALSE;
			for(elem=lc->payload_types;elem!=NULL;elem=elem->next){
				PayloadType *it=(PayloadType*)elem->data;
				if (payload_type_get_number(it)==i){
					already_assigned=TRUE;
					break;
				}
			}
			if (!already_assigned){
				number=i;
				lc->dyn_pt=i+1;
				break;
			}
		}
		if (number==-1){
			ms_fatal("FIXME: too many codecs, no more free numbers.");
		}
	}
	ms_message("assigning %s/%i payload type number %i",pt->mime_type,pt->clock_rate,number);
	payload_type_set_number(pt,number);
	if (recv_fmtp!=NULL) payload_type_set_recv_fmtp(pt,recv_fmtp);
	rtp_profile_set_payload(&av_profile,number,pt);  //将负载类型的对应关系保存到全局的RtpProfile结构中
	lc->payload_types=ms_list_append(lc->payload_types,pt);  //将支持的负载类型添加到链表中
}