智能多媒体 API

  • 音视频切片

    最近更新时间:2018-05-21 14:03:40

    音视频切片接口用于支持HTTP Live Streaming播放。HTTP Live Streaming 是由 Apple 提出的基于 HTTP 的流媒体传输协议。它将一整个音频、视频流切割成可由 HTTP 下载的一个个小的音视频流,并生成一个 M3U8 播放列表,客户端只需要获取资源的 M3U8 播放列表即可播放音视频。以下用 HLS 代指 HTTP Live Streaming。

    使用方法

    命令可以根据需要自定义,如:

    avthumb/m3u8/noDomain/1/vb/500k/t/10
    

    命令的调用,可以在上传时指定persistentOps参数(即预转持久化),或者调用pfop命令(即触发持久化)。以 Python Sdk 为例,具体可以看下音视频转码的示例。需要在音视频转码的示例的基础修改数据处理命令 fops ,将其修改为:

    fops = avthumb/m3u8/noDomain/1/vb/500k/t/10
    

    注意:
    其他语言 Sdk 可在官方 Sdks 下载,可以通过查看 Sdk 使用指南中触发持久化预转持久化使用,如Python Sdk 使用指南

    接口规格

    avthumb/m3u8/noDomain/<NoDomain>
                /domain/<Domain>
                /segtime/<SegSeconds>
                /ab/<BitRate>
                /aq/<AudioQuality>
                /ar/<SamplingRate>
                /r/<FrameRate>
                /vb/<VideoBitRate>
                /vcodec/<VideoCodec>
                /acodec/<AudioCodec>
                /scodec/<SubtitleCodec>
                /subtitle/<SubtitleURL>
                /ss/<SeekStart>
                /t/<Duration>
                /s/<Resolution>
                /stripmeta/<StripMeta>
                /rotate/<Degree>
                /hlsKey/<HLSKey>
                /hlsKeyType/<HLSKeyType>
                /hlsKeyUrl/<HLSKeyUrl>
                /pattern/<Pattern>
    
    参数名称 类别 必填 说明
    /noDomain/<NoDomain> A/V 取值 0 或 1,默认为 0,推荐取值为 1。表示切片索引中的切片列表,是否使用相对地址,设置为 0 则使用绝对地址,设置为 1 则使用相对地址。
    /domain/<Domain> A/V 用户指定切片中ts文件的域名。
    注意:域名需要urlbase64编码,且不能带http;该参数不能和noDomain/1共同使用。
    /segtime/<SegSeconds> A/V 用于自定义每一小段音/视频流的播放时长,单位为秒,取值范围为5-120秒,默认值为10秒。
    /ab/<BitRate> A 静态码率 (CBR),单位为比特每秒 (bit/s),常用的码率有:64k,128k,192k,256k,320k等。
    /aq/<AudioQuality> A 动态码率 (VBR),取值范围为0-9,值越小码率越高。不能与静态码率参数共用。
    /ar/<SamplingRate> A 音频采样频率,单位为赫兹 (Hz),常用的采样频率有:8000,12050,22050,44100等。
    /r/<FrameRate> V 视频帧率,每秒显示的帧数,单位为赫兹 (Hz),常用的帧率有:24,25,30等,一般用默认值。
    /vb/<VideoBitRate> V 视频比特率,单位为比特每秒 (bit/s),常用的视频比特率有:128k,1.25m,5m等。
    /vcodec/<VideoCodec> V 视频编码方案,支持的方案有:libx264,libvpx,libtheora,libxvid等,默认为libx264。
    /acodec/<AudioCodec> A 音频编码方案,支持的方案有:libmp3lame,libfaac,libvorbis等。
    /scodec/<SubtitleCodec> V 字幕编码方案,支持的方案有:mov_text。该参数仅用于修改带字幕视频的字幕编码。
    /subtitle/<SubtitleURL> V 添加字幕,支持:srt格式字幕 (uft-8编码和和utf-8 BOM编码),带有字幕的mkv文件,embed (将原视频的字幕流嵌入目标视频)。基于base64编码。
    /ss/<SeekStart> V 指定视频截取的开始时间,单位为秒,支持精确到毫秒,例如3.345s。用于视频截取,从一段视频中截取一段视频。
    /t/<Duration> V 指定视频截取的长度,单位为秒,支持精确到毫秒,例如1.500s。用于视频截取,从一段视频中截取一段视频。
    /s/<Resolution> V 指定视频分辨率,格式为:<width>x<height>,或者预定义值。
    /stripmeta/<StripMeta> A/V 是否清除文件的metadata,1为清除,0为保留。
    /rotate/<Degree> V 指定顺时针旋转的度数,取值可为:90,180,270,auto,默认为不旋转。
    /hlsKey/<HLSKey> A/V AES128加密视频的秘钥,必须是16个字节。
    /hlsKeyType/<HLSKeyType> A/V 密钥传递给我们的方式,0或不填。1.x(1.0, 1.1, ...):见下面详细解释。
    /hlsKeyUrl/<HLSKeyUrl> A/V 密钥的访问url
    /pattern/<Pattern> A/V 为各音视频流ts文件自定义命名。
    因为一整段音视频流音视频切片后会生成一个M3U8播放列表和多个默认命名的音视频流ts文件。示例:avthumb/m3u8/noDomain/1/pattern/eGlhb3hpYW8kKGNvdW50KQ==,其中eGlhb3hpYW8kKGNvdW50KQ==是自定义ts文件名,如:qiniu$(count)的URL安全的Base64编码,其中$(count)是必须存在的六位占位符数字串,qiniu可以自己定义。最后得到类似:qiniu000000,qiniu000001,……,qiniu000006命名的ts文件。

    注意:

    • avthumb 切片的结果会保存在原文件的空间中,包含多个小的 ts 文件和 m3u8 playlist 文件,但是 m3u8 playlist 文件名按照默认规则生成,为了方便获取切片后的 m3u8 资源链接,建议自定义处理结果资源的名称,请参考处理结果另存 (saveas)
    • <VideoCodec><AudioCodec>值同时为copy,即不进行音视频编解码操作时以音视频转封装计费。

    示例

    • 预转持久化形式,将 mp4 视频按 vb/240k 预设规格切片(15秒一片):
    {
            "scope":                "qiniu-ts-demo:sample.mp4",
            "deadline":             1390528576,
            "persistentOps":        "avthumb/m3u8/noDomain/1/segtime/15/vb/240k",
            "persistentNotifyUrl":  "http://fake.com/qiniu/notify"
    }
    
    • 持久化数据处理(即触发持久化)形式,将 mp4 视频切片,静态码率为 320K,帧率为 24fps:
    POST /pfop/ HTTP/1.1
    Host: api.qiniu.com
    Content-Type: application/x-www-form-urlencoded
    Authorization: QBox <AccessToken>
    
    bucket=qiniu-ts-demo
    &key=sample.mp4
    &fops=avthumb%2Fm3u8%2Fab%2F320k%2Fr%2F24
    &notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
    

    注意:要在 Authorization 头部的<AccessToken>前添加 QBox 和半角空格。


    hls加密

    hls加密是利用AES-128位对每个ts文件进行加密,播放器在取得PlayList文件的时候,会根据里面的#EXT-X-KEY标签请求获得解密的URL,再请求解密密钥,之后会用密钥对获取的ts文件解密。用户可以对密钥的URL做cookie验证等方法来对用户做认证。
    例子:PlayList文件 (复制链接,查看文件内容或直接用vlc播放器播放)

    参数解释:

    • hlsKey: base64_urlsafe编码或加密过后的密钥
    • hlsKeyUrl: 指定了密钥放置的url,经过base64_urlsafe编码,这是生成m3u8 PlayList会使用到的
    • hlsKeyType: 指定了传送秘钥的方式
      • 不指定或者指定为0,则仅仅是以base64_urlsafe编码的方式传送。
      • 指定为1.x(1.0, 1.1, ...),以RSA的OAEP加密方式,再以编码传送密钥,x表示密钥的版本
      • 公钥:1.0

    如何加密RSA:

    可以编程的方法,或者使用openssl,下面提供openssl的版本:

    $ echo -n [AES128KEY] | openssl rsautl -encrypt -oaep -inkey [QINIU_PUB_KEY_FILE] -pubin | openssl base64 -A | tr "+/" "-_"
    

    参数解释:

    • AES128Key:HLS_AES128加解密密钥(用户定义的加解密密钥)
    • QINIU_PUB_KEY_FILE:加密上述AES128Key的RSA算法公钥文件(前文七牛提供的公钥1.0)

    示例:

    • 不使用rsa加密:
    avthumb/m3u8/noDomain/1/s/720x480/vb/640k/hlsKey/ZXhhbXBsZWtleTEyMzQ1Ng==/hlsKeyUrl/aHR0cDovL29ndG95d2Q0ZC5ia3QuY2xvdWRkbi5jb20vaGxzMTI4LmtleQ==
    
    • 使用rsa加密:
    avthumb/m3u8/noDomain/1/s/720x480/vb/640k/hlsKey/lsLFcVEISp-1iCoKCMRii6EgqAuUJs-f3FupKlFlbYnAjst5tsZ5U5cttUHp6TKIwW3eNMoBjjTgBnFlBoOku_DR0RMmFDgRxADf7vKRaaISSK0-rm3E4PzMiGybIpf9WIGzmQZLNpCcHOG1ThQU_8j3H4qQAX0nd7HxPcPEaPk=/hlsKeyType/1.0/hlsKeyUrl/aHR0cDovL29ndG95d2Q0ZC5ia3QuY2xvdWRkbi5jb20vaGxzMTI4LmtleQ==
    
    以上内容是否对您有帮助?
  • Close