startForwardStreamToRooms method
- NSArray<
ByteRTCForwardStreamConfiguration> configurations
@detail api
@author shenpengliang
@brief 开始跨房间转发媒体流。
在调用 joinRoom:userInfo:userVisibility:roomConfig:{@link #ByteRTCRoom#joinRoom:userInfo:userVisibility:roomConfig} 后调用本接口,实现向多个房间转发媒体流,适用于跨房间连麦等场景。
@param configurations 跨房间媒体流转发指定房间的信息。参看 ByteRTCForwardStreamConfiguration{@link #ByteRTCForwardStreamConfiguration}。
@return
- 0: 成功。
- < 0: 失败。查看 ByteRTCReturnStatus{@link #ByteRTCReturnStatus} 获得更多错误说明。
@note
- 调用本方法后,将在本端触发 rtcRoom:onForwardStreamStateChanged:{@link #ByteRTCRoomDelegate#rtcRoom:onForwardStreamStateChanged} 回调。
- 调用本方法后,你可以通过监听 rtcRoom:onForwardStreamEvent:{@link #ByteRTCRoomDelegate#rtcRoom:onForwardStreamEvent} 回调来获取各个目标房间在转发媒体流过程中的相关事件。
- 开始转发后,目标房间中的用户将接收到本地用户进房 rtcRoom:onUserJoined:{@link #ByteRTCRoomDelegate#rtcRoom:onUserJoined} 和发流 rtcRoom:onUserPublishStreamVideo:info:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishStreamVideo:info:isPublish}、rtcRoom:onUserPublishStreamAudio:info:isPublish:{@link #ByteRTCRoomDelegate#rtcRoom:onUserPublishStreamAudio:info:isPublish} 回调。
- 调用本方法后,可以调用 updateForwardStreamToRooms:{@link #ByteRTCRoom#updateForwardStreamToRooms} 更新目标房间信息,例如,增加或减少目标房间等。
- 调用本方法后,可以调用 stopForwardStreamToRooms{@link #ByteRTCRoom#stopForwardStreamToRooms} 停止向所有房间转发媒体流。
- 调用本方法后,可以调用 pauseForwardStreamToAllRooms{@link #ByteRTCRoom#pauseForwardStreamToAllRooms} 暂停向所有房间转发媒体流。
Implementation
FutureOr<int> startForwardStreamToRooms(
NSArray<ByteRTCForwardStreamConfiguration> configurations) async {
return await nativeCall('startForwardStreamToRooms:', [configurations]);
}