错误的结构定义。

BusinessId，TaskId，RoomId，UserId 等字段都遵循相同的命名规范：

长度不超过 128 个字节，字符集取值范围是：

• 英文大写字母：A~Z；
• 英文小写字母：a~z；
• 数字：0~9；
• @ . _ -。

合流布局参数。

如果你选择使用自适应布局模式，合流时，不同的合流用户数量会适用不同的布局：

• 2人：
  
• 4人：
  
• 5~9 10~16人：
  
• 17人：
  

自适应布局会遵循以下规则：

• 具体布局会根据人数进行选择，遵循以上示意图。人数未达到布局适用的最多人数时，空缺窗口会显示背景色。
• 只发送音频的用户仍然会在整体布局上占据窗口，窗口会显示背景色。
• 如果实际视频流的宽高比与视窗的宽高比不一致，会自动对视频进行裁剪以适配窗口的大小。

如果你选择使用垂直布局模式，合流时，不同的合流用户数量会适用不同的布局：

垂直布局会遵循以下规则：

• 对于大窗口：
  • 如果未指定用户，大窗口会随机显示一个用户；如果指定用户未进入频道或进入频道未发布流，大窗口会显示背景色。
  • 如果实际视频流的宽高比与窗口的宽高比不一致，窗口会按照显示区域的长宽比裁减视频，并等比拉伸或缩小视频，以占满显示区域。
• 对于小窗口：
  • 小视窗根据加入的顺序进行排列。如果某个用户退出频道，紧跟的后序用户会占据前序用户的窗口，并依次替补。
  • 如果实际视频流的宽高比与视窗的宽高比不一致，视频会裁剪以适配视窗的大小。
  • 人数未达到布局适用的最多人数时，空缺窗口会显示背景色。
  • 只发送音频的用户仍然会在整体布局上占据窗口，窗口会显示背景色。

如果你选择使用并排布局模式，合流时，不同的合流用户数量会适用不同的布局：

自定义布局模式下，画面布局的具体设置。

自定义布局模式下，对于 StreamList 中的每个 Stream，Regions 中都需要给出对应的布局信息，否则会返回请求不合法的错误。即 Regions.Region.StreamIndex 要与 TargetStreams.StreamList.Stream.Index 的值一一对应，否则自定义布局设置失败，返回 InvalidParameter 错误码。

整体屏幕（画布）的宽高以及背景色参数。

1. 如果你设置了背景图片，背景图片会覆盖背景色。

视频流在整体画面中的布局参数。

• 当传入的必填参数值不合法时，返回错误码 InvalidParameter 。
• 当传入的选填参数值不合法时，自动调整为默认值。

参数名称	类型	必填	示例值	描述
StreamIndex	Uint32	是	0	流的标识。这个标志应和 TargetStreams.StreamList.Stream.Index 对应。
LocationX	Float32	否	0	视频流对应区域左上角的横坐标相对整体画面的比例，取值的范围为 [0.0, 1.0)。默认值为 0。若传入该参数，服务端会对该参数进行校验，若不合法会返回错误码 InvalidParameter。参看关于 LocationX 的说明。
LocationY	Float32	否	0	视频流对应区域左上角的纵坐标相对整体画面的比例，取值的范围为 [0.0, 1.0)。默认值为 0。若传入该参数，服务端会对该参数进行校验，若不合法会返回错误码 InvalidParameter。参看关于 LocationY 的说明。
WidthProportion	Float32	是	0.5	视频流对应区域宽度相对整体画面的比例，取值的范围为 (0.0, 1.0]。
HeightProportion	Float32	是	0.5	视频流对应区域高度相对整体画面的比例，取值的范围为 (0.0, 1.0]。
ZOrder	Uint32	否	0	当多个流的画面有重叠时，使用此参数设置指定画面的图层顺序。取值范围为 [0, 100]：0 表示该区域图像位于最下层，100 表示该区域图像位于最上层, 默认值为 0。值不合法时，自动调整为默认值。
Alpha	Float32	否	1	画面的透明度，取值范围为 (0.0, 1.0]。0.0 表示完全透明，1.0 表示完全不透明，默认值为 1.0。值不合法时，自动调整为默认值。
RenderMode	Uint32	否	0	画面的渲染模式，值的范围为 {0, 1, 2，3}, 默认值为 0： 0 表示按照指定的宽高直接缩放。如果原始画面宽高比与指定的宽高比不同，就会导致画面变形 1 表示按照显示区域的长宽比裁减视频，然后等比拉伸或缩小视频，占满显示区域。 2 表示按照原始画面的宽高比缩放视频，在显示区域居中显示。如果原始画面宽高比与指定的宽高比不同，就会导致画面有空缺，空缺区域为填充的背景色值。 3 表示按照指定的宽高直接缩放。如果原始画面宽高比与指定的宽高比不同，就会导致画面变形 值不合法时，自动调整为默认值。 目前 0 和 3 均为按照指定的宽高直接缩放，但我们推荐你使用 3 以便与客户端实现相同逻辑。 不同渲染模式下，效果如下：
SourceCrop	SourceCrop	否	/	源流剪切功能，可以在源视频帧渲染之前进行裁剪，即预处理一次再渲染。
AlternateImage	String	否	补位图片的 url。长度不超过 1024 个字符串。	参看关于 AlternateImage 的说明。
MediaType	Uint32	否	0	该路流参与混流的媒体类型。 0：音视频 1：纯音频 2：纯视频 默认值为 0。值不合法时，自动调整为默认值。 假如该路流为音视频流，MediaType设为1，则只混入音频内容。
AlternateImageFillMode	Uint32	否	0	画面的渲染模式。 0：按照用户原始视频帧比例进行缩放 1：保持图片原有比例 默认值为 0。值不合法时，自动调整为默认值。

