setSubscribeFallbackOption method
@detail api
@author panjian.fishing
@brief 设置订阅的音视频流的回退选项。
你可调用该接口设置网络不佳或设备性能不足时允许订阅流进行降级或只订阅音频流,以保证通话流畅。
@param option 订阅的音视频流回退选项,参看 SubscribeFallbackOptions{@link #SubscribeFallbackOptions}。
@return
- 0: 调用成功。
- < 0 : 调用失败。查看 ReturnStatus{@link #ReturnStatus} 获得更多错误说明。
@note
- 你必须在进房前设置,进房后设置或更改设置无效。
- 设置回退选项后,订阅的音视频流发生回退或从回退中恢复时,会收到 onSimulcastSubscribeFallback{@link #IRTCEngineEventHandler#onSimulcastSubscribeFallback} 和 onRemoteVideoSizeChanged{@link #IRTCEngineEventHandler#onRemoteVideoSizeChanged} 回调通知。
- 你可以调用 API 或者在服务端下发策略设置回退。当使用服务端下发配置实现时,下发配置优先级高于在客户端使用 API 设定的配置。
Implementation
Future<int?> setSubscribeFallbackOption(
SubscribeFallbackOptions option) async {
$a() => ($instance as $p_a.RTCEngine).setSubscribeFallbackOption(
t_SubscribeFallbackOptions.code_to_android(option));
$i() => ($instance as $p_i.ByteRTCEngine).setSubscribeFallbackOption(
t_SubscribeFallbackOptions.code_to_ios(option));
if (Platform.isAndroid) {
return $a();
} else if (Platform.isIOS) {
return $i();
} else {
throw UnsupportedError(
'Not Support Platform ${Platform.operatingSystem}');
}
}