setLocalPublishFallbackOption method

最近更新时间:2022-09-20 05:17:40


Future<void> setLocalPublishFallbackOption (
    StreamFallbackOptions option
)

设置弱网条件下发布的音视频流回退选项。

网络不理想的环境下,直播音视频的质量都会下降。使用该接口并将 option 设置为 StreamFallbackOptions.AudioOnly 后, SDK 会在上行弱网且音视频质量严重受影响时,自动关断视频流,从而保证或提高音频质量。 同时 SDK 会持续监控网络质量,并在网络质量改善时恢复音视频流。当本地推流回退为音频流时,或由音频流恢复为音视频流时, SDK 会触发本地发布的媒体流已回退为音频流 RtcEngineEventHandler.localPublishFallbackToAudioOnly 回调。

Note

旁路推流场景下,设置本地推流回退为 StreamFallbackOptions.AudioOnly 可能会导致远端的 CDN 用户听到声音的时间有所延迟。 因此在有旁路推流的场景下,AR 建议不开启该功能。

Parameter option 本地推流回退处理选项。详见 StreamFallbackOptions

Implementation


Future<void> setLocalPublishFallbackOption(StreamFallbackOptions option) {
  return _invokeMethod('setLocalPublishFallbackOption',
      {'option': StreamFallbackOptionsConverter(option).value()});
}