startChannelMediaRelay abstract method
开始跨房间媒体流转发。
-
该方法可用于实现跨房间连麦等场景。支持同时转发到 4 个房间,同一个房间可以有多个转发进来的媒体流。
-
成功调用该方法后,SDK 会触发 NERtcChannelEventCallback.onMediaRelayStatesChange 和 NERtcChannelEventCallback.onMediaRelayReceiveEvent 回调,并在回调中报告当前的跨房间媒体流转发状态和事件。
调用时机
请在成功加入房间后调用该方法。
说明
-
调用此方法需要通过
config
中的 NERtcChannelMediaRelayConfiguration.destMediaInfo 设置目标房间。 -
该方法仅对直播场景下的主播角色有效。
-
成功调用该方法后,若您想再次调用该方法,必须先调用 stopChannelMediaRelay 方法退出当前的转发状态。
-
成功开始跨房间转发媒体流后,如果您需要修改目标房间,例如添加或删减目标房间等,可以调用方法 updateChannelMediaRelay 更新目标房间信息。
config
跨房间媒体流转发参数配置信息。详细信息请参考 NERtcChannelMediaRelayConfiguration。
Implementation
Future<int> startChannelMediaRelay(
NERtcChannelMediaRelayConfiguration config);