iOS 基于 PJSIP 开发 VOIP 应用 — 编译集成 PJSIP

前言

Telegram 的研究先放一放，在 Telegram 源码中看到了 VOIP 相关功能，不禁想到自己上家公司的业务就是做 VOIP 通讯，趁着现在自己这段时间勤奋劲还没过，特地记录下。

PJSIP 是什么？

PJSIP 是一个用 C 语言编写的开源嵌入式 SIP 协议库，实现了基于标准的协议（如SIP、SDP、RTP，STUN、TURN 和 ICE）；把基于信令协议 SIP 的多媒体框架和 NAT 穿透功能整合成高层次、抽象的多媒体通信 API。

PJSIP 具有非常好的移植性，几乎支持现今所有系统：从桌面系统、嵌入式系统到智能手机。

PJSIP 同时支持语音、视频、状态呈现和即时通讯；PJSIP 具有非常完善的文档，对开发者非常友好。

PJSIP 基本框架

PJSIP 库主要包括：

• SIP 协议栈：处理 SIP 消息
• 流媒体处理模块：RTP / RTCP 等媒体包处理

SIP 协议部分
SIP 协议由下往上进行了多层封装：

• PJSIP -开源的 SIP 协议栈（Open Source SIP stack）
• PJMEDIA - 开源的媒体栈（Open Source Media Stack）
• PJNATH - 开源的 NAT-T 辅助库（Open Source NAT Traversal Helper Library）
• PJLIB-UTIL - 辅助工具库（Auxiliary Library）
• PJLIB - 基础框架库（Ultra Portable Base Framework Library）

对于 PJSIP 有以上基本了解就行，毕竟目前我们主要目的是编译出 iOS 多架构静态库，并导入到我们项目中进行功能开发~

PJSIP 自动化导入

pod 'pjsip'

懒人必备方式，已经有先驱们因为个人需要编译了这个版本：

• 优点：不需要繁琐的手动编译，伸手即得。
• 缺点：并不是官方存储库，且人家已经完成了自己的开发任务，目前停留在了 2.9.1 版本，放弃了维护。

如果需要扩展某些功能，他人编译出来的版本未必会支持，到头来，还是得自己重新编译~

PJSIP 手动编译

官方编译文档点这里

截至目前（2023/01/28）为止，官方能下载的最新版本是 2.13，因此，我将在这个版本上编译。

image.png

一、下载并解压缩

首先，我们去官方下载源代码，推荐下载 .tar.gz 的压缩包。

下载完毕，我们可以将其放到一个合适的目录下（最好路径不包含中文），我这里就是将其放在桌面上；

若你电脑上已经安装了解压缩软件，就可以双击解压缩；没有的话也没关系，我们打开终端，用命令解压缩：

tar -jxvf pjproject-2.13.tar.gz

这样我们就能得到一个名为 pjproject-2.13 的文件夹。

二、编译

这里我已经写好了一个脚本：

#!/bin/sh
touch pjlib/include/pj/config_site.h
echo "#define PJ_CONFIG_IPHONE 1
#define PJ_HAS_IPV6 1
#include 
" > pjlib/include/pj/config_site.h

mkdir -p ./lib

export MIN_IOS="-miphoneos-version-min=8.0"
export DEVPATH=/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer

#编译 i386、x86_64、arm64 3种CPU架构
export ARCH="-arch i386" CFLAGS="-O2 -m32 -mios-simulator-version-min=8.0" LDFLAGS="-O2 -m32 -mios-simulator-version-min=8.0"
./configure-iphone
make dep && make clean && make
export ARCH="-arch x86_64" CFLAGS="-O2 -m64 -mios-simulator-version-min=8.0" LDFLAGS="-O2 -m64 -mios-simulator-version-min=8.0"
./configure-iphone
make dep && make clean && make
export ARCH="-arch arm64"
./configure-iphone
make dep && make clean && make

#合并3种CPU架构的.a库
lipo -arch i386 third_party/lib/libg7221codec-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libg7221codec-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libg7221codec-arm64-apple-darwin_ios.a -create -output lib/libg7221codec.a

