PJProject 自定义 Call-ID 功能解析

功能背景

在SIP协议中，Call-ID是一个重要的头部字段，用于唯一标识一个SIP会话。传统的PJProject实现中，Call-ID是由系统自动生成的UUID格式字符串，开发者无法自定义这个值。然而在某些特定场景下，业务系统可能需要使用自定义的Call-ID来实现特定的业务逻辑或与现有系统集成。

技术实现

PJProject最新版本通过扩展CallSetting结构体，增加了对自定义Call-ID的支持。这一功能改动主要涉及三个关键部分的代码：

1. pjsua_call.c：在创建UAC对话框时，检查是否有用户指定的Call-ID，若有则覆盖系统自动生成的Call-ID值。

2. pjsua.h：在pjsua_call_setting结构体中新增了user_call_id字段，用于存储用户自定义的Call-ID字符串。

3. call.cpp：在C++高级API中增加了对自定义Call-ID的封装，使得开发者可以通过CallSetting类方便地设置自定义Call-ID。

使用示例

在C++高级API中使用自定义Call-ID非常简单：

CallOpParam callOpParam;
callOpParam.opt.user_call_id = "2141242143543543"; // 设置自定义Call-ID
call->makeCall(destinationFull.toStdString(), callOpParam); // 发起呼叫

技术价值

1. 系统集成能力：允许业务系统使用已有的会话标识符，便于与现有系统对接。

2. 调试便利性：开发者可以使用有意义的Call-ID值，便于日志分析和问题排查。

3. 业务逻辑支持：某些特定业务场景可能需要基于Call-ID实现特定的业务逻辑。

4. 兼容性保证：该实现完全兼容SIP协议规范，不会影响协议的互操作性。

实现注意事项

1. 字符串长度：自定义Call-ID的长度应符合SIP协议规范，避免过长导致协议解析问题。

2. 唯一性保证：虽然可以自定义Call-ID，但仍需确保其唯一性，避免会话冲突。

3. 默认行为：当不设置自定义Call-ID时，系统仍会使用自动生成的UUID作为Call-ID。

4. 日志记录：实现中加入了调试日志，便于开发者确认自定义Call-ID是否被正确应用。

这一功能的加入使得PJProject在保持原有稳定性的同时，增加了更多灵活性，能够满足更复杂的业务场景需求。