MetaRTC 跨平台 WebRTC SDK 开发入门指南

视频配置（[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

常见问题解决

编译问题

1. 依赖库缺失：确保安装 OpenSSL、libsrtp、usrsctp 等核心依赖
2. 平台配置错误：检查对应的编译脚本参数
3. 头文件路径：确认 include 路径配置正确

运行问题

1. 网络连接失败：检查 ICE 服务器配置
2. 音视频无法播放：验证编解码器支持
3. 性能优化：根据应用场景调整配置参数

进阶开发指南

自定义编解码器

通过实现相应的接口，可以集成自定义的音视频编解码器，满足特定场景需求。

性能调优

根据网络条件和设备性能，合理设置码率、帧率等参数，平衡质量和流畅度。