简介

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

接口规格

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>
            /hlsIVType/<HLSIVType>
            /hlsIV/<HLSIV>
            /hlsDurationModify/<HLSDurationModify>
            /pattern/<Pattern>
            /multiAudio/<MultiAudio>
            /segmentType/<SegmentType>
            /segmentInit/<SegmentInit>
            /refine/<Refine>
            /gop/<GroupOfPictures>

注意：

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

操作方式

可以通过 持久化处理 的方式来调用：

• 资源上传时自动触发：可以在上传时指定persistentOps参数
• 对已有资源手动手动触发：调用pfop命令

以 Python Sdk 为例，具体可以看下音视频转码的示例。需要在音视频转码的示例的基础修改数据处理命令 fops ，将其修改为：

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

注意：其他语言 Sdk 可在官方 Sdks 下载，可以通过查看 Sdk 使用指南中资源上传时自动触发，对已有资源手动触发使用。

示例

• 以 资源上传时自动触发 形式，将 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加密方式，再以<urlsafe_base64_encode>编码传送密钥，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==
  

  ​