音视频分段(segment)
简介
音视频分段(segment),用于按时长或时间点对原视频分段,不改变原音/视频的编码格式、分辨率、码率等,将原音/视频切成多个较小的文件。
注意:如果原音视频文件的编码格式无法封装到目标封装格式,那么会返回错误。
参数规格
segment/<Format>
/segtime/<SegmentTime>
/savePattern/<savePattern>
参数名称 | 类别 | 必填 | 说明 |
---|---|---|---|
<Format> |
A/V | 是 | 指定分段文件的封装格式,不改变原音/视频的编码情况下可以改变封装格式,如 h264+aac 编码的 mp4文件可以分段为h264+aac 编码的 mkv 小文件。 |
/segtime/<SegmentTime> |
A/V | 否 | 自定义分段后每一小段音/视频流的播放时长。单位为秒,最小值为5,默认值为5。 |
/savePattern/<savePattern> |
A/V | 是 | 自定义分段后每一小段音/视频流的文件名称。 命名支持使用变量: 1. 可以使用 $(变量名) 或${变量名} 形式求值,魔法变量使用说明,参考 文件名变量 。2. 注意: $(count) 为必填项,必须存在的六位占位符数字串。示例: 源文件名为: input.mp4 ,cmd为:avthumb/mp4/segtime/10/savePattern/JChrZXliYXNlKSAkKGNvdW50KS5tcDQg ,其中 JChrZXliYXNlKSAkKGNvdW50KS5tcDQg 是自定义分段后的文件名, $(keybase) $(count).mp4 的URL安全的Base64编码。最后得到类似:input000000.mp4,input000001.mp4,……,input000006.mp4 命名的文件,跟源文件命名是关联的。 |
操作方式
您可以通过以下几种方式来创建任务:
方式一:使用任务触发器
-
对符合规则策略的上传文件自动触发
:在具体空间下,选择任务与工作流,进入任务触发器页面,点击新建 任务触发器;创建完成后,需要开启 上传触发开关,然后通过左侧文件管理或 API/SDK 上传文件到触发器指定的输入路径;将对符合规则策略的上传文件自动触发多媒体处理,并将结果文件保存到目标路径。
方式二:使用对象存储控制台
-
上传文件手动触发
:在具体空间下, 上传文件 时,指定工作流模板 。 -
指定文件手动触发
:有两种指定单个文件创建任务的入口-
第一个入口:在具体空间下,在文件列表中指定文件,在操作栏【更多】中点击【创建多媒体任务】。
注意:仅对音视频/gif动图/webp动图文件提供该操作。
-
第二个入口:在具体空间下,选择任务与工作流,进入任务管理页面,点击【新建任务】。
-
操作示例
用户可以根据需要自定义命令,例如:
segment/mp4/segtime/10/pattern/cWluaXUtJChmbmFtZSkkKGNvdW50KQ==
命令的调用将对原音/视频以10秒左右的时间进行分段,最后将生成多个小段音视频文件。
响应内容
如果请求成功,返回类似如下内容的 JSON 字符串
"result": [
{
"index": 0,
"segment_end_time": "10.857422",
"segment_filename": "qiniu-000000",
"segment_start_time": "0.000000"
},
{
"index": 1,
"segment_end_time": "21.177422",
"segment_filename": "qiniu-000001",
"segment_start_time": "10.857422"
},
{
"index": 2,
"segment_end_time": "21.857422",
"segment_filename": "qiniu-000002",
"segment_start_time": "21.177422"
}
]
计费说明
音视频分段服务涉及转封装但不涉及转码,服务价格=音视频装封装价格,定价参考 智能多媒体服务定价 。
文档反馈
(如有产品使用问题,请 提交工单)