Qt + pjsip客户端注册：如何创建SIP账号？

是否要用pjsip_regc_create()？ #

pjsip_regc_create()是PJSIP底层注册客户端模块的创建方法，如果你打算手动实现SIP注册的完整流程（包括处理注册请求、响应、超时重传等细节），可以用它。但如果是快速开发SIP客户端，更推荐用pjsua（C语言高层封装）或pjsua2（C++面向对象封装）——这两个API已经封装了注册、呼叫等常用功能，不用自己处理底层细节。

如果你确定要基于底层API实现，pjsip_regc_create()是合适的入口。

pjsip_regc_create()使用示例（结合Qt） #

以下是基础的使用框架，注意PJSIP的操作需要先完成库初始化，且建议在独立线程中运行（避免阻塞Qt UI线程）：

1. 初始化PJSIP基础环境 #

#include <pjsip.h>
#include <pjsip_regc.h>
#include <pjlib.h>
#include <QDebug>

// 可封装为类成员，避免全局变量
pjsip_endpoint *g_endpt = nullptr;
pjsip_regc *g_regc = nullptr;
pj_pool_t *g_pool = nullptr;

pj_status_t init_pjsip() {
    pj_status_t status;

    // 初始化PJLib核心库
    status = pj_init();
    if (status != PJ_SUCCESS) return status;

    // 创建内存池工厂
    pj_caching_pool cp;
    pj_caching_pool_init(&cp, &pj_pool_factory_default_policy, 0);

    // 创建SIP端点（Endpoint）
    status = pjsip_endpt_create(&cp.factory, nullptr, &g_endpt);
    if (status != PJ_SUCCESS) return status;

    // 初始化SIP模块
    status = pjsip_init(g_endpt);
    if (status != PJ_SUCCESS) return status;

    // 启动SIP事件循环（放在独立线程，避免阻塞UI）
    pj_thread_t *thread;
    status = pj_thread_create(g_pool, "sip-worker", 
                              [](void *arg) {
                                  pjsip_endpt_handle_events((pjsip_endpoint*)arg, NULL);
                                  return nullptr;
                              },
                              g_endpt, 0, 0, &thread);
    return status;
}

2. 创建注册客户端并发起注册 #

// 注册状态回调函数，处理注册结果
static void regc_callback(pjsip_regc *regc, pjsip_regc_event *event) {
    switch (event->type) {
        case PJSIP_REGC_STATE_CHANGED:
            if (event->state == PJSIP_REGC_STATE_REGISTERED) {
                qDebug() << "[SIP] 账号注册成功";
            } else if (event->state == PJSIP_REGC_STATE_UNREGISTERED) {
                qDebug() << "[SIP] 账号已注销";
            } else {
                qDebug() << "[SIP] 注册状态变化：" << event->state;
            }
            break;
        default:
            break;
    }
}

pj_status_t create_sip_account(const QString &sip_uri, const QString &reg_server, const QString &username, const QString &password) {
    pj_status_t status;

    // 创建专属内存池
    g_pool = pj_pool_create(g_endpt->pf, "regc-pool", 4096, 4096, nullptr);

    // 创建注册客户端实例
    status = pjsip_regc_create(g_endpt, regc_callback, nullptr, &g_regc);
    if (status != PJ_SUCCESS) return status;

    // 初始化注册参数结构体
    pjsip_regc_info reg_info;
    pjsip_regc_info_init(&reg_info);

    // 设置SIP账号URI
    pj_str_t sip_uri_str = pj_str((char*)sip_uri.toUtf8().data());
    status = pjsip_parse_uri(g_pool, &sip_uri_str, PJSIP_URI_IN_REQ_URI, &reg_info.acc_uri);
    if (status != PJ_SUCCESS) return status;

    // 设置注册服务器地址
    pj_str_t reg_server_str = pj_str((char*)reg_server.toUtf8().data());
    status = pjsip_regc_set_reg_server(g_regc, &reg_server_str);
    if (status != PJ_SUCCESS) return status;

    // 设置账号认证信息
    pjsip_cred_info cred;
    pj_str_t user_str = pj_str((char*)username.toUtf8().data());
    pj_str_t pass_str = pj_str((char*)password.toUtf8().data());
    pjsip_cred_info_init(&cred, nullptr, &user_str, &pass_str, PJSIP_CRED_DATA_PLAIN_PASSWD);
    status = pjsip_regc_set_credentials(g_regc, 1, &cred);
    if (status != PJ_SUCCESS) return status;

    // 发起注册（有效期300秒，自动刷新）
    status = pjsip_regc_register(g_regc, 300, PJ_TRUE);
    return status;
}

3. 在Qt UI中调用（比如按钮点击事件） #

void MainWindow::on_registerBtn_clicked() {
    // 替换为实际的SIP账号信息
    QString sipUri = "sip:test_account@your_sip_server.com";
    QString regServer = "sip:your_sip_server.com:5060";
    QString username = "test_account";
    QString password = "test_pass";

    // 初始化PJSIP
    pj_status_t status = init_pjsip();
    if (status != PJ_SUCCESS) {
        qDebug() << "PJSIP初始化失败：" << status;
        return;
    }

    // 创建并注册账号
    status = create_sip_account(sipUri, regServer, username, password);
    if (status != PJ_SUCCESS) {
        qDebug() << "SIP账号注册失败：" << status;
    }
}

关键注意事项 #

• 线程隔离：PJSIP的事件循环必须在独立线程运行，不能阻塞Qt UI线程，否则会导致界面卡顿无响应。
• 资源清理：程序退出时，记得调用pjsip_regc_unregister()、pjsip_regc_destroy()、pjsip_destroy()、pj_shutdown()等方法释放资源，避免内存泄漏。
• 错误排查：PJSIP的pj_status_t返回值对应具体错误码，可通过pj_strerror()函数转换为可读信息，方便调试。

内容的提问来源于stack exchange，提问作者Muhx