热门活动
全部活动
功能描述
本文将介绍如何为边转边播的播放列表进行签名授权并生成带鉴权信息的播放列表。
授权说明
同时，还需要授予
cam:PassRole 权限用于传递角色，便于数据万象能够通过 CAM 的“角色”进行 COS 的资源读写操作。服务开通
使用该功能需 将存储桶绑定数据万象。
使用限制
使用该接口时，需开启白名单，可 提交工单 联系我们开启。
不支持处理 COS 上的归档存储类型和深度归档存储类型的视频，如果需要处理此类型视频，请先 恢复归档文件。
费用说明
获取播放列表下载权限不会产生实际的转码及费用，只有在进行播放时，才会实时转码并进行计费。边转边播与普通音视频转码的计费方式和价格相同，按实际转码时长进行计费，输出的视频分辨率不同对应的价格也不同，详情请参见 媒体处理费用。
请求
请求示例
GET /<ObjectKey>?ci-process=getplaylist&expires=<expires>&exper=<exper> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>
请求参数
参数名称 | 描述 | 类型 | 是否必选 |
ci-process | 操作类型，固定使用 getplaylist。 | String | 否 |
expires | 私有 ts 资源 url 下载凭证的相对有效期，单位为秒，范围为[3600，43200]。 | Int | 是 |
exper | 指定视频试看时长，单位为秒，数据万象将基于试看时长的值与 ts 分片时长的值综合计算，返回限定 ts 分片个数的 m3u8播放列表。 取值规则：不填或填0表示不试看（返回完整ts列表），当 exper ≥ 视频总时长时，返回完整播放列表；当 exper < 首个 ts 分片时长时，返回错误响应。 计算规则：试看分片个数 = exper / ts 分片时长（向下取整），实际试看时长 = 试看分片个数 × ts分片时长 注意： 请求时，该参数必须加到签名中进行校验。 | Int | 否 |
请求头
请求体
该请求无请求体。
响应
响应头
响应体
该响应体为 m3u8 的内容，其中的 ts 为可下载的链接。
错误码
实际案例
请求
GET /for-test.m3u8?ci-process=getplaylist&expires=3600 HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Fri, 10 Mar 2016 09:45:46 GMTAuthorization: q-sign-algorithm=sha1&q-ak=************************************-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=************************************Content-Length: 0
响应
HTTP/1.1 200 OKContent-Type: application/x-mpegURLContent-Length: 266005Connection: keep-aliveDate: Fri, 10 Mar 2016 09:45:46 GMTServer: tencent-cix-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****#EXTM3U#EXT-X-VERSION:3#EXT-X-TARGETDURATION:5#EXT-X-MEDIA-SEQUENCE:0#EXTINF:5,test-00000.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=0&playlist=#EXTINF:5,test-00001.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=1&playlist=#EXTINF:5,test-00002.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=2&playlist=#EXTINF:5,test-00003.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=3&playlist=#EXTINF:5,test-00004.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=&ci-process=livetranscode&index=4&playlist=#EXT-X-ENDLIST