lipo -arch i386 third_party/lib/libgsmcodec-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libgsmcodec-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libgsmcodec-arm64-apple-darwin_ios.a -create -output lib/libgsmcodec.a

lipo -arch i386 third_party/lib/libilbccodec-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libilbccodec-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libilbccodec-arm64-apple-darwin_ios.a -create -output lib/libilbccodec.a

lipo -arch i386 pjlib/lib/libpj-i386-apple-darwin_ios.a -arch x86_64 pjlib/lib/libpj-x86_64-apple-darwin_ios.a -arch arm64 pjlib/lib/libpj-arm64-apple-darwin_ios.a -create -output lib/libpj.a

lipo -arch i386 pjlib-util/lib/libpjlib-util-i386-apple-darwin_ios.a -arch x86_64 pjlib-util/lib/libpjlib-util-x86_64-apple-darwin_ios.a -arch arm64 pjlib-util/lib/libpjlib-util-arm64-apple-darwin_ios.a -create -output lib/libpjlib-util.a

lipo -arch i386 pjmedia/lib/libpjmedia-audiodev-i386-apple-darwin_ios.a -arch x86_64 pjmedia/lib/libpjmedia-audiodev-x86_64-apple-darwin_ios.a -arch arm64 pjmedia/lib/libpjmedia-audiodev-arm64-apple-darwin_ios.a -create -output lib/libpjmedia-audiodev.a

lipo -arch i386 pjmedia/lib/libpjmedia-codec-i386-apple-darwin_ios.a -arch x86_64 pjmedia/lib/libpjmedia-codec-x86_64-apple-darwin_ios.a -arch arm64 pjmedia/lib/libpjmedia-codec-arm64-apple-darwin_ios.a -create -output lib/libpjmedia-codec.a

lipo -arch i386 pjmedia/lib/libpjmedia-videodev-i386-apple-darwin_ios.a -arch x86_64 pjmedia/lib/libpjmedia-videodev-x86_64-apple-darwin_ios.a -arch arm64 pjmedia/lib/libpjmedia-videodev-arm64-apple-darwin_ios.a -create -output lib/libpjmedia-videodev.a

lipo -arch i386 pjmedia/lib/libpjmedia-i386-apple-darwin_ios.a -arch x86_64 pjmedia/lib/libpjmedia-x86_64-apple-darwin_ios.a -arch arm64 pjmedia/lib/libpjmedia-arm64-apple-darwin_ios.a -create -output lib/libpjmedia.a

lipo -arch i386 pjnath/lib/libpjnath-i386-apple-darwin_ios.a -arch x86_64 pjnath/lib/libpjnath-x86_64-apple-darwin_ios.a -arch arm64 pjnath/lib/libpjnath-arm64-apple-darwin_ios.a -create -output lib/libpjnath.a

lipo -arch i386 pjsip/lib/libpjsip-simple-i386-apple-darwin_ios.a -arch x86_64 pjsip/lib/libpjsip-simple-x86_64-apple-darwin_ios.a -arch arm64 pjsip/lib/libpjsip-simple-arm64-apple-darwin_ios.a -create -output lib/libpjsip-simple.a

lipo -arch i386 pjsip/lib/libpjsip-ua-i386-apple-darwin_ios.a -arch x86_64 pjsip/lib/libpjsip-ua-x86_64-apple-darwin_ios.a -arch arm64 pjsip/lib/libpjsip-ua-arm64-apple-darwin_ios.a -create -output lib/libpjsip-ua.a

lipo -arch i386 pjsip/lib/libpjsip-i386-apple-darwin_ios.a -arch x86_64 pjsip/lib/libpjsip-x86_64-apple-darwin_ios.a -arch arm64 pjsip/lib/libpjsip-arm64-apple-darwin_ios.a -create -output lib/libpjsip.a

lipo -arch i386 pjsip/lib/libpjsua-i386-apple-darwin_ios.a -arch x86_64 pjsip/lib/libpjsua-x86_64-apple-darwin_ios.a -arch arm64 pjsip/lib/libpjsua-arm64-apple-darwin_ios.a -create -output lib/libpjsua.a

