pjsip在ARM架构Android设备移植完整示例

pjsip在ARM架构Android设备移植实战：从零构建VoIP通信引擎

你有没有遇到过这样的场景？客户要求在一款老旧的ARMv7 Android工业平板上实现SIP对讲功能，而市面上的SDK要么不支持、要么太臃肿。这时候，pjsip就成了你的“救命稻草”——一个轻量、灵活、完全可控的开源SIP协议栈。

但问题来了：如何把用C写成的pjsip，成功编译进Java/Kotlin主导的Android世界里？特别是面对ARM架构的交叉编译坑点、NDK配置迷雾和JNI胶水代码的调试噩梦？

别急。本文将带你一步步穿越这些技术雷区，手把手完成一次完整的pjsip移植实战。这不是理论推演，而是我踩了整整两周坑后总结出的可复现、能落地、避得开90%常见错误的全流程指南。

为什么是pjsip？不只是因为“它能跑”

在开始动手前，先回答一个灵魂拷问：为什么不直接用商业SDK，非得折腾原生库？

答案很简单：控制力。

• 商业SDK黑盒封装，一旦出现音频卡顿或注册失败，你连日志都看不到；
• 很多只支持x86模拟器，在真机上跑不动；
• 功能冗余，APK体积暴涨几十MB；
• 许可费用高昂，不适合IoT类低成本设备。

而pjsip不同：

• 完全开源，代码透明，可深度定制；
• 支持ARMv5到ARM64全系列架构；
• 模块化设计，可以裁剪到仅几MB静态库；
• 社区活跃，文档齐全（虽然有点老）；
• 和WebRTC共用同一套媒体处理逻辑，未来扩展性强。

更重要的是，它已经在无数门禁机、POS终端、车载系统中稳定运行多年。只要你能把它“请进来”，就能拥有一个真正属于自己的VoIP内核。

准备你的武器库：环境搭建不是走过场

很多人第一步就栽在环境上。你以为装个Android Studio就行？远远不够。

必须组件清单

⚠️ 切记不要使用太旧的NDK（如r16以前），否则会遇到__ANDROID_API__宏定义冲突等问题。

环境变量设置（Linux/macOS）

export ANDROID_NDK_ROOT=/home/user/Android/Sdk/ndk/25.1.8937393 export PATH=$PATH:$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/bin

这里的路径要根据你实际安装位置调整。最关键的是LLVM工具链路径，它是现代NDK的核心编译器。

验证是否生效：

aarch64-linux-android21-clang --version # 应输出Clang版本信息

如果你还在用GCC，赶紧升级。Google早在NDK r18起就全面转向Clang了。

下载与初步配置：别急着make，先做减法

进入正题。

git clone https://github.com/pjsip/pjproject.git pjproject cd pjproject

拿到源码后第一件事不是configure，而是思考：我要哪些功能？

大多数嵌入式应用根本不需要视频、SSL加密、AMR编码这些重型模块。盲目全量编译只会让你陷入链接错误和内存爆炸的泥潭。

创建pjlib/include/pj/config_site.h

这是pjsip的“定制开关文件”。创建它并填入以下内容：

#define PJ_CONFIG_ANDROID 1 #include <pj/config_site_sample.h> // 关闭视频支持 #define PJMEDIA_HAS_VIDEO 0 // 关闭SSL/TLS（除非你需要SIPS） #define PJ_HAS_SSL_SOCK 0 // 关闭Opencore AMR（节省空间） #define PJMEDIA_HAS_OPENCORE_AMRNB 0 #define PJMEDIA_HAS_OPENCORE_AMRWB 0 // 关闭GSM codec（一般不用） #define PJMEDIA_HAS_GSM_CODEC 0 // 日志等级：3=INFO, 4=WARN, 5=ERR（生产环境建议设为3） #define PJ_LOG_MAX_LEVEL 3 // 禁用堆栈检查（Android上意义不大） #define PJ_OS_HAS_CHECK_STACK 0 // 关闭额外断言（提升性能） #define PJ_ENABLE_EXTRA_CHECK 0 // 启用NEON优化（ARM专用加速） #define PJ_ARMV7_NEON 1 // 使用OpenSL ES作为音频后端 #define PJMEDIA_AUDIO_DEV_MODE (PJMEDIA_AUD_DEV_CAP_OUTPUT | PJMEDIA_AUD_DEV_CAP_INPUT) #define PJMEDIA_USE_OPENSL_DEV 1

这份配置能让最终生成的库体积减少约40%，同时避免大量依赖缺失问题。

编写自动化构建脚本：告别手动敲命令

接下来是最关键一步：交叉编译。

pjsip原生并不认识Android NDK，所以我们需要告诉它：“你现在是在给Android ARM平台干活”。

写一个configure-android.sh

