CreateLiveRecordTemplate - 创建实时录制模板 - 智能媒体服务

接口说明

实时录制需指定录制模板。录制模板可以设置录制文件的输出格式（m3u8、mp4、flv）、录制文件时长等信息。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:CreateLiveRecordTemplate

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RecordFormat	array<object>	是	录制格式列表
	object	否	录制格式
Format	string	是	格式。说明如果选择 m3u8 格式，必须同时设置请求参数 SliceOssObjectPrefix 和 SliceDuration。	m3u8
SliceDuration	integer	否	单个切片时长。单位：秒。说明当 Format（格式）设为 m3u8 时，本参数才有效。不填则默认为 30 秒。取值范围：5s~30s。	30
OssObjectPrefix	string	否	OSS 存储的录制文件名。文件名小于 256 字节，支持变量匹配，包含{JobId}、{Sequence}、{StartTime}、{EndTime}、{EscapedStartTime}、{EscapedEndTime}。参数值必须要有{StartTime}或{EscapedStartTime}和{EndTime}或{EscapedEndTime}。	record/{JobId}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}
SliceOssObjectPrefix	string	否	TS 切片名称。说明当 Format（格式）设为 m3u8 时，本参数才需要配置。默认 30 秒一片，小于 256 字节，支持变量匹配，包含{JobId}、{UnixTimestamp}、{Sequence}。参数值必须包含{UnixTimestamp}和{Sequence}变量。	record/{JobId}/{UnixTimestamp}_{Sequence}
CycleDuration	integer	否	周期录制时长。单位：秒。不填则默认为 6 小时。说明如果在一个录制周期内，直播流发生了断流，但是在 3 分钟内，该直播流又正常推流，那么仍会在同一个录制文件中继续录制。一条直播流必须断流超过 3 分钟，才会生成最后一个录制文件。如果您需要修改默认的 3 分钟断流时间，可以提交工单进行修改。	3600
Name	string	是	模板名称。

返回参数

名称	类型	描述	示例值
	object	Schema of Response
TemplateId	string	模板 ID	**96e8864746a0b6f3**
RequestId	string	请求 ID	0622C702-41BE-467E-AF2E-883D4517962E

示例

正常返回示例

JSON格式

{
  "TemplateId": "****96e8864746a0b6f3****",
  "RequestId": "0622C702-41BE-467E-AF2E-883D4517962E"
}

错误码

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

变更历史

更多信息，参考变更详情。