合流布局

画布配置

设置画布码率

方法

Dart

RCRTCEngine.setLiveMixVideoBitrate();

参数说明

参数	类型	必填	说明
bitrate	int	是	画布码率，单位 kbps

示例代码

Dart

// 设置画布码率
engine.setLiveMixVideoBitrate(2200);

设置画布分辨率

方法

Dart

RCRTCEngine.setLiveMixVideoResolution();

参数说明

参数	类型	必填	说明
resolution	RCRTCVideoResolution	是	画布分辨率

示例代码

Dart

// 设置画布分辨率
engine.setLiveMixVideoResolution(RCRTCVideoResolution.resolution_720_1280);

设置画布帧率

方法

Dart

RCRTCEngine.setLiveMixVideoFps();

参数说明

参数	类型	必填	说明
fps	RCRTCVideoFps	是	画布帧率

示例代码

Dart

// 设置画布帧率
engine.setLiveMixVideoFps(RCRTCVideoFps.fps_30);

设置填充方式

方法

Dart

RCRTCEngine.setLiveMixRenderMode();

参数说明

参数	类型	必填	说明
mode	RCRTCLiveMixRenderMode	是	填充方式

示例代码

Dart

// 设置填充方式为裁剪
engine.setLiveMixRenderMode(RCRTCLiveMixRenderMode.crop);

提示

画布指的是多道视频流新合成后视频背景宽高，不管哪种合流布局方式，都是基于画布宽高范围内渲染，此配置为可选设置。

• 大流画布宽高默认为 360 * 640 帧率为 25 码率为 800 。
• 小流画布宽高默认为 180 * 320 帧率为 15 码率为 200 。
• 可通过传递 tiny 参数区分设置大小流。

填充方式共分为两种：

• RCRTCLiveMixRenderMode.crop
• RCRTCLiveMixRenderMode.whole(默认)

音频配置

设置音频码率

方法

Dart

RCRTCEngine.setLiveMixAudioBitrate();

参数说明

参数	类型	必填	说明
bitrate	int	是	音频码率，单位 kbps，默认 200

示例代码

Dart

engine.setLiveMixAudioBitrate(400);

合流布局

直播合流视频布局目前分为三种：1. 悬浮布局（默认）；2. 自适应布局；3. 自定义布局。下面分别介绍布局效果。

悬浮布局

背景视频来源默认采用第一个加入房间的主播或调用合流布局相关接口的主播发布的视频，显示区域为整个合流视频，合流视频大小需要调用 setLiveMixVideoResolution 接口设置（默认值是 360 * 640）；当连麦者依次加入时，按照下图显示的序列加载子视图：

当有人离开时，系统会自动按照现有主播加入房间的次序重新布局视图。

方法

Dart

RCRTCEngine.setLiveMixLayoutMode();

参数说明

参数	类型	必填	说明
mode	RCRTCLiveMixLayoutMode	是	布局模式

示例代码

Dart

engine.setLiveMixLayoutMode(RCRTCLiveMixLayoutMode.suspension);

自适应布局

视频的整体大小为默认值 360 * 640 或通过合流接口自定义；当有多人加入房间后，直播系统会按照具体人数平分整体视频区域，使之每个子视图加载区域大小一致；录制系统会按照参会者进入房间的次序依次把参会者图像加载在示意图的相应序号上。 当有人离开时，系统会自动按照现有主播加入房间的次序重新布局视图。

方法

Dart

RCRTCEngine.setLiveMixLayoutMode();

参数说明

参数	类型	必填	说明
mode	RCRTCLiveMixLayoutMode	是	布局模式

示例代码

Dart

engine.setLiveMixLayoutMode(RCRTCLiveMixLayoutMode.adaptive);

自定义布局

通过调用自定义布局接口可以设置合流视频整体尺寸，以及各个连麦者视图位置及大小。

如下图所示，合流布局是以像素方式，定义视频输出尺寸， 如图整体视频尺寸 宽*高 = 300 * 300 ；以整体作为画布，画布的原点（0,0）在左上角, 那么三个连麦主播的窗口相对原点的位置，及其宽度，高度值分别如图所示（相应的设置代码也可在直播布局的接口文档中查看布局实例代码）：

方法

Dart

RCRTCEngine.setLiveMixCustomLayouts();

参数说明

参数	类型	必填	说明
layouts	RCRTCCustomLayout	是	自定义布局列表

示例代码

Dart

List<RCRTCCustomLayout> layouts = [];

RCRTCCustomLayout layout1 = RCRTCCustomLayout.create(
  userId: userId1,
  x: 70,
  y: 20,
  width: 130,
  height: 80,
);
layouts.add(layout1);

RCRTCCustomLayout layout2 = RCRTCCustomLayout.create(
  userId: userId2,
  x: 20,
  y: 100,
  width: 120,
  height: 150,
);
layouts.add(layout2);

RCRTCCustomLayout layout3 = RCRTCCustomLayout.create(
  userId: userId3,
  x: 160,
  y: 100,
  width: 120,
  height: 150,
);
layouts.add(layout3);

engine.setLiveMixCustomLayouts(layouts);

提示

设置自定义布局后会默认修改 LiveMixLayoutMode 属性为 RCRTCLiveMixLayoutMode.custom

音频合流

音频合流布局的原理就是通过控制输入资源列表，设置输出音频配置，达到合并哪些主播音频资源输出到指定配置的音频资源。设置音频资源合流列表后，观众订阅直播资源，就会只听到音频合流列表中对应的主播。

方法

Dart

RCRTCEngine.setLiveMixCustomAudios();

参数说明

参数	类型	必填	说明
userIds	List of String	是	音频合流用户 ID 列表

示例代码

Dart

List<String> userIds = [
  userId1,
  userId2,
  userId3,
];

engine.setLiveMixCustomAudios(userIds);