#!/bin/bash # 设置NDK路径（请修改为你自己的） export ANDROID_NDK_ROOT=/home/user/Android/Sdk/ndk/25.1.8937393 export TARGET_ABI=armeabi-v7a export ANDROID_API=21 # 工具链路径 TOOLCHAIN=$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64 # 目标三元组 TARGET_HOST=arm-linux-androideabi TARGET_TRIPLE=armv7a-linux-androideabi echo "Configuring pjsip for Android ARMv7..." ./configure \ --host=$TARGET_HOST \ --target=$TARGET_TRIPLE$ANDROID_API \ --with-ndk=$ANDROID_NDK_ROOT \ --use-ndk-cflags \ --disable-video \ --disable-sound \ --disable-opencore-amr \ --disable-gsm-codec \ --disable-speex-codec \ --disable-ilbc-codec \ --enable-shared=no \ --prefix=$(pwd)/output/$TARGET_ABI \ CC=$TOOLCHAIN/bin/armv7a-linux-androideabi$ANDROID_API-clang \ CXX=$TOOLCHAIN/bin/armv7a-linux-androideabi$ANDROID_API-clang++ \ LD=$TOOLCHAIN/bin/ld echo "Configuration complete. Now run: make dep && make -j8"

几点说明：

• --use-ndk-cflags是关键，它让pjsip自动引入NDK的标准头文件路径；
• CC和CXX必须指向LLVM下的clang，命名规则为：<arch>-linux-androideabi<api>-clang；
• --disable-sound并非真的关闭声音，而是禁用ALSA/OSS等Linux声音子系统，因为我们打算用OpenSL ES替代；
• -j8表示并行编译线程数，根据自己CPU核心数调整。

保存后加执行权限：

chmod +x configure-android.sh

然后运行：

./configure-android.sh make dep && make clean && make -j8

如果一切顺利，你会看到一堆.a文件出现在pjsip/lib/目录下：

libpjsua2-a.a libpjsip-ua.a libpjmedia-a.a libpjnath-a.a ...

恭喜，你已经拥有了能在ARM Android上运行的静态库！

封装JNI接口：打通Java与C++的“任督二脉”

现在库有了，但Android App是Java写的，怎么调？

答案就是JNI（Java Native Interface）。

我们需要写一层“胶水代码”，把pjsip的C++ API暴露给Java层调用。

先定义Java接口类

// org.pjsip.PjSipService.java package org.pjsip; public class PjSipService { static { System.loadLibrary("pjsip-jni"); // 对应 libpjsip-jni.so } public native void nativeInit(); public native void nativeStart(); public native void nativeRegister(String sipUri, String password); public native void nativeCall(String dstUri); public native void nativeHangup(); }

这个类加载名为pjsip-jni的动态库，并声明几个核心方法。

实现JniSipStack.cpp

#include <jni.h> #include <android/log.h> #include <pjsua2.hpp> #define LOG_TAG "PJSIP-JNI" #define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__) #define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__) using namespace pj; // 自定义Account类用于接收事件 class MyAccount : public Account { public: virtual void onRegState(OnRegStateParam &param) override { if (param.code == PJSIP_SC_OK) { LOGI("✅ SIP注册成功"); } else { LOGE("❌ 注册失败: %d %s", param.code, param.reason.c_str()); } } virtual void onCallState(OnCallStateParam &param) override { CallInfo ci = getCall()->getInfo(); LOGI("📞 通话状态: %s", ci.stateText.c_str()); } virtual void onCallMediaState(OnCallMediaStateParam &param) override { Call *call = getCurrentCall(); if (!call) return; CallInfo ci = call->getInfo(); if (ci.mediaStatus == PJSUA_CALL_MEDIA_ACTIVE) { AudioMedia *am = call->getAudioMedia(0); Endpoint::instance().audDevManager().getCaptureDeviceMedia()->startTransmit(*am); am->startTransmit(*Endpoint::instance().audDevManager().getPlaybackDeviceMedia()); LOGI("🎙️ 媒体通道已激活"); } } }; // 全局实例 Endpoint ep; MyAccount *acc = nullptr; extern "C" JNIEXPORT void JNICALL Java_org_pjsip_PjSipService_nativeInit(JNIEnv *env, jobject thiz) { try { EpConfig epCfg; ep.libCreate(); // 配置日志 epCfg.logConfig.level = 3; epCfg.logConfig.consoleLevel = 3; // 音频配置 AudDevManager& adm = epCfg.medConfig.audDevManager; adm.setNoDevApi(true); // 使用OpenSL ES ep.libInit(epCfg); LOGI("📌 pjsip初始化完成"); } catch (Error &e) { LOGE("💥 初始化失败: %s", e.info().c_str()); } } extern "C" JNIEXPORT void JNICALL Java_org_pjsip_PjSipService_nativeStart(JNIEnv *env, jobject thiz) { try { ep.libStart(); LOGI("🚀 pjsip事件循环启动"); } catch (Error &e) { LOGE("💥 启动失败: %s", e.info().c_str()); } } extern "C" JNIEXPORT void JNICALL Java_org_pjsip_PjSipService_nativeRegister(JNIEnv *env, jobject thiz, jstring sipUri, jstring passwd) { const char *uri = env->GetStringUTFChars(sipUri, nullptr); const char *pwd = env->GetStringUTFChars(passwd, nullptr); if (!acc) acc = new MyAccount(); try { AccountConfig cfg; cfg.setIdUri(std::string(uri)); cfg.getNatConfig().setIceEnabled(true); AuthCredInfo cred("digest", "*", std::string(pwd), 0); cfg.getSipConfig().authCreds.push_back(cred); acc->create(cfg); LOGI("🔗 正在注册: %s", uri); } catch (Error &e) { LOGE("💥 注册异常: %s", e.info().c_str()); } env->ReleaseStringUTFChars(sipUri, uri); env->ReleaseStringUTFChars(passwd, pwd); }

