AddLiveAppRecordConfig
配置APP录制,输出内容保存到OSS中
服务地址:
华东2(上海)
输入参数
只看必填
DomainName主播流域名
AppName播流所属应用名称
OssEndpointOSS存储的Endpoint名称
OssBucketOSS存储的Bucket名称
StreamName播流名称
StartTime录制开始时间
EndTime录制结束时间
OnDemand按需/手动录制
DelayTime断流拼接时长
RecordFormat记录详情
0
SliceDuration单个切片时长
SliceOssObjectPrefix切片名称
CycleDuration周期录制时长
OssObjectPrefixOSS存储的录制文件名
Format格式
TranscodeRecordFormat转码记录详情
0
SliceDuration转码流录制单个切片时长
SliceOssObjectPrefix转码流录制切片名称
CycleDuration转码流录制周期录制时长
OssObjectPrefix转码流录制OSS存储的录制文件名
Format转码流录制格式
TranscodeTemplates转码流录制的转码模板组
0- 转码流录制的转码模板
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 请确保在使用该接口前,已充分了解直播录制的收费方式和价格。计费详情,请参见直播录制费用

  • 若采用录制存储至 OSS 方式进行直播录制功能配置,需要开通 OSS 服务以及创建 Bucket,具体操作请参见配置 OSS

  • 录制文件存储在 OSS 中,会产生存储费用,在 OSS 中计费详情请参见存储费用

  • 直播录制功能,可以将直播内容进行录制,保存至您指定的位置,在您需要回看直播内容时可以进行回看。存储至 OSS 的录制内容,支持多种保存格式(TS、MP4、FLV、CMAF),支持自定义录制策略(自动录制、按需录制、手动录制),调用此接口可进行录制模版设置。更多直播录制功能使用可参见直播录制说明文档。

  • (DomainName, AppName, StreamName)三元组只能对应一个配置,如果该三元组已经存在一个配置了,再调用本接口添加配置会返回配置已存在错误。

  • 通过该接口设置的各项配置,需要在直播重新推流之后才能生效,并且长期有效。

QPS 限制

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

请求参数

字段名称字段详情
DomainNamestring

主播流域名。

示例值:example.com参考取值来源:
    AddLiveDomain
    DescribeDomainUsageData
    ListLiveRealtimeLogDeliveryDomains
AppNamestring

播流所属应用名称。AppName 名称与推流地址中的 AppName 名称对应,模板才能生效。若不限制 AppName 可填*,即可匹配所有 AppName。

示例值:liveApp****参考取值来源:
    GetMessageApp
    ListMessageApp
    QueryMessageApp
    CreateMessageApp
OssEndpointstring

OSS 存储的 Endpoint 名称。展开详情

示例值:learn.developer.aliyundoc.com
OssBucketstring

OSS 存储的 Bucket 名称。展开详情

示例值:liveBucket****
StreamNamestring

播流名称。StreamName 名称与推流地址中的 StreamName 名称对应,模板才能生效。若不限制 StreamName 可填*,即可匹配 AppName 下所有 StreamName。

示例值:teststream参考取值来源:
    AddLiveStreamMerge
    DescribeMixStreamList
    QueryLiveDomainMultiStreamList
StartTimestring

录制开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。展开详情

示例值:2018-04-10T09:57:21Z
EndTimestring

录制结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。展开详情

示例值:2018-04-16T09:57:21Z
OnDemandinteger<int32>

按需/手动录制。取值:展开详情

示例值:1
DelayTimeinteger<int32>

断流拼接时长。展开详情

示例值:180
RecordFormatarray<object>

记录详情。

子级条数 <= 3
TranscodeRecordFormatarray<object>

转码记录详情。

子级条数 <= 3
TranscodeTemplatesarray<string>

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

示例值:sd子级条数 <= 10

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:16A96B9A-F203-4EC5-8E43-CB92E68F****
变更历史
暂无变更历史