全部产品
Search

搜索本产品

    视频直播：UpdateLiveAppRecordConfig - 更新直播录制

    文档中心

    视频直播：UpdateLiveAppRecordConfig - 更新直播录制

    更新时间：Dec 05, 2024

    更新配置APP录制，输出内容保存到OSS中。

    接口说明

    先获取主播流域名，再调用本接口更新录制配置。

    QPS 限制

    本接口的单用户 QPS 限制为 30 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

    调试

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

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。
    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
      • 对于必选的资源类型，用背景高亮的方式表示。
      • 对于不支持资源级授权的操作，用全部资源表示。
    • 条件关键字：是指云产品自身定义的条件关键字。
    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    live:UpdateLiveAppRecordConfig
    *Domain
    acs:cdn:*:{#accountId}:domain/{#DomainName}
      无
    		无

    请求参数

    名称类型必填描述示例值
    DomainNamestring是

    主播流域名。

    		example.com
    AppNamestring是

    播流所属应用名称。

    		liveApp****
    OssEndpointstring是

    OSS 存储的 Endpoint 名称。

    直播录制文件存储至 OSS，需提前创建 OSS Bucket，创建方法请参见配置 OSS 。

    		learn.developer.aliyundoc.com
    StreamNamestring否

    播流名称。

    		teststream
    StartTimestring否

    录制开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。

    说明 设置的时间必须是实际推流时间开始 7 天之内，只在流级别录制（StreamName 不为空）有效。
    		2018-04-10T09:57:21Z
    EndTimestring否

    录制结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。

    说明 EndTime 与 StartTime 相差不应超过 7 天，超过 7 天将按照 7 天计算。只在流级别录制（StreamName 不为空）有效。
    		2018-04-16T09:57:21Z
    OnDemandinteger否

    按需录制。取值：

    • 0：关闭。
    • 1：通过 HTTP 回调方式。
    • 2：解析推流参数按需录制。
    • 7：默认不录制，可以通过 RealTimeRecordCommand 接口手动控制录制开启或停止。
    说明 当 OnDemand 取值为 1 时，需要先通过 AddLiveRecordNotifyConfig 接口配置 OnDemandUrl，否则默认不录制。
    		1
    DelayTimeinteger否

    断流拼接时长。 直播断流时长超过设定的拼接时长后，将会生成新文件，断流拼接时长支持 15~21600 秒。

    		180
    RecordFormatarray<object>否

    记录详情。

    object否
    CycleDurationinteger否

    周期录制时长。单位：秒。不填则默认为 6 小时。

    说明
  • 如果在一个录制周期内，直播流发生了断流，但是在断流拼接时长内，该直播流又正常推流，那么仍会在同一个录制文件中继续录制。
  • 一条直播流必须断流超过断流拼接时长，才会生成录制文件。
    •
    		1
    Formatstring否

    格式。目前支持 M3U8、FLV、MP4、CMAF。取值：

    注意 RecordFormat 和 TranscodeRecordFormat 两者至少需要设置一个。如果选择 m3u8 或 cmaf 格式，必须同时设置请求参数 RecordFormat.N.SliceOssObjectPrefix 和 RecordFormat.N.SliceDuration。

    • m3u8。
    • flv。
    • mp4。
    • cmaf。
    		m3u8
    SliceDurationinteger否

    单个切片时长。单位：秒。

    注意 当 RecordFormat.N.Format（格式）设为 m3u8 或 cmaf 时，本参数才有效。

    不填则默认为 30 秒。取值范围：5s~30s。

    		30
    TranscodeRecordFormatarray<object>否

    转码记录详情。

    object否
    CycleDurationinteger否

    转码流录制周期录制时长。单位：秒。不填则默认为 6 小时。

    		21600
    Formatstring否

    转码流录制格式。目前支持 M3U8、FLV、MP4、CMAF。取值：

    注意 这如果选择 m3u8 或 cmaf 格式，必须同时设置请求参数 TranscodeRecordFormat.N.SliceOssObjectPrefix 和 TranscodeRecordFormat.N.SliceDuration。

    • m3u8。
    • flv。
    • mp4。
    • cmaf。
    		m3u8
    SliceDurationinteger否

    转码流录制单个切片时长，单位：秒。

    注意 当 TranscodeRecordFormat.N.Format（转码流录制格式）设为 m3u8 或 cmaf 时，本参数才生效。

    不填则默认为 30 秒。取值范围：5s~30s。

    		30
    TranscodeTemplatesarray否

    转码流录制的转码模板组。

    string否
    • 转码流录制的转码模板，可进行多个设置，最多为 10 个。
    • 当设置 TranscodeRecordFormat.N.xxx 配置时，至少需要设置一个 TranscodeTemplates。
    • 如需录制多个或全部的转码流，可设置 TranscodeTemplates.1 为*****即可。
    说明 TranscodeTemplates 不允许传入raw，属于保留标识。
    RepeatList 表示为 TranscodeTemplates.N 中的 N，可理解为递增进行多个设置，如： TranscodeTemplates.1=sd， TranscodeTemplates.2=hd。
    		sd

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    		16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

    示例

    正常返回示例

    JSON格式

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

    错误码

    HTTP status code错误码错误信息描述
    400InvalidOssEndpoint.Malformed%s-
    400InvalidOssBucket.MalformedSpecified parameter OssBucket is not valid.OSSBucket参数错误，请您确认该OSS BUCKET参数是否正确。
    400InvalidOssBucket.NotFoundThe parameter OssBucket does not exist.OSSBucket参数错误，请您确认该OSS BUCKET参数是否正确。
    400InvalidFormat.MalformedSpecified parameter Format is not valid.Format参数错误，请您确认该Format参数是否正确。
    400InvalidCycleDuration.MalformedSpecified CycleDuration Format is not valid.CycleDuration参数格式错误，请您确认该CycleDuration参数格式是否正确。
    400InvalidSliceDuration.MalformedSpecified SliceDuration Format is not valid.-
    400InvalidTemplateLength.MalformedSpecified record template length is not valid.-
    400InvalidTemplate.ForbidRawTemplate named raw is Forbidden.-
    400MissingTemplateTemplate is mandatory for this action.-
    400MissingOssObjectPrefixOssObjectPrefix is mandatory for this action.缺少OssObjectPrefix值，请您确认OssObjectPrefix值是否正确。
    400MissingSliceOssObjectPrefixSliceOssObjectPrefix is mandatory for this action.-
    400InvalidOssObjectPrefix.MalformedSpecified parameter OssObjectPrefix is not valid.OSSObjectPrefix参数错误，请您确认该OSSObjectPrefix参数是否正确。
    400InvalidSliceOssObjectPrefix.MalformedSpecified parameter SliceOssObjectPrefix is not valid.SliceOssObjectPrefix参数错误，请您确认该SliceOssObjectPrefix参数是否正确。
    400ConfigAlreadyExistsConfig has already exist.配置已添加。
    400InvalidFormat.IllegalOperationSpecified parameter Format can not be multiple.-
    400InvalidDelayTimeSpecified Delaytime is invalid.-
    400Live2Vod.ConfigAlreadyExistsHad live2vod record config already.-
    400InvalidStartTime.MalformedSpecified StartTime is malformed.StartTime参数错误，请您确认该StartTime参数是否正确。
    400InvalidEndTime.MalformedSpecified EndTime is malformed.结束时间错误，请您确认结束时间是否正确。
    400InvalidEndTime.MismatchSpecified EndTime does not math the specified StartTime or current time.-
    400InvalidStartTime.MismatchSpecified StartTime does not math the current time.-
    400ForbiddenRam Permission is forbidden.-

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史