setLocalPublishFallbackOption method

Future<void> setLocalPublishFallbackOption (
  1. StreamFallbackOptions option
)

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

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

Note

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

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

Implementation

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