文档中心 点播分发 多码率自适应

多码率自适应

更新时间:2024-02-19 10:09:04

一. 功能简介

  由于用户终端多样、接入网络质量参差不齐,内容服务商需要提供多种码率的视频内容供用户自行选择,更有内容服务商提供码率自适应功能,使用户自动访问最合适码率的视频内容,获得最佳的观看体验。

  多码率自适应功能,借助视频转码,实现将客户上传到云存储平台的高码率视频文件,根据约定需求,转码输出多个不同码率的视频文件,生成嵌套的M3u8文件(HLS协议的索引文件)或MPD文件(DASH协议的索引文件)供终端用户访问。客户端可以根据网络质量变化情况,自动平滑切换到和带宽匹配的视频流。

二. 功能说明

  多码率自适应,支持常见的视频/音频封装格式和编码格式的视频源文件,如:

  (1) 视频格式: MP4、FLV、HLS、DASH、TS、MKV、MOV、WMV、AVI、VP8、VP9、RealVideo、Windows Media Video等;

  (2) 音频格式:AAC、AC-3、MP1、MP2、MP3、PCM、RealAudio、Windows Media Audio(WMA)、OGG等;

  (3) 编码格式:H.265、H.264、H.263、MPEG等。

  客户上传视频文件的时候,可以同时配置多码率自适应操作参数,也可以同时配合使用视频转码、视频转封装、音视频操作等功能,即可通过同一条API命令实现多个功能。

2.1. 请求说明


  请求参数以如下格式组织,作为请求内容提交:


bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&fops=<Urlsafe_Base64_Encoded_Fops>&notifyURL=<Urlsafe_Base64_Encoded_PersistentNotifyUrl>&force=<Force>&separate=<Separate>

表1 请求参数说明
参数 必填 描述
bucket 空间名,即:原文件所在的空间
key 文件名,即:原文件的文件名
fops 多码率自适应参数列表;支持同时请求多个处理,参数列表之间用; 分隔,即:fops=Urlsafe_Base64_Encode(操作1;操作2;……)
notifyURL 处理结果通知接收URL,通知数据详细说明处理后的内容信息,比如视频码率、时长等。请参考通知数据内容说明
force 是否强制执行数据处理。支持设置以下数值:
(1)0:指定的数据处理结果如果存在,返回文件已存在,不进行处理,避免重复处理浪费资源;
(2)1:强制执行数据处理并覆盖已有文件;
默认为0。
separate 处理是否分开通知。支持设置以下数值:
(1)0:表示所有转码指令执行完后再一次性通知notifyURL
(2)1:表示每个转码指令执行完后都通知notifyURL
默认为0。

  使用以下格式填充参数后,并将其URL安全的Base64编码后的值填充到fops参数中:


<op>/<Format>
    /envBandWidth/<envBandWidth>
    /multiAb/<MultiAb>
    /multiVb/<MultiVb>
    /multiResolution/<MultiResolution>
    |saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
表2 多码率自适应参数表
参数 必填 描述
<op> avthumb(操作类型-音视频处理)
<format> 输出的目标格式(m3u8、mpd)
/envBandWidth/<EnvBandWidth>m3u8不同码流切换的带宽标准,采用符号“:”分隔多个网络带宽,个数范围[2,10],取值范围(50000,30000000],单位是b/s。例如60000:150000:500000。
注:目标格式为m3u8时使用此参数,则必填,参数个数与存在的multi参数值个数需要保持一致,建议与设置的码率值接近,带宽值采用升序方式。DASH格式配置无效。
/multiAb/<MultiAb>与音频码率参数(ab)不共存,单位:比特每秒(bit/s),采用符号“:”分隔多个音频码率,个数范围[2,10],例如64k:128k:256k。
注:若目标格式为m3u8,则码率个数与其他存在的multi参数值个数需要保持一致。
/multiVb/<MultiVb>与视频码率参数(vb)不共存,单位:比特每秒(bit/s),采用符号“:”分隔多个视频码率,个数范围[2,10],例如128k:600k:1.25m。
注:若目标格式为m3u8,则码率个数与其他存在的multi参数值个数需要保持一致。
/multiResolution/<MultiResolution>与视频分辨率参数(resolution)不共存,分辨率格式为 wxh,采用符号“:”分隔多个视频分辨率,个数范围[2,10]。
1. 正常缩放:设置宽和高,则按配置输出指定宽和高的视频。例如:320x240:640x480:1080x720。会改变视频的长宽比
2. 按宽或高自适应比率输出:仅指定宽(aaax-1)或者高(-1xaaa),则输出会根据原视频的宽高比自适应缩放。例如:320x-1:-1x480:1080x-1。
注:若目标格式为m3u8,则分辨率个数与其他存在的multi参数值个数需要保持一致。
/dash_hls_playlist/<dash_hls_playlist>在已有dash封装上生成m3u8文件,即支持分片列表共源,同样支持多码率自适应。当dash_hls_playlist=1时,在输出mpd文件时,另外生成m3u8文件;默认dash_hls_playlist=0,仅输出mpd文件。
注:仅支持输出的目标格式为mpd
|saveas/<Encode(bucket:filekey)>视频转码另存为指定文件。参数中需要填入"空间:文件名"URL安全的Base64编码后的值,转码后文件另存为指定文件

