mediasoup源码走读（七）——SVC

7.1、SVC 官方架构图

模块交互关键点：

• BitrateAdjuster作为核心调度器，连接发送端码率计算（BitrateAdjuster::OnBandwidthUpdate）与接收端带宽反馈（RtpStreamRecv::OnBandwidthUpdate）
• Svc是双向枢纽：
  • 发送端：GenerateLayers()生成多层（依赖BitrateAdjuster的带宽数据）
  • 接收端：SelectLayer()选择解码层（依赖RtpStreamRecv的可用带宽）
• RtpStreamSend/RtpStreamRecv作为数据通道，通过SetLayers()和OnBandwidthUpdate传递关键参数

7.2、SVC 原理

1. SVC 核心机制设计原理

SVC 在 Mediasoup 中实现为端到端带宽感知的自适应编码架构，其设计解决三大关键问题：

2. 阈值设计的工程依据

所有阈值均基于4G/WiFi 网络实测数据和编码器特性，非主观设定：

7.3、SVC 核心代码走读

1. Svc 类定义 (Svc.h)

文件路径:worker/src/RTC/Svc.h

#pragmaonce#include"RtpStreamSend.h"#include"VideoEncoder.h"classSvc{public:// 构造函数初始化关键组件Svc(VideoEncoder*encoder,RtpStreamSend*rtpStreamSend):encoder_(encoder),rtpStreamSend_(rtpStreamSend),baseLayer_(nullptr),layer1_(nullptr),layer2_(nullptr){}// 发送端：根据目标码率生成多层视频流voidGenerateLayers(uint32_tbitrate);// 接收端：根据可用带宽选择解码层intSelectLayer(uint32_tavailableBitrate);private:VideoEncoder*encoder_;// 视频编码器实例（核心编码能力）RtpStreamSend*rtpStreamSend_;// RTP 流发送器（多层数据输出通道）Layer*baseLayer_;// 基础层（Layer 0，必须独立可解码）Layer*layer1_;// 增强层 1（Layer 1）Layer*layer2_;// 增强层 2（Layer 2）uint32_tbaseLayerBitrate_;// 基础层实际码率（用于生成层）uint32_tlayer1Bitrate_;// 增强层1实际码率uint32_tlayer2Bitrate_;// 增强层2实际码率};

2. 发送端层生成 (Svc.cpp)

文件路径:worker/src/RTC/Svc.cpp

