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