前言
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
,因此,我将在这个版本上编译。
一、下载并解压缩
首先,我们去官方下载源代码,推荐下载 .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 <pj/config_site_sample.h>
" > 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
文件夹,存放对应的头文件。
includes
下新建的文件夹,分别存放对应 pjproject-2.13
里相同名字文件夹下的 include
文件。
然后,我们新建一个 iOS 的项目 testPJSIPDemo
,将 PJSIP
拖入到项目根目录下,项目结构如图:
注意:includes 文件夹不要添加到项目中来,只需添加 lib 文件夹,但我们仍需保证上图中的目录结构
在项目工程配置中,在 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
编译下你的工程,如果有警告或错误,那就说明你的配置可能出现了问题。
网友评论