全部产品
Search
文档中心

视频点播:获取播放凭证

更新时间:Jun 16, 2026

播放凭证具有时效性、与视频一一对应、不能混用和重复使用等特点,当凭证过期或凭证错误时都将无法获取到对应的播放地址,满足对音视频播放有更高安全性要求的场景。

使用说明

  • 阿里云播放器支持通过播放凭证方式播放视频,三方播放器不支持该方式。

  • 播放凭证默认时效为100秒(最大为3000秒),只能用于获取指定视频的播放地址,不能混用或重复使用。如果凭证过期则无法获取播放地址,您需要自行处理好播放凭证过期后的刷新问题。

  • 播放凭证的时效并不是播放地址的时效(若开启了URL鉴权),后者可自定义过期时间,且无上限。

  • 如果您选择了阿里云视频加密(私有加密)的方式,只有使用阿里云播放器SDK才可正常播放。

说明

有效期参数区分:使用 GetVideoPlayAuth 获取播放凭证时,有效期由 AuthInfoTimeout 参数控制。使用 GetPlayInfo 获取播放地址时,有效期由 AuthTimeout 参数控制。

整体流程

我们以配置了CDN加速域名为例,讲解获取播放凭证并播放视频的整体流程。

image
  1. 客户端传递VideoId,向服务端发起请求,获取播放凭证。

  2. 服务端可通过服务端SDK调用获取音视频播放凭证,获取播放凭证。

  3. 点播服务给服务端返回播放凭证。

  4. 服务端向客户端返回播放凭证。

  5. 客户端播放器根据返回的播放凭证向点播服务请求播放地址。

  6. 点播服务直接向客户端返回播放地址。

  7. 客户端根据返回的播放地址,请求播放资源。

  8. CDN节点不存在资源或者资源失效时需要回源OSS Bucket。

  9. OSS Bucket 返回资源给CDN节点,CDN节点缓存资源。

  10. CDN节点返回媒体资源。

后续步骤

阿里云播放器提供Web端、Android、iOS、Flutter、Harmony端五种播放器SDK,且均支持使用播放凭证播放的方式,您可根据使用的播放器类型参见以下文档: