首页 智能媒体服务 API参考指南 API目录 实时处理 实时媒体录制 SubmitLiveRecordJob - 提交实时录制任务

SubmitLiveRecordJob - 提交实时录制任务

调用SubmitLiveRecordJob提交实时录制任务,对直播流进行录制。

接口说明

该接口目前支持阿里云直播或第三方RTMP直播流录制。建议先推流再调用本接口提交录制任务。如果直播流地址拉不到流,任务会尝试拉流3分钟。超时后录制服务将停止录制。

提交录制任务前,需准备好阿里云OSS或VOD存储空间。建议使用在智能媒体服务中配置的存储地址,便于对录制生成的文件进行管理和处理。

如果系统预置的录制模板不符合需求,可自行创建定制录制模板。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
NotifyUrlstring

回调地址

https://example.com/imsnotify
StreamInputobject

直播流地址。

Typestring

直播流地址类型。目前支持rtmp。

rtmp
枚举值:
- rtmp: rtmp
Urlstring

直播流地址。

rtmp://example.com/live/stream1
RecordOutputobject

录制存储地址。

Typestring

存储地址类型。

oss
Bucketstring

存储空间名称。

imsbucket1
Endpointstring

存储服务地址。

oss-cn-hangzhou.aliyuncs.com
TemplateIdstring

录制模板ID。

69e1f9fe-1e97-11ed-ba64-0c42a1b73d66
Namestring

录制任务名称。

live stream record 1

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求ID。

BEA98A0C-7870-15FE-B96F-8880BB600A2C
JobIdstring

录制任务ID。

ab0e3e76-1e9d-11ed-ba64-0c42a1b73d66

示例

正常返回示例

JSON格式

{
  "RequestId": "BEA98A0C-7870-15FE-B96F-8880BB600A2C",
  "JobId": "ab0e3e76-1e9d-11ed-ba64-0c42a1b73d66"
}

错误码

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

阿里云首页 智能媒体生产 相关技术圈