startChannelMediaRelay method
- ChannelMediaRelayConfiguration channelMediaRelayConfiguration
开始跨频道媒体流转发。
该方法可用于实现跨频道媒体流转发。
成功调用该方法后,SDK 会触发 RtcEngineEventHandler.channelMediaRelayStateChanged 和 RtcEngineEventHandler.channelMediaRelayEvent 回调, 并在回调中报告当前的跨频道媒体流转发状态和事件。
- 如果 RtcEngineEventHandler.channelMediaRelayStateChanged 回调报告 ChannelMediaRelayState.Running 和 ChannelMediaRelayError.None 且 RtcEngineEventHandler.channelMediaRelayEvent 回调报告 ChannelMediaRelayEvent.SentToDestinationChannel, 则表示 SDK 开始在源频道和目标频道之间转发媒体流。
- 如果 RtcEngineEventHandler.channelMediaRelayStateChanged 回调报告 ChannelMediaRelayState.Failure,则表示跨频道媒体流转发出现异常。
Note
- 跨频道媒体流转发功能需要联系 sales@agora.io 开通。
- 该功能不支持 String 型 UID。
- 请在成功加入频道后调用该方法。
- 该方法仅适用于直播场景下的主播。
- 成功调用该方法后,若你想再次调用该方法,必须先调用 RtcEngine.stopChannelMediaRelay 方法退出当前的转发状态。
Parameter channelMediaRelayConfiguration
跨频道媒体流转发参数配置。
Implementation
@override
Future<void> startChannelMediaRelay(
ChannelMediaRelayConfiguration channelMediaRelayConfiguration) {
return _invokeMethod('startChannelMediaRelay', {
'channelMediaRelayConfiguration': channelMediaRelayConfiguration.toJson()
});
}