全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件 ET大脑
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
视频直播

添加APP录制配置

更新时间:2018-07-18 10:08:09

描述

配置 APP 录制,输出内容保存到 OSS 中。

请求参数

参数 类型 是否必选 示例值 描述
Action String AddLiveAppRecordConfig

系统规定参数,取值:AddLiveAppRecordConfig

AppName String test123

直播流所属应用名称。
支持通配符*,代表该域名下所有的 AppName。

DomainName String test.com

加速域名。

OssBucket String test123

OssBucket名称。

OssEndpoint String oss-cn-shanghai.aliyuncs.com

OssEndpoint域名。

EndTime String 2018-04-16T09:57:21Z

录制结束时间。
设置时间必须从当前时间开始15天之内的时间,只在流级别录制(StreamName不为空)有效,且时间应晚于录制开始时间。

OnDemand Integer 1

按需录制。

  • 0表示关闭。
  • 1表示通过HTTP回调方式。
  • 2表示通过推流参数方式。
使用1方式时候需要设置OnDemandCallback,否则默认不录制。

RecordFormat.N.CycleDuration Integer 1

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

RecordFormat.N.Format String m3u8

格式。
目前支持 m3u8、flv、mp4 周期录制。

RecordFormat.N.OssObjectPrefix String record/{AppName}/{StreamName}/{Sequence}{EscapedStartTime}{EscapedEndTime}

OSS 存储的录制文件名。

  • 小于 256 byte。
  • 支持变量匹配,包含 {AppName}、{StreamName}、{Sequence}、{EscapedStartTime}、{EscapedEndTime}。
  • 例如:record/{AppName}/{StreamName}/{Sequence}{EscapedStartTime}{EscapedEndTime}
  • 参数值必须要有{EscapedStartTime} 和 {EscapedEndTime} 变量。
  • 默认支持 1 小时周期录制,最小周期时间 15 分钟,最多 6 小时。
  • {EscapedStartTime}/{EscapedEndTime} 格式为:2006-01-02-15-04-05。
  • 推荐使用 Escaped 格式,避免特殊字符在 URL 中带来的一些问题。

RecordFormat.N.SliceOssObjectPrefix String record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}

当 format 格式是 m3u8 录制,则需要配置,表示 ts 切片名称。

  • 默认 30 秒一片,小于 256byte。
  • 支持变量匹配,包含{AppName}、{StreamName}、{UnixTimestamp}。
  • 例如:record/{AppName}/{StreamName}/{UnixTimestamp}。
  • 参数值必须包含{UnixTimestamp}变量。

StartTime String 2018-04-10T09:57:21Z

录制开始时间。
设置时间必须从当前时间开始15天之内的时间, 只在流级别录制(StreamName不为空)有效。

StreamName String teststream

流名称。

返回参数

参数 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID

示例

请求示例

  1. /?AppName=test123
  2. &DomainName=test.com
  3. &OssBucket=test123
  4. &OssEndpoint=oss-cn-shanghai.aliyuncs.com
  5. &Action=AddLiveAppRecordConfig
  6. &RecordFormat.1.Format=m3u8
  7. &AccessKeyId=XxlctR6mMqO6mhXxX
  8. &EndTime=2018-04-16T09:57:21Z
  9. &OnDemand=1
  10. &RecordFormat.1.CycleDuration=1
  11. &RecordFormat.1.OssObjectPrefix=record/{AppName}/{StreamName}/{Sequence}{EscapedStartTime}{EscapedEndTime}
  12. &RecordFormat.1.SliceOssObjectPrefix=record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
  13. &StartTime=2018-04-10T09:57:21Z
  14. &StreamName=teststream
  15. &<公共请求参数>

正常返回示例

JSON 格式

  1. {
  2. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  3. }

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

错误码

查看本产品错误码

本文导读目录