pjsip学习笔记

1、pjsip 是否采用 srtp 来传输媒体流是由两方面控制的：

（1）、pjsip是否支持 srtp 协议：

在 pjsua_call_media_init 中首先判断是采用 ICE 还是 UDP：

if (pjsua_var.media_cfg.enable_ice) {
	    status = create_ice_media_transport(tcfg, call_med, async);
            if (async && status == PJ_EPENDING) {
	        /* We will resume call media initialization in the
	         * on_ice_complete() callback.
	         */
                call_med->med_create_cb = &call_media_init_cb;
                call_med->med_init_cb = cb;

	        return PJ_EPENDING;
	    }
	} else {
	    status = create_udp_media_transport(tcfg, call_med);
	}

在该函数最后调用 call_media_init_cb，而该函数中则会强制采用 SRTP 覆盖之前的设定：

#if defined(PJMEDIA_HAS_SRTP) && (PJMEDIA_HAS_SRTP != 0)
    /* This function may be called when SRTP transport already exists
     * (e.g: in re-invite, update), don't need to destroy/re-create.
     */
    if (!call_med->tp_orig) {
	pjmedia_srtp_setting srtp_opt;
	pjmedia_transport *srtp = NULL;

	/* Check if SRTP requires secure signaling */
	if (acc->cfg.use_srtp != PJMEDIA_SRTP_DISABLED) {
	    if (security_level < acc->cfg.srtp_secure_signaling) {
		err_code = PJSIP_SC_NOT_ACCEPTABLE;
		status = PJSIP_ESESSIONINSECURE;
		goto on_return;
	    }
	}

	/* Always create SRTP adapter */
	pjmedia_srtp_setting_default(&srtp_opt);
	srtp_opt.close_member_tp = PJ_TRUE;

	/* If media session has been ever established, let's use remote's 
	 * preference in SRTP usage policy, especially when it is stricter.
	 */
	if (call_med->rem_srtp_use > acc->cfg.use_srtp)
	    srtp_opt.use = call_med->rem_srtp_use;
	else
	    srtp_opt.use = acc->cfg.use_srtp;

	status = pjmedia_transport_srtp_create(pjsua_var.med_endpt,
					       call_med->tp,
					       &srtp_opt, &srtp);
	if (status != PJ_SUCCESS) {
	    err_code = PJSIP_SC_INTERNAL_SERVER_ERROR;
	    goto on_return;
	}

	/* Set SRTP as current media transport */
	call_med->tp_orig = call_med->tp;
	call_med->tp = srtp;
    }
#else
    call_med->tp_orig = call_med->tp;
    PJ_UNUSED_ARG(security_level);
#endif

由此可见，要禁用 SRTP，则必须将宏定义 PJMEDIA_HAS_SRTP 删除或定义为 0。

（2）、在传输媒体流的时候是否使用 SRTP：

srtp->bypass_srtp 是控制是否采用 SRTP 来传输媒体流的变量。首先，stream.c 中的函数 put_frame_imp 调用 pjmedia_transport_send_rtp，该函数中的回调函数（即 stream->transport->op->send_rtp）指向 transport_srtp.c 中的 transport_send_rtp 函数。当srtp->bypass_srtp = 1 的时候，transport_srtp.c 中的 transport_send_rtp 函数调用 pjmedia_transport_send_rtp，而此时该函数中的回调函数（即 stream->transport->member_tp->op->send_rtp）指向的就是 transport_udp.c 中的 transport_send_rtp 函数。因此，这种情况下并没有采用 SRTP 来传输媒体流，此时与直接使用 UDP 传输等效。

 

2、SRTP bypass 模式接收到对方媒体数据后的回调：

首先，stream.c 文件中的 pjmedia_stream_create 函数调用 pjmedia_transport_attach，该函数中的回调函数（即 tp->op->attach）指向 transport_srtp.c 中的 transport_attach，并将 stream.c 文件中的 on_rx_rtp 作为收到媒体数据后的回调传下去。

然后，transport_srtp.c 文件中的 transport_attach 函数调用 pjmedia_transport_attach，该函数中的回调函数（即 srtp->member_tp->op->attach）指向 transport_udp.c 中的 transport_attach，并将 transport_srtp.c 文件中的 srtp_rtp_cb 作为收到媒体数据后的回调传下去。

这样，当 transport_udp.c 收到对方的媒体数据的时候就会去调用 transport_srtp.c 文件中的 srtp_rtp_cb，而 srtp_rtp_cb 则会调用 srtp->rtp_cb。srtp->rtp_cb 指向的则是 stream.c 中的 on_rx_rtp。

即收到对方媒体数据后最终调用的回调函数是 stream.c 中的 on_rx_rtp。

 

3、windows平台下的声音采集和播放：

 

功能	实现函数	所在文件	调用函数
注册设备	pjmedia_aud_subsys_init	audiodev.c	pjmedia_endpt_create
初始化设备	factory_init	wmme_dev.c	init_driver
启动设备	factory_create_stream	wmme_dev.c	pjmedia_aud_stream_create
启动媒体流	stream_start	wmme_dev.c	pjmedia_aud_stream_start
声音采集	wmme_dev_thread	wmme_dev.c	单独线程
声音播放	wmme_dev_thread	wmme_dev.c	单独线程

“启动设备”阶段，factory_create_stream 调用 init_player_stream 创建声音回放的内核事件，调用 init_capture_stream 创建声音采集的内核事件，而 wmme_dev_thread 中对这些事件进行循环监听，监听到有内核事件发生（声音回放、采集或退出监听线程）后就执行该事件。

退出监听线程事件也是在 factory_create_stream 中创建的，相应代码为：

    /* Create the stop event */
    strm->thread_quit_event = CreateEvent(NULL, FALSE, FALSE, NULL);

退出监听线程事件的触发是在 stream_destroy 中完成的，相应代码为：

SetEvent(stream->thread_quit_event);