2.2. 响应说明


  如果请求成功,则返回如下内容的Json串:

{ "persistentId": <persistentId> }  

  如果请求失败,则返回如下内容的Json串:

{
  "code": "<code string>",
  "message":  "<ErrMsg string>"
} 
表3 响应参数说明
字段名 必填 描述
persistentId 上传预处理或者触发持久化处理的进程ID
code HTTP请求响应码,参见HTTP响应状态码<返回码>
message 处理失败的提示信息

2.3. 使用范例


2.3.1 HLS多码率自适应

  实现将vod-wcs-test001空间名下的test.m3u8(对应的ts文件也要上传到此空间下)文件生成嵌套的m3u8文件,存到vod-wcs-test001空间下,并命名为test_file.m3u8。其中,一级m3u8文件指明包含两种不同码率的二级m3u8文件,分别为:

  (1) 带宽:60kb/s,视频码率:128kbit/s,音频码率:64kbit/s,分辨率:320x240;

  (2) 带宽:100kb/s,视频码率:600kbit/s,音频码率:128kbit/s,分辨率:640x480。


 curl -v -X POST –d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test_hls.m3u8)&fops=Urlsafe_Base64_Encode(avthumb/m3u8/envBandWidth/60000:100000/multiAb/64k:128k/multiVb/128k:600k/multiResolution/320x240:640x480|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.m3u8))&force=1&separate=1" –H "Authorization:mgrAuthorization_A:mgrAuthorization_B" --url "http://mgrDomain/fops"

  加密后为:


curl -v -X POST -d"bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdF9obHMubTN1OA==&fops=YXZ0aHVtYi9tM3U4L2VudkJhbmRXaWR0aC81MDAwMDoxMDAwMDAvbXVsdGlBYi82NGs6MTI4ay9tdWx0aVZiLzEyOGs6NjAway9tdWx0aVJlc29sdXRpb24vMzIweDI0MDo2NDB4NDgwfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXRNM1U0&force=1&separate=1" -H "Authorization:mgrAuthorization_A:mgrAuthorization_B" --url "http://mgrDomain/fops"

  其中:

  (1) mgrAuthorization_A:mgrAuthorization_B:管理凭证,由AK(访问密钥)、SK(安全密钥)、Path、Path、Body通过管理凭证生成工具生成,其中AK、SK从“控制台-账号管理-用户信息管理-AccessKey管理”处获取,Path为/fops,Body为请求内容。

  (2) mgrDomain:管理域名,从“控制台-对象存储-对应存储空间-概览”处获取。

2.3.2 DASH多码率自适应

  实现将vod-wcs-test001空间名下的test.mp4生成mpd文件,存到vod-wcs-test001空间下,并命名为test.mpd。其中,mpd文件指明包含两种不同视频码率、单一音频码率的音视频文件,分别为:

  (1)生成不同视频码率和分辨率的两个视频文件:

     A. 视频码率:128kbit/s,分辨率:320x240;

     B. 视频码率:600kbit/s,分辨率:640x480。

  (2)单一音频码率:64kbit/s。

  fops如下:


fops=Urlsafe_Base64_Encode(avthumb/mpd/multiVb/128k:600k/multiAb/64k/multiResolution/320x240:640x480|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test.mpd))

  其余操作请参考 2.3.1 HLS多码率自适应。

  DASH文件的音视频分离,生成的视频和音频可以自由组合成不同质量级别的目标文件。

三. 应用场景

  实现码率自适应功能,保证不同网络环境下的观看体验。

四. 注意事项

  (1) 多码率自适应只能对存储于云存储(WCS)上的视频文件进行操作,因此必须同时开通点播和云存储功能。

  (2) 此功能属于增值服务,若要使用需另行付费。

  (3) 输出的索引文件内的分片文件仅支持文件名形式,例如:00001.ts或者00001.m4s,不支持绝对路径,也不支持相对路径携带参数。

本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!