这段代码实现了最基本的SIP注册流程，并通过Android日志系统输出状态。你可以根据需求扩展来电回调、语音播放控制等功能。

集成进Android项目：最后一步不能错

回到Android Studio工程。

添加原生库和头文件

将以下内容复制到src/main/cpp目录下：

├── include/ # 所有pjsip头文件 │ └── pj/ ├── lib/ │ └── armeabi-v7a/ │ ├── libpjsua2-a.a │ ├── libpjmedia-a.a │ └── ...（所有.a文件） └── JniSipStack.cpp

配置CMakeLists.txt

cmake_minimum_required(VERSION 3.18) project(pjsip-jni LANGUAGES CXX) # 启用C++17 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED TRUE) # 包含目录 include_directories( ${CMAKE_SOURCE_DIR}/include ) # 查找OpenSL ES find_library(log-lib log) find_library(android-lib android) find_library(opensl-lib OpenSLES) # 添加静态库 add_library(pjsip-core STATIC IMPORTED) set_target_properties(pjsip-core PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/lib/${ANDROID_ABI}/libpjsua2-a.a) # 创建共享库 add_library(pjsip-jni SHARED JniSipStack.cpp ) # 链接 target_link_libraries(pjsip-jni pjsip-core ${log-lib} ${android-lib} ${opensl-lib} )

修改build.gradle(app)

android { compileSdk 34 defaultConfig { applicationId "org.example.voipdemo" minSdk 21 targetSdk 34 versionCode 1 versionName "1.0" ndk { abiFilters 'armeabi-v7a' } externalNativeBuild { cmake { cppFlags "-frtti -fexceptions" } } } externalNativeBuild { cmake { path "src/main/cpp/CMakeLists.txt" } } }

别忘了在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> <uses-permission android:name="android.permission.WAKE_LOCK" />

调试技巧与常见坑点

你以为到这里就完了？不，真正的挑战才刚开始。

❌ 编译报错 “undefined reference to dlsym”

原因：某些pjsip模块尝试动态加载符号，但Android上需显式链接dl库。

解决：在CMakeLists.txt中加入：

find_library(dl-lib dl) target_link_libraries(pjsip-jni ... ${dl-lib})

🐢 音频延迟高、断续

排查方向：
- 检查Jitter Buffer是否启用：epCfg.medConfig.jbMaxLateRate = 60;
- RTP包大小设为20ms帧；
- 使用G.711或OPUS编码，避免低效编解码器；
- 在config_site.h中开启NEON优化。

🔒 注册失败，NAT穿透不了

解决方案：
在AccountConfig中添加STUN服务器：

cfg.getNatConfig().stunServer = "stun.pjsip.org"; cfg.getNatConfig().setIceEnabled(true); cfg.getNatConfig().setTurnEnabled(true);

或者部署私有STUN/TURN服务更安全。

🔋 CPU占用过高

• 关闭调试日志（PJ_LOG_MAX_LEVEL=3）；
• 使用Release模式编译（APP_OPTIM := release）；
• 减少定时器轮询频率；
• 启用DTX（静音抑制）降低网络负载。

写在最后：这只是一个开始

当你第一次看到“Registration successful”出现在Logcat中时，那种成就感难以言喻。

但这仅仅是个起点。pjsip的强大之处在于它的可塑性：

• 可以接入WebRTC网关，实现跨平台互通；
• 结合AI降噪算法（如RNNoise），提升嘈杂环境下的通话质量；
• 实现多账号并发注册；
• 支持ZRTP加密保障隐私；
• 与ZigBee/Wi-Fi IoT设备联动，打造智能语音交互系统。

而这一切的基础，就是你现在亲手构建的这个小小的.so文件。

掌握pjsip在ARM Android上的移植能力，意味着你不再依赖任何第三方黑盒SDK。你可以深入每一行代码，优化每一个缓冲区，掌控每一次RTP封包。

这才是真正的技术自由。

如果你在移植过程中遇到了其他问题，欢迎留言交流。我可以分享完整的编译产物、CMake模板和测试APK。让我们一起把实时通信做得更简单、更可控。