错误的结构定义。

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	Uint32	否	0	视频流对应区域左上角的横坐标相对整体画面左上角原点的横向位移，取值的范围为 [0.0, Canvas.Width)。默认值为 0。若传入该参数，服务端会对该参数进行校验，若不合法会返回错误码 InvalidParameter。参看视频流对应区域左上角的实际坐标说明。
LocationY	Uint32	否	0	视频流对应区域左上角的横坐标相对整体画面左上角原点的纵向位移，取值的范围为 [0.0, Canvas.Height)。默认值为 0。若传入该参数，服务端会对该参数进行校验，若不合法会返回错误码 InvalidParameter。参看关于 LocationY 的说明。
Width	Uint32	是	640	视频流对应区域宽度的像素绝对值，取值的范围为 (0.0, Canvas.Width]。
Height	Uint32	是	480	视频流对应区域高度的像素绝对值，取值的范围为 (0.0, Canvas.Height]。
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 的说明。
ApplySpatialAudio	Bool	否	/	该路流对应的用户是否开启空间音频效果。 true：开启空间音频效果。 false：关闭空间音频效果。 默认值为 true
SpatialPosition	Array of Int	否	[0,0,0]	空间音频下，房间内指定用户所在位置的三维坐标，默认值为[0,0,0]。数组长度为3，三个值依次对应X,Y,Z，每个值的取值范围为[-100,100]。
CornerRadius	Float	否	0.1	转推直播下边框圆角半径与画布宽度的比例值，取值范围为 [0,1]，默认值为 0。圆角半径的像素位不能超过 Region 宽高最小值的一半，否则不会出现圆角效果。
MediaType	Uint32	否	0	该路流参与混流的媒体类型。 0：音视频 1：纯音频 2：纯视频 默认值为 0。值不合法时，自动调整为默认值。 假如该路流为音视频流，MediaType设为1，则只混入音频内容。
AlternateImageFillMode	Uint32	否	0	画面的渲染模式。 0：按照用户原始视频帧比例进行缩放 1：保持图片原有比例 默认值为 0。值不合法时，自动调整为默认值。

• 视频流对应区域左上角的实际坐标是通过画面尺寸和相对位置比例相乘，并四舍五入取整得到的。假如，画布尺寸为`1920`, 视频流对应区域左上角的横坐标相对整体画面的比例为 `0.33`，那么该画布左上角的横坐标为 `634`（1920*0.33=633.6，四舍五入取整）。

• 关于 AlternateImage 的说明：

  1. 在 Region.StreamIndex 对应的视频流没有发布，或被暂停采集时，AlternateImage 对应的图片会填充 Region 对应的画布空间。当视频流被采集并发布时，AlternateImage 不造成任何影响。
  2. 可以传入的图片的格式包括：JPG, JPEG, PNG。
  3. 当图片和画布尺寸不一致时，图片根据 RenderMode 的设置，在画布中进行渲染。

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

音视频编码参数。

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

录制与转推直播 control 字段

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

使用占位图、补帧和上一帧的关系:

你可以在 Region 中传入 Alternateimage 字段设置占位图,在 Control 中传入FrameInterpolationMode 字段设置补帧模式,但占位图优先级高于补帧模式。

• 在 Region.StreamIndex 对应的视频流停止发布时, Region 对应的画布空间会根据设置填充占位图或补帧。但当视频流为屏幕流时，补帧模式不生效。
• 当 Region.StreamIndex 对应的视频流发布后停止采集或推送时, Region 对应的画布空间会填充上一帧。
• 当 Region.StreamIndex 对应的视频流发布时,设置的占位图或补顿模式不造成任何影响。

SpatialConfig

AudienceSpatialOrientation

SEIConfig

单流转推流的参数

单流转推 control 参数

流的参数

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

注释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