混流布局

1 功能描述

  • 当一个房间中有多个用户时,平台可以进行混流,把该房间的多路音视频流混成一路,然后将该混流在云端推流到CDN或者云端录制;
  • 对于用户在不同房间内的开播场景,平台也可以进行混流,将指定的多个房间的多路音视频流混成一路,然后将该混流在云端推流到CDN或者云端录制;

2 参数说明

名称类型是否必选示例值描述
intputJSONArray123456789输入参数,需要合流的用户使用布局模板ID的情况可不填
outputJSON 输出参数
templateidnumber 布局模板ID:
1:水平布局
2:垂直布局
3:平铺布局
4:角落布局
只针对同房间的混流有效

2.1 input参数说明

名称类型是否必选示例值描述
uidstring123456789源流的用户uid
roomidstring1001源流的用户uid所在的房间号
streamtypeint0流类型,0:音视频,1:视频,2:音频
layerint0图层(0为最底层,1为从底往上第1层,依次类推,最多设置16层)
pos_xint0在画布中的左上角横坐标(坐标系:横轴向右增长,纵轴向下增长)
取值范围:(0,10000)
pos_yint0在画布中的左上角纵坐标, 取值范围:(0,10000)
pos_hint0在画布中的高度, 取值范围:(0,10000)
pos_wint0在画布中的宽度, 取值范围:(0,10000)
cropint0缩放显示选项
0:输入流居中显示,补黑边
1:输入流尽量填满,居中裁剪
取值范围:0或1
cutout_xint0若输入是原画中的抠图,抠图区域在原图中的x坐标
取值范围:(0,10000)
cutout_yint0若输入是原画中的抠图,抠图区域在原图中的y坐标
取值范围:(0,10000)
cutout_hint0若输入是原画中的抠图,抠图区域的高度
取值范围:(0,10000)
cutout_wint0若输入是原画中的抠图,抠图区域的宽度
取值范围:(0,10000)

2.2 output参数说明

名称类型是否必选示例值描述
streamtypeint0流类型,0:音视频
videoheightint600视频高度,取值范围(0,10000)
videowidthint800视频宽度,取值范围(0,10000),8的整数倍
videobitrateint800视频码率,取值范围(0,10000],单位kbps
videofpsint24视频帧率,取值范围(0,100)
videogopint72视频GOP,取值范围(0,1000),计算方式为videofps乘GOP时间间隔(秒)
videoencodeint100视频编码
100:H264
101:H265
默认H264,暂不支持265
audiobitrateint64音频码率,单位kbps,填固定值64,实际会根据audioencode值进行调整
audiochannelint2音频声道数,填固定值2
audiosampleint44100音频采样率,填固定值44100
audioencodeint1音频编码
1:AAC+
35:AAC(128kbps)
patchint1视频补帧方式:0-不补帧,1-补黑屏,2-补最后一帧,3-补指定图片
patchUrlstring 补帧方式=3,指定图片地址,长度不超过256字节
seilayoutint1混画sei选项,seilayout=1时将视频源流布局信息打进混流视频中的SEI字段

2.3 templateid参数说明

2.3.1 水平布局

首用户在上方显示大窗画面,其他用户在下方排列显示小窗画面,小窗画面悬浮于大窗画面之上。小窗最多两行,一行最多8个画面,最多支持17个用户画面。

  • 视频画面个数在2-5时,效果如下:
    img
  • 视频画面个数在6-7时,效果如下:
    img
  • 视频画面个数在8-9时,效果如下:
    img
  • 视频画面个数在9-17时,效果如下:
    img

2.3.2 垂直布局

首用户在左侧显示大窗画面,其他用户在右侧排列显示小窗画面,小窗最多两列,一列最多8个画面,最多支持17个用户画面。

小窗画面与大窗画面是分开的。

  • 视频画面个数在2-5时,效果如下:
    img
  • 视频画面个数在6-7时,效果如下:
    img
  • 视频画面个数在8-9时,效果如下:
    img
  • 视频画面个数在9-17时,效果如下:
    img

2.3.3 平铺布局

根据用户数量自动调整每个画面的大小,每个用户的画面大小一致,最多支持16个画面(4×4)。

  • 视频画面个数在2个时,效果如下:
    img
  • 视频画面个数在3-4时,效果如下:
    img
  • 视频画面个数在5-9时,效果如下:
    img
  • 视频画面个数在10-16时,效果如下:
    img

2.3.4 角落布局

首用户铺满大窗,每个角落悬浮一个小窗,最多支持4个小窗一共5个画面。目前仅支持一个固定布局,画布大小为1280*720,每个小窗大小为300*300。效果如下: img

3 注意事项

  • 跨频道混流时,暂不支持混流模板。
  • 如需定制其它布局模板,请联系技术支持
<