接口请求域名: trtc.tencentcloudapi.com 。
接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。
您可以通过此接口实现如下目标:
目前已经支持了如下几种布局模板:
注意:2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流,如需切换至MCU混流,请提交工单寻求帮助。
默认接口请求频率限制:20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:StartMCUMixTranscodeByStrRoomId。 |
Version | 是 | String | 公共参数,本接口取值:2019-07-22。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
SdkAppId | 是 | Integer | TRTC的SDKAppId。 |
StrRoomId | 是 | String | 字符串房间号。 |
OutputParams | 是 | OutputParams | 混流输出控制参数。 |
EncodeParams | 是 | EncodeParams | 混流输出编码参数。 |
LayoutParams | 是 | LayoutParams | 混流输出布局参数。 |
PublishCdnParams | 否 | PublishCdnParams | 第三方CDN转推参数。 |
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
启动指定房间(字符串房间号为Room_3560)的云端混流,同时指定各路画面按屏幕分享模板排布。
设置云端混流参数如下:
https://trtc.tencentcloudapi.com/?Action=StartMCUMixTranscodeByStrRoomId
&SdkAppId=1400188366
&StrRoomId=Room_3560
&OutputParams.StreamId=1400188366_3560_mix
&OutputParams.PureAudioStream=0
&OutputParams.RecordId=1400188366_3560_mix_file
&OutputParams.RecordAudioOnly=0
&EncodeParams.VideoWidth=1280
&EncodeParams.VideoHeight=720
&EncodeParams.VideoBitrate=1560
&EncodeParams.VideoFramerate=15
&EncodeParams.VideoGop=2
&EncodeParams.BackgroundColor=0
&EncodeParams.AudioSampleRate=48000
&EncodeParams.AudioBitrate=64
&EncodeParams.AudioChannels=2
&LayoutParams.Template=2
&LayoutParams.MainVideoUserId=main_pc
&LayoutParams.MainVideoStreamType=1
&<公共请求参数>
{
"Response": {
"RequestId": "eac6b301-a322-493a-8e36-83b295459397"
}
}
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation.RequestRejection | 云API混流模板和SDK混流冲突。 |
FailedOperation.RoomNotExist | 房间不存在。 |
InternalError | 内部错误。 |
InvalidParameter.AudioEncodeParams | 音频编码参数错误。 |
InvalidParameter.EncodeParams | EncodeParams参数错误。 |
InvalidParameter.MainVideoStreamType | 大画面流类型错误。 |
InvalidParameter.OutputParams | OutputParams参数错误。 |
InvalidParameter.PresetLayoutConfig | 自定义布局参数错误。 |
InvalidParameter.PureAudioStream | 纯音频推流参数错误。 |
InvalidParameter.RecordAudioOnly | 纯音频录制参数错误。 |
InvalidParameter.RecordId | RecordId参数错误。 |
InvalidParameter.RoomId | RoomId参数错误。 |
InvalidParameter.SdkAppId | SdkAppId参数错误。 |
InvalidParameter.SmallVideoLayoutParams | 小画面布局参数错误。 |
InvalidParameter.SmallVideoStreamType | 小画面布局中流类型参数错误。 |
InvalidParameter.StreamId | StreamId参数错误。 |
InvalidParameter.VideoResolution | 视频分辨率参数错误。 |
InvalidParameterValue.RoomId | RoomId值错误。 |
MissingParameter.AudioEncodeParams | EncodeParams中缺少音频输出参数。 |
MissingParameter.BizId | 转推参数中缺少BizId。 |
MissingParameter.EncodeParams | 缺少EncodeParams参数。 |
MissingParameter.OutputParams | 缺少OutputParams参数。 |
MissingParameter.PresetLayoutConfig | 缺少自定义布局参数。 |
MissingParameter.PublishCdnParams | 缺少转推参数。 |
MissingParameter.PublishCdnUrls | 转推参数中缺少转推目的地址。 |
MissingParameter.StreamId | OutputParams中缺少StreamId参数。 |
MissingParameter.VideoEncodeParams | EncodeParams中缺少视频输出参数。 |
UnauthorizedOperation.SdkAppId | 没有操作SdkAppId的权限。 |
操作场景 通过设置告警规则,用户可自定义监控目标与通知策略,及时了解虚拟私有...
近日,全球知名调研机构 IDC发布《中国公有云服务市场(2020Q3)跟踪》报告。 报告...
本教程的目的是要预测汽车的燃料效率,相比于之前的分类,这是一个回归问题,回...
概述 云速建站服务(Cloud Site-building Service)是一款帮助您搭建网站的华为...
调用CreateNotificationConfiguration创建弹性伸缩事件及资源变化通知。 接口说...
出现该问题的主要原因: 网络波动导致下载失败。 磁盘IO卡顿导致缓存文件到目标...
01 导入Matplotlib 如果你安装了完整的Python Anaconda,那么你已经安装了Matplo...
很多个人或企业都会在 服务器租用 或 托管服务器 时都不知该如何进行这个带宽选...
调用DetachInstanceRamRole回收一台或多台ECS实例的实例RAM角色。 调试 您可以在...
近日Chrome更新了 87 最新版,这是今年最后一次 Chrome 更新了,这个版本是多年...