备注：

• 关于 LocationX 和 LocationY 的说明：
  视频流对应区域左上角的实际坐标是通过画面尺寸和相对位置比例相乘，并四舍五入取整得到的。假如，Canvas.Width = 1920, Region.LocationX = 0.33，那么该画布左上角的横坐标为 634（1920*0.33=633.6，四舍五入取整）。
• 关于 WidthProportion 和 HeightProportion 的说明：
  视频流对应区域宽度和高度的像素值是通过画面尺寸和相对位置比例相乘，四舍五入取整，并向上转换为偶数得到的。假如，Canvas.Width = 1920, Region.WidthProportion = 0.21，那么该画布横向宽度为 404px（1920*0.21=403.2，四舍五入取整后，再向上转换为偶数）。
• 关于 AlternateImage 的说明：
  1. 在 Region.StreamIndex 对应的视频流没有发布，或被暂停采集时，AlternateImage 对应的图片会填充 Region 对应的画布空间。当视频流被采集并发布时，AlternateImage 不造成任何影响。
  2. 可以传入的图片的格式包括：JPG, JPEG, PNG。
  3. 当图片和画布尺寸不一致时，图片根据 RenderMode 的设置，在画布中进行渲染。

对原视频帧在渲染前进行裁剪。

如果裁剪后计算得到的实际分辨率的宽或高不是偶数，会被自动调整为偶数。

音视频编码参数。

自适应码率模式下，RTC 默认不会设置超高码率。如果订阅屏幕流，建议自行设置高码率。不同场景下设置码率等视频发布参数,请参考设置视频发布参数。

补帧：在音视频录制或合流转推时，视频的帧率通常是固定的。但是，因为网络波动或其他原因，实际帧率可能无法达到预设的帧率。此时，需要补帧以保持视频流畅。补最后一帧意味着补充的视频帧和中断前的最后一帧相同，此时看到的画面可能会有短暂静止；补黑帧意味着补充的视频帧是全黑的。

注释1:

• 火山引擎平台账号 ID 查看路径：控制台->账号管理->账号信息
  

• 此账号 ID 为火山引擎主账号 ID。

• 若你调用 OpenAPI 鉴权过程中使用的 AK、SK 为子用户 AK、SK，账号 ID 也必须为火山引擎主账号 ID，不能使用子用户账号 ID。

注释1:
Prefix 为指定录制文件名的前缀，是一个由多个字符串组成的数组，在 TOS 以及支持 S3 的第三方存储平台上，可以实现指定文件夹的功能。如：Prefix = ["directory1","directory2"]，将在录制文件名前加上前缀 "directory1/directory2/"。
前缀长度（包括斜杠）不得超过 128 个字符。Prefix中不得出现斜杠、下划线、括号等符号字符。
仅支持以下字符：

• 26 个小写英文字母 a-z
• 26 个大写英文字母 A-Z
• 10 个数字 0-9

流的参数

指定流的数量及属性参数。

截图产生的图片的相关配置。

1. Align 是音频切片对齐功能的开关，默认为 False。你可以使用音频切片对齐功能，对齐各个用户音频切片的开始和结束时刻。

   • 当 Align=False 时，关闭音频切片对齐。在某个切片周期中，如果用户有发送音频流的行为，即生成音频切片。如果用户在切片的周期中，有部分时间未发布音频，返回的音频切片时长会小于切片周期。各个用户音频切片开始时间不一定一致。
   • 当 Align=True 时，开启音频切片对齐。在某个切片周期中，如果用户有发送音频流的行为，即生成音频切片。切片长度和切片周期相等，且各个用户音频切片开始的时间一致。如果用户在切片的周期中，有部分时间未发布音频，切片长度不变，这段时间呈现静音帧。如果用户在某个切片周期中始终没有发布音频，则不生成音频切片。

2. Mixed 是音频切片合流功能的开关。默认为 False。

   • 当 Mixed=False 时，只会对 TargetStreams 中指定的音频流分别切片。
   • 当 Mixed=True 时，除了会对 TargetStreams 中指定的音频流分别切片，还会对指定的音频流进行混音，生成合流切片，合流切片对应的用户名为 mixed。此时，任务创建后，不管是否有人上麦，会持续回调混音切片。

   不同平台的回调参看：

3. 当前 RTC 按照传入的Duration值进行固定时长切片,可能存在敏感词被截断，未被识别的情况。此时你可以添加冗余切片，即上一段切片的末尾指定时长，来避免此情况，此时切片的时长变为RedundantDuration + Duration。
   例如：当 Duration = 20，redundantDuration = 3 时，最终输出的前三个文件时长为：[0-20], [17-40], [37-60]。