实时调整发送码率
更新时间不可用
为提升数据传输量和避免网络拥塞，RTSA SDK 会根据网络带宽状况的变化建议开发者实时调整发送码率。
实现方法
开发者可根据自己的实际带宽和码率需要，在加入 RTC 频道前调用 agora_rtc_set_bwe_param 方法配置 BWE (BandWidth Estimation)，设置发送码率的最小值、最大值和起始值。
注意
你必须在调用 agora_rtc_join_channel 加入频道之前调用 agora_rtc_set_bwe_param 方法配置 BWE (BandWidth Estimation)，否则调用无效。
码流传输过程中，当网络带宽状况发生变化时，SDK 会触发 on_target_bitrate_changed 回调，提示应用程序实时调整发送码率。回调返回的码率是视频编码器的最大建议编码码率。
以网络摄像头的不同清晰度档位为例：
| 档位 | 分辨率 | 帧率 | 码率范围（kbps） |
|---|---|---|---|
| 标清 | L1: 640*360 | 15 | 400 ~ 800 |
| 高清 | L2: 1280*720 | 15 | 1130 ~ 2260 |
| 超高清 | L3: 1920*1080 | 15 | 1130 ~ 4160 |
如上表中配置情况，可设置最小值 400 kbps，最大值 4200 kbps。初始值是带宽探测的初始回调值，实际设置介于最小值和最大值中间，一般设置为正常情况编码的码率。如果初始编码档位为上表的标清档，初始值可设为 500 kbps。
发端会持续探测可用带宽，通过 on_target_bitrate_changed 回调告知应用当前可用带宽，应用编码需要做码率跟随，避免超码率发送，引起卡顿等问题。
示例代码如下：
// 配置 BWE
uint32_t min_bps = 400000;
uint32_t max_bps = 4200000;
uint32_t start_bps = 500000;
// conn_id 代表目标 Connection，此处配置所有 Connection
agora_rtc_set_bwe_param(CONNECTION_ID_ALL, min_bps, max_bps, start_bps);
// 实时调整发送码率
static void __on_target_bitrate_changed(connection_id_t conn_id, uint32_t target_bps)
{
// 当前码率按照 100 K 分档，向下取整
curTargetBitrate = target_bps/100000 * 100;
diffTargetBitrate = abs(curTargetBitrate - lastTargetBitrate);
// 如果探测带宽与设置的编码码率相差 100 K 以上，则重写调整编码参数
if ( (diffTargetBitrate >= 100 ) &&
(lowBitrateL1 <= curTargetBitrate && curTargetBitrate <= highBitrateL3) )
{
if (lowBitrateL1 <= curTargetBitrate && curTargetBitrate <= highBitrateL1)
{
curResolutionLevel = L1;
}
else if (lowBitrateL2 <= curTargetBitrate && curTargetBitrate <= highBitrateL2)
{
curResolutionLevel = L2;
}
else if (highBitrateL2 < curTargetBitrate && curTargetBitrate <= highBitrateL3)
{
curResolutionLevel = L3;
}
else
{}
// 调整编码分辨率
if (curResolutionLevel != lastResolutionLevel)
{
setEncodeResolution(curResolutionLevel);
}
// 设置编码码率
setEncodeBitrate(curTargetBitrate);
lastResolutionLevel = curResolutionLevel;
lastTargetBitrate = curTargetBitrate;
}
}API 参考
开发过程中，你还可以参考如下文档，了解各 API 的详细信息：
开发注意事项
on_target_bitrate_changed 回调返回的是 bps，不要和 kbps 及 Bps 混淆。