智能多媒体服务

    • 智能多媒体 > API 文档 > 音视频处理 >私有M3U8（pm3u8）

    私有M3U8（pm3u8）

    最近更新时间：2019-08-26 18:48:34

    pm3u8 接口只能用于私有空间中的 m3u8 文件，作用是对 m3u8文件中的 ts 资源进行批量下载授权。通过将 ts 资源的 url 改写成私有 url，以临时获取访问权限。 

    [GET]pm3u8/<Mode>
         /expires/<Expires>
        /deadline/<Deadline>
    参数名称 必填 说明
    /<Mode> 是 处理模式，只有一个值0。
    0表示对所有ts资源的url进行下载授权。
    /expires/<Expires> 私有ts资源url下载凭证的相对有效期，单位秒。
    推荐43200秒（12小时）。
    /deadline/<Deadline> 私有ts资源url下载凭证的绝对有效期(Unix Time)，单位秒。
    此参数填写后，expires失效。

    请求语法

    GET <M3U8DownloadURI>?<接口规格> HTTP/1.1
Host: <M3U8DownloadHost>

    响应语法

    HTTP/1.1 200 OK
Content-Type: application/x-mpegURL

<M3U8TextData>

    响应状态码

    HTTP状态码 含义
    200 授权成功
    400 请求报文格式错误
    404 资源不存在
    599 服务端操作失败。

    如遇此错误，请将完整错误信息（包括所有HTTP响应头部）提交工单 给我们。

    响应内容

    • 如果请求成功，返回新的、包含已颁发下载授权凭证的各个ts资源访问URL的m3u8文件：
    ...过多内容已省略...
#EXTINF:61.120000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000000.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:ejpJ9vAKYYK1ZSpW6z3uS2pGBlo
#EXTINF:59.360000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000001.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:Ufr6wcVrUmY7jr8IpRH2fkCo2G0
...过多内容已省略...
    • 如果请求失败，返回包含如下内容的JSON字符串（已格式化，便于阅读）： 
    {
    "code":     <HttpCode  int>, 
    "error":   "<ErrMsg    string>",
}
    字段名称 必填 说明
    code 是 HTTP状态码，请参考响应状态。
    error 是 与HTTP状态码对应的消息文本

    示例

    原始m3u8链接与内容如下所示： 

    http://7xoucz.com1.z0.glb.clouddn.com/qiniutest.m3u8?e=1449116672&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:JCrhZN1XbkSeNBucKRzmx3R-kzY=

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:62
#EXTINF:61.120000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000000.ts
#EXTINF:59.360000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000001.ts
#EXTINF:59.640000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000002.ts
#EXTINF:2.480000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000003.ts
#EXT-X-ENDLIST

    对m3u8资源进行私有资源下载授权时指定pm3u8接口，可以获取到相应的批量授权下载URL： 

    http://7xoucz.com1.z0.glb.clouddn.com/qiniutest.m3u8?pm3u8/0&e=1449126571&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:SGhJE2aC685_YmHMOtJEngduFes=

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:62
#EXTINF:61.120000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000000.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:ejpJ9vAKYYK1ZSpW6z3uS2pGBlo
#EXTINF:59.360000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000001.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:Ufr6wcVrUmY7jr8IpRH2fkCo2G0
#EXTINF:59.640000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000002.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:SfGPTw3-5MGJQk1xN6dECELKjwQ
#EXTINF:2.480000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000003.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:vriMgesiM95izCCRUrfAMT3bdVs
#EXT-X-ENDLIST

    注意：ts资源的原始下载URL必须以http://打头。

    以上内容是否对您有帮助？
    • Qvm free helper
    Close