Baresip项目中自动发送180 Ringing响应的问题分析与解决方案

问题背景

在Baresip项目中，当接收到一个INVITE请求时，系统会自动发送180 Ringing响应。这一设计在某些场景下会带来问题，因为应用程序无法在发送180 Ringing之前有机会拒绝这个呼叫请求。这种强制性的自动响应机制限制了应用程序对呼叫流程的控制能力。

技术分析

通过深入分析Baresip的源代码，我们发现问题的根源在于call_accept函数中硬编码了180 Ringing响应：

err = sipsess_accept(&call->sess, sess_sock, msg, 180, "Ringing",
                     account_rel100_mode(call->acc),
                     ua_cuser(call->ua), "application/sdp", NULL,
                     auth_handler, call->acc, true,
                     sipsess_offer_handler, sipsess_answer_handler,
                     sipsess_estab_handler, sipsess_info_handler,
                     call->acc->refer ? sipsess_refer_handler : NULL,
                     sipsess_close_handler,
                     call, "Allow: %H\r\n%H",
                     ua_print_allowed, call->ua,
                     ua_print_require, call->ua);

这种设计导致无论应用程序是否需要，系统都会自动发送180 Ringing响应，剥夺了应用程序对呼叫流程的控制权。

解决方案

经过技术讨论和多次迭代，最终确定了以下解决方案：

1. 修改初始响应：将初始响应从180 Ringing改为100 Trying。100 Trying是一个临时响应，表示请求已被接收但尚未被处理，这为应用程序提供了更大的灵活性。

2. 新增API函数：添加call_ringing函数，允许应用程序在需要时显式发送180 Ringing响应：

int call_ringing(struct call *call)
{
    if (!call)
        return EINVAL;

    return sipsess_progress(call->sess, 180, "Ringing",
                account_rel100_mode(call->acc),
                NULL,
                "Allow: %H\r\n%H",
                ua_print_allowed, call->ua,
                ua_print_require, call->ua);
}

3. 修改sipsess_accept调用：将硬编码的180 Ringing改为100 Trying：

err = sipsess_accept(&call->sess, sess_sock, msg, 100, "Trying",
              account_rel100_mode(call->acc),
              ua_cuser(call->ua), "application/sdp", NULL,
              auth_handler, call->acc, true,
              sipsess_offer_handler, sipsess_answer_handler,
              sipsess_estab_handler, sipsess_info_handler,
              call->acc->refer ? sipsess_refer_handler : NULL,
              sipsess_close_handler,
              call, NULL);

实现细节

1. sipsess_accept修改：需要调整sipsess_accept函数以接受100状态码：

if (!sessp || !sock || !msg || scode < 100 || scode > 299 ||
    !cuser || !ctype)
    return EINVAL;

2. 菜单模块集成：在菜单模块中，当检测到需要播放振铃音时，显式调用call_ringing：

if (adelay == -1) {
    call_ringing(call);
    play_incoming(call);
}

技术优势

1. 更好的流程控制：应用程序现在可以完全控制何时发送180 Ringing响应，甚至可以选择不发送。

2. 符合SIP规范：100 Trying响应是SIP协议中的标准临时响应，不会影响协议兼容性。

3. 保持现有功能：自动应答功能仍然可以正常工作，只是响应机制更加灵活。

4. API一致性：新增的call_ringing函数与现有的call_progress等函数保持一致的风格。

结论

这一改进显著增强了Baresip项目在呼叫控制方面的灵活性，使应用程序能够更好地管理呼叫流程。通过将自动发送180 Ringing改为可选的显式调用，开发者现在可以根据具体需求实现更复杂的呼叫处理逻辑，同时保持了系统的稳定性和兼容性。这种设计也更符合SIP协议的设计理念，即提供灵活的呼叫控制能力。