根据推荐调整目标码率

功能描述

为提升数据传输量和避免网络拥塞，RTSA Lite SDK 会根据网络带宽状况的变化建议开发者实时调整发送码率。

实现方法

开发者可根据自己的实际带宽和码率需要，调用 agora_rtc_set_bwe_param （C API）方法或 setBweParam（Java API） 方法配置 BWE (BandWidth Estimation)，设置发送码率的最小值、最大值和起始值。

码流传输过程中，当网络带宽状况的变化时，SDK 会触发 on_target_bitrate_changed（C API）回调或 onTargetBitrateChanged（Java API） 回调，提示应用程序实时调整发送码率。回调返回的码率是视频编码器的最大建议编码码率。

以下为示例代码：

C 示例代码

// C
// Handle the bitrate change event
static void OnTargetBitrateChanged (const char *channel, uint32_t target_bps) {
    /** ----------------PERSUDO CODE -----------------
     *  Please replace it with specific implementation
     *  ----------------------------------------------
     */
    video_encoder_t *video_encoder_ptr = get_video_encoder(channel);
    video_encoder_ptr->set_target_bps(target_bps);
}

// Listen to the bitrate change event
static const agora_rtc_event_handler_t listener = {
    .on_target_bitrate_changed = OnTargetBitrateChanged,
    // ...
};

// Config initial BWE parameters
const int VIDEO_TARGET_BPS_MAX = 1 << 23; // 8 Mbps
const int VIDEO_TARGET_BPS_MIN = 1 << 16; // 64 Kbps
const int VIDEO_START_BPS = 300 * 1024;   // 300 Kbps

agora_rtc_set_bwe_param(VIDEO_TARGET_BPS_MIN, VIDEO_TARGET_BPS_MAX , VIDEO_START_BPS)

API 参考

C API 文档

• agora_rtc_set_bwe_param
• on_target_bitrate_changed

Java API 文档

• setBweParam
• onTargetBitrateChanged

开发注意事项

• 这两个回调返回的是 bps，不要和 kbps 及 Bps 混淆。