### 安装 PJSUA2 库 在 Windows 平台上使用 Python 3 和 `pjsua2` 开发 SIP 电话客户端，需要先安装适用于 Python 的 `pjsua2` 扩展模块。由于官方并未提供预编译的二进制包，因此需手动从源码构建或下载已构建好的版本。 首先确保已安装 Python 3.x，并且环境变量配置正确。然后从 PJSIP 官方网站下载 pjproject 源码包，并通过 SWIG 工具生成 Python 绑定代码。具体步骤包括： 1. 下载 pjproject 源码并解压。 2. 配置编译环境，例如 Visual Studio。 3. 编译 pjproject 并启用 `PJSUA2` 模块。 4. 使用 SWIG 生成 Python 接口绑定文件。 5. 构建完成后将生成的 `.pyd` 文件复制到 Python 的 `site-packages` 目录中[^1]。 若希望使用现成的扩展，可尝试搜索社区维护的二进制发布包，例如从 PyPI 或 GitHub 上获取第三方构建版本。 ### 引入 pjsua2 模块 在完成安装后，可以通过标准的 `import` 语句引入 `pjsua2` 模块： ```python import pjsua2 as pj ``` 如果遇到模块未找到的错误，应检查是否已将生成的 `.pyd` 文件放置在正确的路径下。此外，Windows 平台可能还需要设置 DLL 路径以确保依赖库能够被正确加载。 ### 初始化 SIP 协议栈 初始化 SIP 协议栈是开发 SIP 客户端的第一步。创建 `Lib` 实例并调用其 `init()` 方法以启动协议栈。此过程可设置日志级别以便调试： ```python lib = pj.Lib() lib.init(logLevel=5) # 设置日志级别为最大值以便调试 ``` 随后需要创建传输层实例，通常使用 UDP 或 TCP 协议监听指定端口： ```python transport_cfg = pj.TransportConfig() transport_cfg.port = 5068 transport = lib.createTransport(pj.PJSIP_TRANSPORT_UDP, transport_cfg) ``` 最后调用 `lib.start()` 启动 SIP 协议栈。 ### 创建 SIP 账户并注册 创建 SIP 账户涉及多个配置项，包括账户 URI、认证信息以及注册服务器地址等： ```python class MyAccount(pj.Account): def onRegState(self, prm): print(f"Registration state: {prm.reason}") acc_cfg = pj.AccountConfig() acc_cfg.idUri = "sip:username@domain.com" acc_cfg.regConfig.registrarUri = "sip:domain.com" auth_cred = pj.AuthCredInfo("digest", "*", "username", 0, "password") acc_cfg.sipConfig.authCreds.append(auth_cred) acc = MyAccount() acc.create(acc_cfg) ``` 该代码片段展示了如何定义一个继承自 `pj.Account` 的类，并实现 `onRegState` 回调函数用于处理注册状态变化。 ### 处理事件循环 由于 `pjsua2` 使用异步事件模型，程序必须持续运行事件处理循环以响应 SIP 协议交互： ```python import time try: while True: lib.handleEvents(10) time.sleep(0.1) except KeyboardInterrupt: pass ``` 退出时应释放相关资源： ```python acc.delete() lib.destroy() ``` ### 注意事项与建议 - 在 Windows 平台部署时，确保所有依赖的 DLL 文件均已正确放置，并且 Python 的模块搜索路径包含所需的 `.pyd` 文件。 - 日志级别可调高用于调试，但在生产环境中应适当降低以减少性能开销。 - 若使用多线程，建议禁用 PJSUA2 的内部线程管理机制，将 `threadCnt` 设置为 0 并仅使用主线程处理事件。