错误的结构定义。

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 。
• 当传入的选填参数值不合法时，自动调整为默认值。

备注：

• 关于 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:
Prefix 为指定录制文件名的前缀，是一个由多个字符串组成的数组，在 Tos 以及支持 S3 的第三方存储平台上，可以实现指定文件夹的功能。如：fileNamePrefix = ["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。此时，任务创建后，不管是否有人上麦，会持续回调混音切片。

   不同平台的回调参看：