全部产品
Search
文档中心

视频点播:获取播放地址

更新时间:Jun 11, 2025

视频点播支持通过事件通知和API/SDK两种方式获取播放地址。

通过事件通知提前获取

您可通过接收单个清晰度转码完成全部清晰度转码完成的事件通知获取到播放地址,保存到用户自己的服务端,播放时访问自己的服务端获取到存储的播放地址。

说明

如果您有高并发播放视频的场景,则建议您使用该进行视频播放,通过将获取到的视频URL(播放地址)存储到您自己的业务系统,再下发给播放终端,并提前刷新预热新视频,可满足百万级别的并发播放视频业务需求。更多信息,请参见刷新预热

使用说明

  • 消息回调获取到的播放地址为固定地址,若开启了URL鉴权则需要自己生成带鉴权的播放地址,否则无法播放。

  • 如果您禁用或删除了旧的域名,保存的播放地址取出时请替换成新的域名,否则无法播放。

  • 如果您配置了视频加密,返回的播放地址需要经过播放器解密后才可进行播放。

通过API/SDK实时获取

您需要在上传音视频文件时保存好VideoId,通过SDK调用GetPlayInfo - 获取音视频播放地址接口实时获取播放地址。

使用说明

  • 为了保证每次播放的是最新转码输出的流,播放接口默认每种清晰度和格式只返回一路最新转码完成的流。调用GetPlayInfo - 获取音视频播放地址接口时,可以设置ResultTypeMultiple来获取该音视频下的所有转码完成的流。

  • 如果您选择了阿里云视频加密(私有加密)的方式,只有使用阿里云播放器SDK才可正常播放。为了保障您的视频安全,直接调用获取播放地址接口默认不返回私有加密流,您可以通过设置接口参数ResultType值为Multiple来获取所有转码完成的播放地址。

  • 如果您选择了HLS标准加密的方式,默认会优先返回标准加密的流用于播放。

  • 如果您对音视频进行了分级存储,调用GetPlayInfo - 获取音视频播放地址接口获取音视频的播放地址时:

    • 默认情况下,若存储类型为标准存储,则播放接口会正常返回播放流;若存储类型为媒资范围的非标准存储,则播放接口不返回播放流;若存储类型为源文件范围的非标准存储,则播放接口只返回转码流,不返回原画流。

    • 您可以通过设置接口参数PlayConfigStorageClass来返回指定的非标准存储类型的音视频流。

整体流程

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

image
  1. 客户端向服务端发起请求,获取播放地址。

  2. 服务端可通过服务端SDK调用GetPlayInfo - 获取音视频播放地址,获取播放授权。

  3. 点播服务给服务端返回播放地址。

  4. 服务端向客户端返回播放地址。

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

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

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

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

后续步骤

  • 您可以在客户端集成阿里云播放器通过URL播放视频,参考播放器SDK简介