当您需要修改视频的编码格式、降低分辨率和码率以缩小视频文件体积、转换视频封装格式,甚至是提高视频质量时,可以使用视频转码功能。本文介绍视频转码处理功能参数及示例。
注意事项
视频转码仅支持异步处理(x-oss-async-process处理方式)。
使用视频转码前,需要先绑定IMM Project。关于控制台和API如何绑定,请参见快速入门和AttachOSSBucket。
不支持匿名访问。
必须拥有IMM处理所需的相关权限。更多信息,请参见权限。
参数说明
操作名称:video/convert
具体参数如下表所示。
参数 | 类型 | 是否必选 | 描述 |
ss | int | 否 | 起始时间,单位为毫秒。取值:
|
t | int | 否 | 转码时长,单位为毫秒。取值:
|
f | string | 否 | 媒体容器类型。取值:
|
vn | int | 否 | 是否禁用视频流。取值:
|
vcodec | string | 否 | 视频codec(编码格式)。取值:
|
fps | float | 否 | 视频帧率。取值范围:0~240。 |
fpsopt | int | 否 | 视频帧率选项。取值:
|
pixfmt | string | 否 | 像素采样格式,默认与源视频一致。取值:
|
s | string | 否 | 分辨率。
|
sopt | int | 否 | 分辨率选项。取值:
|
scaletype | string | 否 | 缩放方式。取值:
|
arotate | int | 否 | 自适应分辨率方向。取值:
|
g | int | 否 | 关键帧。取值范围:1~100000。 |
vb | int | 否 | 视频比特率(码率),单位为比特/秒(bps)。取值范围:10000~100000000。 |
vbopt | int | 否 | 视频码率选项。取值:
|
crf | float | 否 | 码率控制因子。取值范围:0~51。 |
maxrate | int | 否 | 峰值码率,单位为比特/秒(bps)。取值范围:10000~100000000。 |
bufsize | int | 否 | 缓冲区大小,单位为比特(bits)。取值范围:10000~200000000。 |
an | int | 否 | 是否禁用音频流。取值:
|
acodec | string | 否 | 音频codec(编码格式)。取值:
|
ar | int | 否 | 音频采样率。取值:
|
ac | int | 否 | 音频声道数。默认保持源音频的声道数。取值范围:1~8。 |
aq | int | 否 | 音频压缩质量。与参数ab互斥。取值范围:0~100。 |
ab | int | 否 | 音频比特率(码率)。与参数aq互斥,单位为比特/秒(bps)。取值范围:1000~10000000。 |
abopt | int | 否 | 音频码率选项。取值:
|
sn | int | 否 | 是否禁用字幕。取值:
|
segment | string | 否 | 媒体切片设置,默认不进行切片。 |
f | string | 否 | 媒体切片方式。取值:
父节点:segment |
t | int | 否 | 切片长度,单位为毫秒。取值范围:0~3600000。 父节点:segment |
使用REST API
将AVI格式转换为MP4格式
转码信息
转码前
视频格式:AVI
视频名称:example.avi
处理方式:视频转码
转码后
视频信息
视频格式:MP4
视频名称:outobjprefix.mp4
视频流格式:H.265
视频分辨率:1920x1080
视频帧率:30 fps
视频码率:2 Mbps
音频信息
音频流格式:AAC
音频码率:100 Kbps
字幕流:禁用
文件存储路径:oss://outbucket/outobjprefix.mp4
处理示例
POST /exmaple.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
// 对文件example.avi进行视频转码,转码输出媒体文件容器为MP4,视频流格式为H.265,分辨率为1920x1080,帧率为30 fps,视频码率为2 Mbps;音频流格式为AAC,音频码率为100 Kbps;禁用字幕流;转码完成后将得到的文件保存为oss://outbucket/outobjprefix.mp4。
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ
将AVI格式转换为TS格式
转码信息
转码前
视频格式:AVI
视频名称:example.avi
处理方式
转码时长:从输入媒体文件的第1000毫秒开始并持续60000毫秒进行视频转码
切片方式:按30秒间隔进行HLS切片
转码完成消息通知:发送MNS消息
转码后
视频信息
视频格式:TS
视频流格式:H.264
视频码率:1 Mbps
音频信息
音频格式:AAC
音频码率:100 Kbps
文件存储路径
ts文件:oss://outbucket/outobjprefix-%d.ts
m3u8文件:oss://outbucket/outobjprefix.m3u8
处理示例
POST /exmaple.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
// 对文件example.avi进行视频转码。
x-oss-async-process=video/convert,ss_10000,t_60000,f_ts,vcodec_h264,vb_1000000,acodec_mp3,ab_100000/segment,f_hls,t_30000|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ/notify,topic_QXVkaW9Db252ZXJ0
将AVI格式转换为MP3格式
转码信息
转码前
视频名称:example.avi
视频格式:AVI
处理方式:提取音频并将提取的音频进行转码
转码后
音频容器:MP3
音频编码格式:MP3
音频码率:100 Kbps
视频流:禁用
字幕流:禁用
文件存储路径:音频文件存储路径为oss://outbucket/outobjprefix.mp3,如果视频有多路音频,默认只处理第一路音频。
处理示例
POST /exmaple.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****
// 对文件example.avi进行音频提取并将提取的音频进行转码。
x-oss-async-process=video/convert,f_mp3,acodec_mp3,ab_100000,vn_1,sn_1|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ
使用SDK
视频转码仅支持异步处理,SDK使用方法请参见使用SDK。
常见问题
视频转码时提示无法找到资源怎么办?
视频转码时出现报错信息“ResourceNotFound, The specified resource Attachment is not found.”,可能是因为您没有绑定Bucket。
请在创建IMM项目后绑定Bucket。具体操作,请参见步骤二:绑定Bucket。
视频转码时能否转存到原路径?
不可以。视频转码时输出路径应避免以输入路径为前缀,否则将导致触发器循环触发和源文件被覆盖等非预期行为。
- 本页导读 (1)