最近更新时间:2023.11.03 17:38:11
首次发布时间:2021.03.22 11:43:04
本文主要介绍通过播放临时安全凭证 PlayAuthToken
播放的播放流程、对接流程。
客户端播放是指通过终端(Android、iOS、Web)播放音视频。视频点播提供了播放 SDK,您可以集成视频点播播放器完成视频播放。
PlayAuthToken
用于播放,安全性较高,支持 Android、iOS、Web 三端。已开通 IAM 账号并授权视频点播权限。提前准备账号的 AK/SK,支持主账号、(推荐)子账号。详细操作请参见创建 IAM 子账号并授权。
注意
主账号拥有账号下全部权限,若泄漏可能给您的服务带来很大风险,不推荐直接使用主账号 AK/SK 调用服务。
App/Web Client 播放时,App/Web Client 直接向点播服务请求播放地址,需要和点播服务直接交互,此时点播服务会对客户端的请求进行鉴权。由于长期的 SecretKey 的权限过大,您千万不要将 SecretKey 泄露到客户端,否则将可能造成严重的安全问题。因此,需要您搭建 App/Web Server 授权服务,通过 App/Web Server 和 App 间的信息通道来传递播放临时安全凭证。
说明
App/Web Client 向 App/Web Server 申请播放临时安全凭证时,请务必对用户身份做校验,否则任何人都可以拿到安全凭证获取到播放地址。
播放临时安全凭证 PlayAuthToken
机制的主要特点:
PlayAuthToken
,您可以循环调用生成方法;主要流程如下所示。
PlayAuthToken
;PlayAuthToken
,并返回给 App/Web Client;PlayAuthToken
传递给点播 SDK;PlayAuthToken
向视频点播发起请求,获取播放信息;播放临时安全凭证 PlayAuthToken
是一个播放凭证,不是实际播放地址。点播 SDK 会根据播放凭证自动获取播放地址进行播放。
播放临时安全凭证 PlayAuthToken
中带有 Vid、Format 等音视频信息,只能用于获取指定的音视频的播放地址,不能混用。即不同的 Vid、Format,您需要获取不同的 PlayAuthToken
。
播放临时安全凭证 PlayAuthToken
默认有效时间是 900s,生成时可以指定生效时间。如果凭证过期无法获取到播放地址,需要重新获取播放临时安全凭证。
注意
此有效时间只是凭证生效时间,不代表获取到的播放地址的生效时间。播放地址生效时间仍取决于时间戳防盗链设置的时间。
服务端生成播放临时安全凭证的方法为本地方法,您不需要关心 API 的耗时。
播放前准备工作及播放前提,详情请见:媒资播放概述。
为方便您的使用,我们对播放临时安全凭证 PlayAuthToken
使用进行了封装,提供了多语言的 SDK。建议您使用服务端 SDK 来调用。
我们提供 Android、iOS、Web 的点播 SDK,详情请见点播 SDK 介绍。