Sofia-SIP 是一个开源的 SIP 协议栈,广泛用于 VoIP 和即时通讯应用。以下是一些基本的使用教程,帮助你快速上手 Sofia-SIP。
1. 安装 Sofia-SIP
首先,你需要安装 Sofia-SIP 库。你可以从其官方 GitHub 仓库克隆源代码并编译安装:
git clone https://github.com/doubango/sofia-sip.git
cd sofia-sip
./bootstrap.sh
./configure
make
sudo make install
2. 初始化 Sofia-SIP
在使用 Sofia-SIP 之前,需要初始化库并创建一个 NUA(Network Unified Access)对象。NUA 是 Sofia-SIP 的核心对象,用于管理 SIP 会话。
#include <sofia-sip/su.h>
#include <sofia-sip/nua.h>int main() {su_root_t *root;nua_t *nua;// 初始化 SU 根root = su_root_create(NULL);if (!root) {fprintf(stderr, "Failed to create SU root\n");return -1;}// 创建 NUA 对象nua = nua_create(root, NULL, NULL, 0, NULL, NULL);if (!nua) {fprintf(stderr, "Failed to create NUA object\n");su_root_destroy(root);return -1;}// 运行事件循环su_root_run(root);// 清理资源nua_destroy(nua);su_root_destroy(root);return 0;
}
3. 注册 SIP 用户
注册 SIP 用户涉及发送 REGISTER 请求。以下是一个简单的示例:
#include <sofia-sip/su.h>
#include <sofia-sip/nua.h>
#include <sofia-sip/sip.h>void register_callback(nua_event_t event, int status, char const *phrase, nua_t *nua, nua_magic_t *magic, nua_handle_t *nh, sip_t const *sip, tagi_t tags[]) {if (status == 200) {printf("Registration successful\n");} else {printf("Registration failed: %d %s\n", status, phrase);}
}int main() {su_root_t *root;nua_t *nua;nua_handle_t *nh;// 初始化 SU 根root = su_root_create(NULL);if (!root) {fprintf(stderr, "Failed to create SU root\n");return -1;}// 创建 NUA 对象nua = nua_create(root, NULL, NULL, 0, NULL, NULL);if (!nua) {fprintf(stderr, "Failed to create NUA object\n");su_root_destroy(root);return -1;}// 创建 NUA 句柄nh = nua_handle(nua, NULL, NUTAG_URL("sip:example.com"), TAG_END());if (!nh) {fprintf(stderr, "Failed to create NUA handle\n");nua_destroy(nua);su_root_destroy(root);return -1;}// 发送 REGISTER 请求nua_register(nh, NUTAG_URL("sip:alice@example.com"), SIPTAG_TO_STR("sip:alice@example.com"), SIPTAG_FROM_STR("sip:alice@example.com"), SIPTAG_CONTACT_STR("sip:alice@192.168.1.100"), SIPTAG_EXPIRES_STR("3600"), NUTAG_REGISTRAR("sip:example.com"), TAG_END());// 运行事件循环su_root_run(root);// 清理资源nua_handle_destroy(nh);nua_destroy(nua);su_root_destroy(root);return 0;
}
4. 处理 SIP 消息
Sofia-SIP 提供了丰富的回调机制来处理 SIP 消息。你可以在回调函数中处理各种 SIP 事件,例如来电、挂断等
void incoming_call_callback(nua_event_t event, int status, char const *phrase, nua_t *nua, nua_magic_t *magic, nua_handle_t *nh, sip_t const *sip, tagi_t tags[]) {if (event == NUA_I_INVITE) {printf("Incoming call from %s\n", sip->sip_from->a_url->url_user);// 接受来电nua_respond(nh, SIP_200_OK, SIPTAG_TO(sip->sip_to), TAG_END());}
}int main() {su_root_t *root;nua_t *nua;nua_handle_t *nh;// 初始化 SU 根root = su_root_create(NULL);if (!root) {fprintf(stderr, "Failed to create SU root\n");return -1;}// 创建 NUA 对象nua = nua_create(root, incoming_call_callback, NULL, 0, NULL, NULL);if (!nua) {fprintf(stderr, "Failed to create NUA object\n");su_root_destroy(root);return -1;}// 创建 NUA 句柄nh = nua_handle(nua, NULL, NUTAG_URL("sip:example.com"), TAG_END());if (!nh) {fprintf(stderr, "Failed to create NUA handle\n");nua_destroy(nua);su_root_destroy(root);return -1;}// 运行事件循环su_root_run(root);// 清理资源nua_handle_destroy(nh);nua_destroy(nua);su_root_destroy(root);return 0;
}
5. 发送 SIP 消息
发送 SIP 消息(例如 INVITE 请求)可以通过 nua_invite
函数实现
void invite_callback(nua_event_t event, int status, char const *phrase, nua_t *nua, nua_magic_t *magic, nua_handle_t *nh, sip_t const *sip, tagi_t tags[]) {if (event == NUA_R_INVITE) {if (status == 200) {printf("Call established\n");} else {printf("Call failed: %d %s\n", status, phrase);}}
}int main() {su_root_t *root;nua_t *nua;nua_handle_t *nh;// 初始化 SU 根root = su_root_create(NULL);if (!root) {fprintf(stderr, "Failed to create SU root\n");return -1;}// 创建 NUA 对象nua = nua_create(root, invite_callback, NULL, 0, NULL, NULL);if (!nua) {fprintf(stderr, "Failed to create NUA object\n");su_root_destroy(root);return -1;}// 创建 NUA 句柄nh = nua_handle(nua, NULL, NUTAG_URL("sip:example.com"), TAG_END());if (!nh) {fprintf(stderr, "Failed to create NUA handle\n");nua_destroy(nua);su_root_destroy(root);return -1;}// 发送 INVITE 请求nua_invite(nh, NUTAG_URL("sip:bob@example.com"), SIPTAG_TO_STR("sip:bob@example.com"), SIPTAG_FROM_STR("sip:alice@example.com"), SIPTAG_CONTACT_STR("sip:alice@192.168.1.100"), TAG_END());// 运行事件循环su_root_run(root);// 清理资源nua_handle_destroy(nh);nua_destroy(nua);su_root_destroy(root);return 0;
}
6. 错误处理
在实际应用中,错误处理是非常重要的。Sofia-SIP 提供了详细的错误代码和描述,你可以在回调函数中进行处理。
void error_callback(nua_event_t event, int status, char const *phrase, nua_t *nua, nua_magic_t *magic, nua_handle_t *nh, sip_t const *sip, tagi_t tags[]) {if (status != 200) {printf("Error: %d %s\n", status, phrase);}
}int main() {su_root_t *root;nua_t *nua;nua_handle_t *nh;// 初始化 SU 根root = su_root_create(NULL);if (!root) {fprintf(stderr, "Failed to create SU root\n");return -1;}// 创建 NUA 对象nua = nua_create(root, error_callback, NULL, 0, NULL, NULL);if (!nua) {fprintf(stderr, "Failed to create NUA object\n");su_root_destroy(root);return -1;}// 创建 NUA 句柄nh = nua_handle(nua, NULL, NUTAG_URL("sip:example.com"), TAG_END());if (!nh) {fprintf(stderr, "Failed to create NUA handle\n");nua_destroy(nua);su_root_destroy(root);return -1;}// 发送 INVITE 请求nua_invite(nh, NUTAG_URL("sip:bob@example.com"), SIPTAG_TO_STR("sip:bob@example.com"), SIPTAG_FROM_STR("sip:alice@example.com"), SIPTAG_CONTACT_STR("sip:alice@192.168.1.100"), TAG_END());// 运行事件循环su_root_run(root);// 清理资源nua_handle_destroy(nh);nua_destroy(nua);su_root_destroy(root);return 0;
}