lipo -arch i386 pjsip/lib/libpjsua2-i386-apple-darwin_ios.a -arch x86_64 pjsip/lib/libpjsua2-x86_64-apple-darwin_ios.a -arch arm64 pjsip/lib/libpjsua2-arm64-apple-darwin_ios.a -create -output lib/libpjsua2.a

lipo -arch i386 third_party/lib/libresample-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libresample-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libresample-arm64-apple-darwin_ios.a -create -output lib/libresample.a

lipo -arch i386 third_party/lib/libspeex-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libspeex-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libspeex-arm64-apple-darwin_ios.a -create -output lib/libspeex.a

lipo -arch i386 third_party/lib/libsrtp-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libsrtp-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libsrtp-arm64-apple-darwin_ios.a -create -output lib/libsrtp.a

lipo -arch i386 third_party/lib/libwebrtc-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libwebrtc-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libwebrtc-arm64-apple-darwin_ios.a -create -output lib/libwebrtc.a

lipo -arch i386 third_party/lib/libyuv-i386-apple-darwin_ios.a -arch x86_64 third_party/lib/libyuv-x86_64-apple-darwin_ios.a -arch arm64 third_party/lib/libyuv-arm64-apple-darwin_ios.a -create -output lib/libyuv.a

将该脚本保存为 build-iphone.sh 存放到刚解压完成的 pjproject-2.13 文件夹下，然后执行：

cd pjproject-2.13

进入到 pjproject-2.13 文件夹，接着执行

./build-iphone.sh

如果提示权限不够，那么使用：

chmod 777 build-iphone.sh

来赋予该文件最大的访问权限，接着再次执行：

./build-iphone.sh

执行完后，所有生成的不同架构的静态库都会被合并，且存放在 pjproject-2.13/lib 目录下：

image.png

三、集成

在桌面上新建一个文件夹，名为 PJSIP，将上一步 编译 完成的 lib 文件夹复制到 PJSIP 目录下，并在 PJSIP 文件夹目录下新建一个 includes 文件夹，存放对应的头文件。

image.png

includes 下新建的文件夹，分别存放对应 pjproject-2.13 里相同名字文件夹下的 include 文件。

然后，我们新建一个 iOS 的项目 testPJSIPDemo，将 PJSIP 拖入到项目根目录下，项目结构如图：

image.png

注意：includes 文件夹不要添加到项目中来，只需添加 lib 文件夹，但我们仍需保证上图中的目录结构

image.png

在项目工程配置中，在 targets 为 testPJSIPDemo 的 Build Settings 设置以下配置：

• Header Search Path:

$(PROJECT_DIR)/testPJSIPDemo/PJSIP/includes/pjlib
$(PROJECT_DIR)/testPJSIPDemo/PJSIP/includes/pjlib-util
$(PROJECT_DIR)/testPJSIPDemo/PJSIP/includes/pjmedia
$(PROJECT_DIR)/testPJSIPDemo/PJSIP/includes/pjnath
$(PROJECT_DIR)/testPJSIPDemo/PJSIP/includes/pjsip

• Other Linker Flags 添加 -ObjC
• Preprocessor Macros 添加 PJ_AUTOCONF=1
• Enable Bitcode 设置为 NO

在 Build Phases 中的 Link Binary With Libraries 中添加下面几个 Framework：

• Security
• SystemConfiguration
• VideoToolbox
• AudioToolbox
• AVFoundation
• CFNetwork
• CoreAudio
• CoreFoundation
• CoreImage
• CoreMedia
• CoreVideo
• OpenGLES
• QuartzCore
• Foundation
• CoreGraphics
• UIKit

在 info.plist 添加相机（如果需要视频通话）和使用麦克风所需的权限：

• Privacy - Microphone Usage Description
• Privacy - Camera Usage Description

走完上面的步骤，我们就可以正常的使用 pjsip 库了，Command + B 编译下你的工程，如果有警告或错误，那就说明你的配置可能出现了问题。