📚 课程目录第1章课程导论与基础环境搭建

1. 课程导论与基础环境搭建：WebRTC在嵌入式设备中的架构概览、核心组件介绍、开发环境搭建

各位同学，欢迎来到《嵌入式WebRTC通话质量监控与日志分析调试与故障定位实战》的第一章。

我是你们这门课的主讲。做了十几年嵌入式通信，从早期的2G模块一路折腾到现在的音视频实时传输，踩过的坑比走过的路还多。说实话，WebRTC在嵌入式设备上跑起来，跟它在PC浏览器上完全是两码事。资源受限、网络不稳定、交叉编译链配置能让人崩溃——但这些恰恰是我们要啃的硬骨头。

这一章，我们先搭好台子。台子搭不稳，后面唱戏全得翻车。

1.1 WebRTC在嵌入式设备中的架构概览

先看一张整体架构图。这张图我建议你存下来，后面每一章都会跟它打交道。

从上往下看，一共四层。应用层是你写的业务代码，核心引擎层是WebRTC的C++库，嵌入式适配层是我们今天要重点关注的——它负责把标准WebRTC嫁接到你的硬件上。最底下是操作系统和硬件。

我在一个安防项目里遇到过，同样的WebRTC代码在x86上跑得飞起，换到ARM开发板上就各种花屏、断流。查了三天，最后发现是适配层的内存池没对齐硬件缓存行。这种问题，没有架构图你根本无从下手。

1.2 核心组件介绍

嵌入式WebRTC的核心组件，我按功能分成三块来讲。

组件	作用	嵌入式注意事项
PeerConnection	管理点对点连接的生命周期	内存占用大，嵌入式需控制并发数
SDP协商	交换编解码、网络等能力信息	嵌入式设备编解码能力有限，需裁剪SDP
ICE/STUN/TURN	NAT穿透与中继	嵌入式网络环境复杂，TURN带宽成本高
DTLS/SRTP	信令加密与媒体加密	加解密计算开销大，需硬件加速
音频编解码	Opus/G.711等	Opus质量好但CPU占用高，G.711省资源
视频编解码	H.264/VP8等	H.264硬件编码器在嵌入式上更常见

我的经验：嵌入式设备上，PeerConnection 的数量不要超过4-6个。我见过有人试图在树莓派3B上同时建立8路连接，结果CPU直接飙到100%，画面卡成PPT。做产品设计时，一定要算好并发上限。

1.3 开发环境搭建

好，理论说完了，咱们动手。环境搭建分两条路：树莓派本地编译 和 交叉编译。我建议初学者先用树莓派本地编译，跑通了再上交叉编译。

1.3.1 树莓派本地编译环境

我用的是树莓派4B，4GB内存版本。系统推荐Raspberry Pi OS (64-bit)。

更新系统
```
sudo apt update && sudo apt upgrade -y
```

安装依赖

sudo apt install -y \
  git cmake ninja-build python3-pip \
  libx11-dev libxext-dev libxrender-dev \
  libasound2-dev libpulse-dev \
  libv4l-dev libavcodec-dev libavformat-dev \
  libavutil-dev libswscale-dev

获取WebRTC源码

mkdir ~/webrtc && cd ~/webrtc
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH=$PATH:$PWD/depot_tools
fetch --nohooks webrtc
gclient sync

这一步很慢，建议挂代理或者晚上跑。我第一次拉取用了将近4个小时。

编译

cd ~/webrtc/src
gn gen out/Release --args='is_debug=false target_cpu="arm64"'
ninja -C out/Release

⚠️ 注意：树莓派内存只有4GB，编译WebRTC时内存会吃满。我建议你关掉桌面环境，用 sudo systemctl set-default multi-user.target 切换到命令行模式，能省出不少内存。另外，编译时加 -j2 限制并行任务数，防止OOM。

1.3.2 交叉编译链搭建

如果你跟我一样，觉得树莓派上编译太慢，那就上交叉编译。在PC上编译，生成ARM架构的可执行文件，再传到板子上跑。

我常用的交叉编译链是 gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu。下载地址我就不贴了，你搜一下就能找到。

# 解压到 /opt
sudo tar xvf gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt

# 设置环境变量
export PATH=$PATH:/opt/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin
export CC=aarch64-none-linux-gnu-gcc
export CXX=aarch64-none-linux-gnu-g++

# 编译WebRTC
cd ~/webrtc/src
gn gen out/CrossRelease --args='is_debug=false target_cpu="arm64" target_os="linux" \
  arm_arch="armv8-a" arm_use_neon=true \
  use_rtti=true use_custom_libcxx=false'
ninja -C out/CrossRelease

关键点：交叉编译时，target_cpu="arm64" 和 arm_arch="armv8-a" 必须跟你板子的CPU架构一致。树莓派4B是Cortex-A72，ARMv8-A架构，支持NEON指令集。如果你用的是其他板子，先查清楚CPU型号。

1.3.3 验证环境

编译完成后，写一个简单的测试程序，验证WebRTC库能否正常工作。

// test_webrtc.cpp
#include <rtc_base/logging.h>
#include <rtc_base/ssl_adapter.h>

int main() {
  rtc::LogMessage::LogToDebug(rtc::LS_INFO);
  RTC_LOG(LS_INFO) << "WebRTC environment is ready!";
  
  rtc::InitializeSSL();
  RTC_LOG(LS_INFO) << "SSL initialized successfully.";
  
  rtc::CleanupSSL();
  return 0;
}

编译命令：

aarch64-none-linux-gnu-g++ test_webrtc.cpp -I~/webrtc/src \
  -L~/webrtc/src/out/CrossRelease/obj \
  -lwebrtc -o test_webrtc -lpthread -ldl

把生成的可执行文件传到树莓派上运行：

scp test_webrtc pi@192.168.1.100:~/
ssh pi@192.168.1.100
./test_webrtc

如果看到 WebRTC environment is ready! 和 SSL initialized successfully.，恭喜你，环境搭好了。

避坑指南：我曾经在交叉编译时忘了链接 -lpthread -ldl，结果程序在板子上运行时报段错误。查了半天才发现是动态链接库没带上。建议你用 file test_webrtc 确认一下可执行文件是ARM架构的，再用 ldd test_webrtc 检查依赖库是否齐全。

1.4 本章小结

这一章我们干了三件事：

理清了嵌入式WebRTC的四层架构，知道每一层负责什么
认识了核心组件，特别是嵌入式环境下要特别注意的点
亲手搭好了开发环境，本地编译和交叉编译两条路都走通了

环境搭好只是第一步。下一章开始，我们会真正进入通话质量监控的世界——怎么采集数据、怎么看指标、怎么定位问题。那些才是实战中的硬仗。

但今天，先把环境跑通。跑不通的话，后面全是纸上谈兵。