setLocalPublishFallbackOption method Null safety

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(),
  });
}