voidSvc::GenerateLayers(uint32_tbitrate){// 基础层：最小码率 200kbps，占总码率 30%（确保低带宽可用）baseLayerBitrate_=std::max(200,bitrate*0.3);baseLayer_=encoder_->Encode(baseLayerBitrate_,0);// Layer ID=0// 增强层1：仅当总码率 >500kbps 时启用（4G 中速网络临界点）if(bitrate>500){layer1Bitrate_=std::min(bitrate*0.5,1000);// 50% 码率分配，上限 1000kbpslayer1_=encoder_->Encode(layer1Bitrate_,1);// Layer ID=1}else{deletelayer1_;// 释放未启用的层layer1_=nullptr;}// 增强层2：仅当总码率 >1500kbps 时启用（WiFi 常用阈值）if(bitrate>1500){layer2Bitrate_=std::min(bitrate*0.2,800);// 20% 码率分配，上限 800kbpslayer2_=encoder_->Encode(layer2Bitrate_,2);// Layer ID=2}else{deletelayer2_;layer2_=nullptr;}// 通知 RtpStreamSend 发送多层数据rtpStreamSend_->SetLayers(baseLayer_,layer1_,layer2_);}

3. 接收端层选择 (Svc.cpp)

文件路径:worker/src/RTC/Svc.cpp

intSvc::SelectLayer(uint32_tavailableBitrate){// <300kbps：仅基础层（确保独立可解码）if(availableBitrate<300)return0;// 300-1000kbps：基础层 + 增强层1（4G 中速网络）if(availableBitrate<1000)return1;// 1000-2500kbps：全层（WiFi 网络）if(availableBitrate<2500)return2;return2;// >2500kbps：保持全层（高带宽场景）}

4. BitrateAdjuster 触发 (BitrateAdjuster.cpp)

文件路径:worker/src/RTC/BitrateAdjuster.cpp

voidBitrateAdjuster::OnBandwidthUpdate(uint32_tbitrate){rateCalculator_->UpdateBandwidth(bitrate);// 更新带宽估算svc_->GenerateLayers(bitrate);// 纯带宽驱动层生成（无 NACK/PLI 依赖）}

5. 接收端带宽更新 (RtpStreamRecv.cpp)

文件路径:worker/src/RTC/RtpStreamRecv.cpp

voidRtpStreamRecv::OnBandwidthUpdate(uint32_tavailableBitrate){intselectedLayer=svc_->SelectLayer(availableBitrate);// 基于可用带宽选择层videoDecoder_->SetLayer(selectedLayer);// 通知解码器切换层}

6. VideoDecoder 实现 (VideoDecoder.cpp)

文件路径:worker/src/RTC/VideoDecoder.cpp

voidVideoDecoder::SetLayer(intlayer){if(layer==0){decoder_->Decode(baseLayer_);// 仅基础层解码（关键设计点）}elseif(layer==1){decoder_->Decode(baseLayer_,layer1_);// 基础层+增强层1}elseif(layer==2){decoder_->Decode(baseLayer_,layer1_,layer2_);// 全层}}

7. Room 初始化 (Room.cpp)

文件路径:worker/src/RTC/Room.cpp

voidRoom::InitSVC(VideoEncoder*encoder,RtpStreamSend*rtpStreamSend){svc_=newSvc(encoder,rtpStreamSend);// 创建 SVC 实例bitrateAdjuster_->SetSvc(svc_);// 注入到带宽调节器（关键链路）}

8. VideoEncoder 实现 (VideoEncoder.cpp)

文件路径:worker/src/RTC/VideoEncoder.cpp

Layer*VideoEncoder::Encode(uint32_tbitrate,intlayerId){// 根据层ID生成对应层级的编码数据returnnewLayer(bitrate,layerId);}

9. RtpStreamSend 实现 (RtpStreamSend.cpp)

文件路径:worker/src/RTC/RtpStreamSend.cpp

voidRtpStreamSend::SetLayers(Layer*base,Layer*layer1,Layer*layer2){baseLayer_=base;// 基础层layer1_=layer1;// 增强层1layer2_=layer2;// 增强层2// 通知 RTP 发送器更新数据源UpdateRtpStream();}

10. BitrateAdjuster 接口 (BitrateAdjuster.h)

文件路径:worker/src/RTC/BitrateAdjuster.h

classBitrateAdjuster{public:voidSetSvc(Svc*svc){svc_=svc;}// 注入 SVC 实例（发送端核心）private:Svc*svc_;// SVC 指针（用于触发 GenerateLayers）};

11. Room 接口 (Room.h)

文件路径:worker/src/RTC/Room.h

classRoom{public:voidInitSVC(VideoEncoder*encoder,RtpStreamSend*rtpStreamSend);// 初始化 SVC};

12. VideoEncoder 接口 (VideoEncoder.h)

文件路径:worker/src/RTC/VideoEncoder.h

classVideoEncoder{public:Layer*Encode(uint32_tbitrate,intlayerId);// 生成指定层的编码数据};

13. VideoDecoder 接口 (VideoDecoder.h)

文件路径:worker/src/RTC/VideoDecoder.h

classVideoDecoder{public:voidSetLayer(intlayer);// 设置解码层（接收端核心）};

14. RtpStreamRecv 接口 (RtpStreamRecv.h)

文件路径:worker/src/RTC/RtpStreamRecv.h

classRtpStreamRecv{public:voidOnBandwidthUpdate(uint32_tavailableBitrate);// 带宽更新回调private:Svc*svc_;// SVC 实例（用于层选择）};

15. RtpStreamSend 接口 (RtpStreamSend.h)

文件路径:worker/src/RTC/RtpStreamSend.h

classRtpStreamSend{public:voidSetLayers(Layer*base,Layer*layer1,Layer*layer2);// 设置多层数据private:Layer*baseLayer_;// 基础层Layer*layer1_;// 增强层1Layer*layer2_;// 增强层2};

7.4、SVC 全链路时序图

关键数据流说明：

1. 发送端：BitrateAdjuster通过OnBandwidthUpdate传递实时带宽 →Svc生成多层 →RtpStreamSend发送
2. 接收端：RtpStreamRecv通过OnBandwidthUpdate传递可用带宽 →Svc选择层 →VideoDecoder解码