更改布局
在录制分流时,可修改录制布局。
注意
如果录制 mcu 合流,无法通过此 API 修改配置。
开通服务
云端录制为付费增值服务。
- 在开发环境下,可免费体验云端录制服务。可登录控制台,在 云端录制页面开通服务,查看免费体验额度。
- 在生产环境下,需要预存费用才能开通服务。
在使用云端录制 API 之前,请确认已在控制台开通云端录制服务,并已完成相关配置。请注意,录制触发方式需要配置为手动才能使用 API 控制录制服务。详见配置云端录制服务。
请求方法
POST: http(s)://api.rong-api.com/rtc/record/config.json
签名规则: 所有请求融云服务端 API 接口的请求均需要进行规则校验,详见 API 请求签名。
正文参数
HTTP 请求正文中包含具有以下结构的 JSON 对象:
参数 | 类型 | 必传 | 说明 |
---|---|---|---|
sessionId | String | 是 | 当前通话的会话 ID。您可以通过融云服务端回调获取该 sessionId ,请参见房间状态同步。 |
mixLayout | Number | 是 | mix 模式下的视频合流布局方式,可选项: 1:自定义布局 2:悬浮布局 3:自适应布局 默认值为悬浮布局。详见了解合流布局。 |
renderMode | Number | 是 | 视频的填充方式,可选项: 1:等比放大填充(相对视频源会有裁剪) 2:等比缩放(可能会有黑边) 默认值为等比缩放。 |
hostUserId | String | 是 | 主画面的用户 ID。 悬浮布局时使用该用户的视频渲染主背景; 自适应布局时使用该用户的视频渲染左上角的画面; 自定义布局时可不传。 |
hostStreamId | String | 是 | 主画面的视频流 ID。 悬浮布局时使用该视频流渲染主背景; 自适应布局时使用该视频流渲染左上角的画面; 自定义布局时可不传。 |
input.video | Array | 是 | 用于设置合流布局每个用户视频子窗口的位置和大小。 |
input.video[i].userId | String | 是 | 子窗口的用户 ID |
input.video[i].streamId | String | 是 | 子窗口的视频流 ID |
input.video[i].x | Number | 是 | 浮点数。子窗口的起始点 x 轴相对坐标 即:距离左边框的像素点 / videoResolution 的宽度 |
input.video[i].y | Number | 是 | 浮点数。子窗口的起始点 y 轴相对坐标 即:距离上边框的像素点 / videoResolution 的高度 |
input.video[i].width | Number | 是 | 浮点数。子窗口的相对宽度 即:子窗口的宽度除以 videoResolution 的宽度 |
input.video[i].height | Number | 是 | 浮点数。子窗口的相对高度 即:子窗口的高度除以 videoResolution 的高度 |