MetaRTC 跨平台 WebRTC SDK 开发入门指南
MetaRTC 是一个纯 C 语言实现的跨平台 WebRTC SDK，专为嵌入式系统和物联网应用设计。与传统的 WebRTC 实现相比，MetaRTC 具有更小的资源占用和更高的可移植性，是开发实时音视频应用的理想选择。
项目架构深度解析
MetaRTC 采用模块化设计，核心组件分布清晰，各模块职责分明：
. ├── 📂 codec // 音视频编解码核心引擎
│ └── 📂 yangwincodec // Windows 平台专属编解码器
├── 📂 demo // 实战示例程序宝库
├── 📂 include // API 接口头文件集合
├── 📂 libmetartc7 // 主库功能实现
└── 📂 libmetartccore7 // 底层核心算法库
核心模块功能说明
libmetartccore7（纯 C 实现）
- WebRTC 协议栈完整实现
- AEC/ANS/AGC 等音视频处理算法
- 底层网络传输和媒体处理
libmetartc7（C++ 实现）
- 音视频采集、编码、解码、传输、渲染
- 推流和拉流功能封装
- 高级 API 接口
快速环境搭建
获取源代码
git clone <repository_url>
cd metaRTC
编译核心库
Linux/Android 平台：
./cmake_lib_x64.sh # x86_64 架构
./cmake_lib_android.sh # Android 平台
./cmake_arm.sh // ARM64 架构
Windows 平台：
- 使用 Visual Studio：打开
project_msvc/metaRTC7.sln - 使用 Qt（MSVC）：打开
libmetartccore7/libmetartccore7.pro
macOS/iOS 平台：
- 使用 Xcode：打开
project_xcode/
核心配置文件详解
MetaRTC 的性能调优主要通过 yang_config.ini 文件实现：
音频配置（[audio]）
sample=48000 # 采样率
channel=2 # 声道数
bitrate=128 # 码率（kbps）
hasAec=1 # 是否启用回声消除
audioEncoderType=3 # 音频编码器类型
视频配置（[video]）
width=640 # 视频宽度
height=480 # 视频高度
rate=2048 # 视频码率（kbps）
frame=30 # 帧率
videoEncoderType=0 # 视频编码器类型
RTC 配置（[rtc]）
iceServerIP=10.42.0.1 # ICE 服务器地址
rtcLocalPort=16000 # 本地端口
usingDatachannel=0 # 是否启用数据通道
实战示例程序
Qt 演示程序编译
推流演示：
cd demo/metapushstream7
qmake metapushstream7.pro
make
播放器演示：
cd demo/metaplayer7
qmake metaplayer7.pro
make
Android 演示程序
- 使用 Android Studio IDE（API 29）
- 项目路径：
demo/metapushstream7_android和demo/metaplayer7_android
核心 API 使用示例
C 语言版本
#include <yangrtc/YangWhip.h>
#include <yangrtc/YangPeerInfo.h>
#include <yangrtc/YangPeerConnection.h>
int32_t localPort = 16000;
YangAVInfo* avinfo;
YangPeerConnection* conn = (YangPeerConnection*)calloc(sizeof(YangPeerConnection), 1);
// 初始化对等连接信息
yang_avinfo_initPeerInfo(&conn->peer.peerInfo, avinfo);
conn->peer.peerInfo.rtc.rtcLocalPort = localPort;
conn->peer.peerInfo.direction = YangRecvonly;
conn->peer.peerInfo.uid = uid;
// 设置回调函数
conn->peer.peerCallback.recvCallback.context = this;
conn->peer.peerCallback.recvCallback.receiveAudio = g_rtcrecv_receiveAudio;
conn->peer.peerCallback.recvCallback.receiveVideo = g_rtcrecv_receiveVideo;
// 创建对等连接
yang_create_peerConnection(conn);
// 添加音视频轨道
conn->addAudioTrack(&conn->peer, Yang_AED_OPUS);
conn->addVideoTrack(&conn->peer, Yang_VED_H264);
// 创建数据通道
conn->createDataChannel(&conn->peer);
C++ 语言版本
#include <yangrtc/YangWhip.h>
#include <yangrtc/YangPeerInfo.h>
#include <yangrtc/YangPeerConnection7.h>
int32_t localPort = 16000;
YangAVInfo* avinfo;
YangPeerInfo peerInfo;
// 初始化对等连接信息
yang_avinfo_initPeerInfo(&peerInfo, avinfo);
peerInfo.uid = 0;
peerInfo.direction = YangSendonly;
peerInfo.rtc.rtcLocalPort = localPort;
// 创建对等连接
YangPeerConnection7* conn = new YangPeerConnection7(&peerInfo, receive, ice, rtc, sslAlert);
// 添加音视频功能
conn->addAudioTrack(Yang_AED_OPUS);
conn->addVideoTrack(Yang_VED_H264);
功能特性详解
支持的音视频编码
视频编码：
- H.264
- H.265（HEVC）
音频编码：
- OPUS
- G.711A/G.711U
- AAC
- MP3
- SPEEX
音频处理功能
- AEC（回声消除）
- ANS（噪声抑制）
- AGC（自动增益控制）
- VAD（语音活动检测）
- CNG（舒适噪声生成）
网络传输特性
- NACK/PLI/FIR/FEC/TWCC
- STUN/TURN 支持
- IPv4/IPv6 双栈
- Whip/Whep 协议支持
平台兼容性
- Linux/Windows/Mac/Android/iOS
- ARM/MIPS/Loongson/RISC-V/X86
常见问题解决
编译问题
- 依赖库缺失：确保安装 OpenSSL、libsrtp、usrsctp 等核心依赖
- 平台配置错误：检查对应的编译脚本参数
- 头文件路径：确认 include 路径配置正确
运行问题
- 网络连接失败：检查 ICE 服务器配置
- 音视频无法播放：验证编解码器支持
- 性能优化：根据应用场景调整配置参数
进阶开发指南
自定义编解码器
通过实现相应的接口，可以集成自定义的音视频编解码器，满足特定场景需求。
性能调优
根据网络条件和设备性能，合理设置码率、帧率等参数，平衡质量和流畅度。
