流量控制

---

功能简介

流量控制，是指 SDK 根据本端以及对端当前网络状态，动态调整视频推流的码率、帧率和分辨率，以及音频码率，自动适应当前网络环境及网络波动，从而保证音视频能流畅推送。

流量控制的原理是基于当前网络情况，对用户的网络环境建模并估算它的上行带宽。如果当前上行带宽小于设置的推流码率，则会通过配置的选项分别从视频码率、分辨率、帧率、音频码率几处循序渐进地降低，以减少最终推流的上行码率，保证直播的流畅性。在网络环境恢复正常以后，上行码率也会重新恢复到初始设置值。

当只有一个 RTC 推流 的情况下，只有一个 RTC 拉流 或只有一个 L3 拉流 时，SDK 会自动开启下行流量控制。拉流端将自己的网络情况通知给推流端，推流端估算自己的上行带宽和拉流端的下行带宽，并从上行、下行带宽的估值中取最小值来调整自己的上行码率，以保证连麦的流畅性。

前提条件

在实现流量控制功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

使用步骤

1 开启流量控制

推流前调用 enableTrafficControl 接口，通过 enable 参数开启流量控制，并通过 property 参数设置可调节的流量控制属性（码率、帧率、分辨率）。支持选择多项，默认值为 ADAPTIVE_FPS，即自适应（降低）视频帧率。当上行带宽不足时，SDK 会根据当前网络环境，根据设置的property参数减少最终推流的上行码率，以适应上行带宽。

// 开启流量控制，且同时开启自适应（降低）视频分辨率和自适应（降低）视频帧率
ZegoExpressEngine.getEngine().enableTrafficControl(true, ADAPTIVE_RESOLUTION.value() | ADAPTIVE_FPS.value());

2 （可选）自动调整流量控制属性

SDK 会根据 创建引擎 时，开发者选择的场景 scenario，自动设置适合该场景的流量控制属性。例如，秀场直播场景需要保证视频流畅性，推荐选择自适应（降低）视频分辨率；教育场景需要保证清晰度，推荐选择自适应（降低）视频帧率。

3 设置流量控制视频码率最小值(纯音频场景可跳过)

开启流量控制后，调用 setMinVideoBitrateForTrafficControl 方法设置视频码率最小值（默认值为 “0”）及视频发送模式，可以使 SDK 在网络未达到发送视频的最小码率时采用该方法设置视频发送模式（不发送视频或以极低的帧率发送）。

// 开启流控后，当上下行带宽低于 200 kbps 时，以极低的帧率继续发送视频数据
ZegoExpressEngine.getEngine().setMinVideoBitrateForTrafficControl(200, ZegoTrafficControlMinVideoBitrateMode.ULTRA_LOW_FPS);