添加直播录制转点播配置 -

使用说明

调用本接口添加直播录制转点播配置，将录制内容保存到点播媒资库。

说明使用金融云账号不支持视频直播录制到点播。

QPS限制

本接口的单用户QPS限制为1000次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	AddLiveRecordVodConfig	系统规定参数。取值：AddLiveRecordVodConfig。
DomainName	String	是	example.com	主播流域名。说明请先确认与此播放域名直播中心相同区域的点播已开通服务。
AppName	String	是	testName	播流所属应用名称。
StreamName	String	否	stream	播流名称。
VodTranscodeGroupId	String	是	e2d796d3bb5fd8049d32bff62f94****	点播转码模板组ID。
CycleDuration	Integer	否	300	周期录制时长。单位：秒。默认值为3600，取值范围：300~21600。
AutoCompose	String	否	ON	设置为ON表示开启自动合并，且必须同时设置请求参数ComposeVodTranscodeGroupId。不传入参数值表示关闭自动合并。说明开启自动合并，会使用视频点播服务剪辑合成功能。该功能计费详情，请参见剪辑合成计费。
StorageLocation	String	否	****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com	存储地址。
ComposeVodTranscodeGroupId	String	否	*****	对自动合成出来的新视频在点播服务中进行一次转码，所使用的点播转码模板组ID。说明当AutoCompose（是否开启自动合并）设为ON时，本参数才必填。自动合成和转码常见问题，请参见直播转点播常见问题FAQ。点播转码计费详情，请参见媒资转码计费。
OnDemand	Integer	否	0	按需录制，取值： 0（默认值）：关闭。 1：通过HTTP回调方式。

返回数据

名称	类型	示例值	描述
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddLiveRecordVodConfig
&AppName=AppName
&DomainName=example.com
&VodTranscodeGroupId=e2d796d3bb5fd8049d32bff62f94****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<AddLiveRecordVodConfigResponse>
	<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveRecordVodConfigResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

错误码

HttpCode	错误码	错误信息	描述
400	ConfigAlreadyExists	Config has already exist.	配置已添加。

访问错误中心查看更多错误码。