音视频处理（avthumb）

• 描述
• 接口规格
• 示例
• 附注
• 内部参考资源

描述

音视频处理是七牛云存储提供的云处理功能，方便用户对音视频资源进行编码和格式转换。

接口规格

注意：接口规格不含任何空格与换行符，下列内容经过格式化以便阅读。

avthumb/<Format>
       /ab/<BitRate>
       /aq/<AudioQuality>
       /ar/<SamplingRate>
       /ac/<ChannelNum>
       /r/<FrameRate>
       /vb/<VideoBitRate>
       /vcodec/<VideoCodec>
       /acodec/<AudioCodec>
       /scodec/<SubtitleCodec>
       /subtitle/<SubtitleURL>
       /ss/<SeekStart>
       /t/<Duration>
       /s/<Resolution>
       /autoscale/<Autoscale>
       /aspect/<Aspect>
       /stripmeta/<StripMeta>
       /rotate/<Degree>
       /wmImage/<EncodedRemoteImageUrl>
       /wmGravity/<Gravity>
       /wmText/<text>
       /wmGravityText/<gravity_text>
       /wmFont/<font>
       /wmFontColor<fontcolor>
       /wmFontSize<fontsize>
       /writeXing/<Xing>
       /an/<AudioNo>
       /vn/<VideoNo>       

注意

转码操作若未指定音视频码率，转码结果的码率会小于等于原音视频码率，若指定码率大于原音视频码率，转码操作会使用原视频码率进行转码。

示例

1. 以预转持久化形式，将wav音频转换为mp3格式：

   {
       "scope":                "qiniu-ts-demo:sample.wav",
       "deadline":             1390528576,
       "persistentOps":        "avthumb/mp3",
       "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
   }
   

2. 以预转持久化形式，将wav音频转换为mp3格式，比特率为192k：

   {
       "scope":                "qiniu-ts-demo:sample.wav",
       "deadline":             1390528576,
       "persistentOps":        "avthumb/mp3/ab/192k",
       "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
   }
   

3. 以预转持久化形式，将mp4视频转换为flv格式，帧率为24，使用x264进行视频编码：

   {
       "scope":                "qiniu-ts-demo:thinking-in-go.mp4",
       "deadline":             1390528576,
       "persistentOps":        "avthumb/flv/r/24/vcodec/libx264",
       "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
   }
   

4. 以预转持久化形式，将mp4视频转换为avi格式，使用mp3进行音频编码，且音频比特率为64k：

   {
       "scope":                "qiniu-ts-demo:thinking-in-go.mp4",
       "deadline":             1390528576,
       "persistentOps":        "avthumb/avi/ab/64k/acodec/libmp3lame",
       "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
   }
   

5. 以触发持久化处理形式，将wav音频转换为mp3格式，VBR参数为3，采样频率为44100：

   POST /pfop/ HTTP/1.1
   Host: api.qiniu.com  
   Content-Type: application/x-www-form-urlencoded
   #Authorization头部的`<AccessToken>`前添加`QBox`和半角空格  
   Authorization: QBox <AccessToken>  
   bucket=qiniu-ts-demo
   &key=sample.wav
   &fops=avthumb%2Fmp3%2Far%2F44100%2Faq%2F3
   &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
   

6. 以触发持久化处理形式，将mp4视频转换为flv格式，帧率为30，视频比特率为256k，使用x264进行视频编码，音频采样频率为22050，音频比特率为64k，使用mp3进行音频编码：

   POST /pfop/ HTTP/1.1
   Host: api.qiniu.com  
   Content-Type: application/x-www-form-urlencoded
   #Authorization头部的`<AccessToken>`前添加`QBox`和半角空格  
   Authorization: QBox <AccessToken>  
   bucket=qiniu-ts-demo
   &key=thinking-in-go.mp4
   &fops=avthumb%2Fflv%2Fr%2F30%2Fvb%2F256k%2Fvcodec%2Flibx264%2Far%2F22050%2Fab%2F64k%2Facodec%2Flibmp3lame
   &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
   

7. 以触发持久化处理形式，将mp4视频转换为ogv格式，帧率为30，视频比特率为1800k，使用libtheora进行视频编码，音频采样频率为44100，音频比特率为128k，使用libvorbis进行音频编码：

   POST /pfop/ HTTP/1.1
   Host: api.qiniu.com  
   Content-Type: application/x-www-form-urlencoded
   #Authorization头部的`<AccessToken>`前添加`QBox`和半角空格  
   Authorization: QBox <AccessToken>  
   bucket=qiniu-ts-demo
   &key=thinking-in-go.mp4
   &fops=avthumb%2Fogv%2Fr%2F30%2Fvb%2F1800k%2Fvcodec%2Flibtheora%2Far%2F44100%2Fab%2F128k%2Facodec%2Flibvorbis
   &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
   

以上示例的处理结果通知方式请参考持久化处理结果通知。

附注

• 支持的视频编码器（Codec）有：libx264，libvpx，libtheora，libxvid等。
• 支持的音频编码器（Codec）有：libmp3lame，libfaac，libvorbis等。
  
• 我们为一些预设集设置了默认参数，如果用户觉得某些参数不适合自己的业务场景可以在后面加参数覆盖。
  • 如： avthumb/mp3/ab/64k 会把默认码率128k调整为64k

默认参数列表：

内部参考资源

• 预转持久化处理
• 触发持久化处理