获取播放地址播放,是指您通过视频点播服务直接获取到音视频播放地址,然后通过点播 SDK 或其它任意播放器进行播放的场景。本文为您介绍播放流程、开发对接流程、使用说明、操作说明等内容。
播放流程
主要流程如下所示。
- App/Web Client 携带请求参数向 App/Web Server 获取密钥信息。
- App/Web Server 携带返回参数向 App/Web Client 返回密钥信息。
- App/Web Client 向 VOD Server 获取有密钥的视频信息。
- VOD Server 向 App/Web Client 返回视频信息。
- App/Web Client 向 CDN 获取有播放地址的播放视频信息。
- CDN 向 App/Web Client 返回播放视频信息。
- 您可以根据获取到的视频信息完成播放操作。
开发对接
视频点播支持直接调用 OpenAPI 或通过点播客户端 SDK 等,调用获取播放地址接口,获取播放信息。
OpenAPI
通过调用 获取播放地址接口,实时获取播放地址。
客户端 SDK
通过客户端播放的方式,获取播放地址进行音视频文件播放。
事件通知
通过接收工作流执行完成的事件通知获取到播放地址,保存到您自己的服务端,播放时访问自己的服务端获取到存储的播放地址。
使用说明
- 消息回调获取到的播放地址为固定地址,视频点播的点播加速域名,支持默认开启 URL 鉴权,支持您通过签名工具自动生成带鉴权的播放地址,否则无法播放。
- 如果您禁用或删除了旧的域名,保存的播放地址取出时请替换成新的域名,否则无法播放。
- 如果您配置了视频加密,返回的播放地址需要经过播放器解密后才可进行播放。
操作说明
获取播放地址的方式有 2 种,一种为 Vid 模式;另一种为 DirectUrl 模式。
- VID 模式:调用 GetPlayInfo 接口,传入
Vid
参数,下发播放地址。 - DirectUrl 模式:您可通过拼接方式的规则访问播放地址,具体操作请参见签名计算。
Vid 模式
方式一:通过点播控制台获取地址
- 登录视频点播控制台,进入空间。
- 选择左侧导航栏媒资管理 > 视频管理, 进入视频管理页面,选择 Vid 模式。
- 根据自身业务需求,选择视频文件,单击操作列的详情按钮,进入视频详情页面。
- 切换视频地址页签,同时该文件已发布完成,单击操作列中复制链接按钮,即可获取到播放地址。
方式二:通过点播 API 获取地址
视频满足发布状态后,通过 GetPlayInfo 接口获取到播放地址。
说明
视频点播支持通过控制台,选择进入空间;在系统设置 > 上传存储设置,配置自动设置视频状态为发布。详情请参见自动设置视频状态 这样上传的视频会自动发布,无需您手动发布。
- 通过
Vid
获取播放地址。您可以通过指定封装格式、编码格式、清晰度等参数,获取所需的播放地址。详见接口说明文档:获取播放地址。 - 您可使用点播服务端 SDK 调用 API,视频点播提供了多种语言的服务端 SDK,详情请见官网文档:使用说明。
DirectUrl 模式
无鉴权 CDN
- 登录视频点播控制台,进入空间,在系统设置 > 回调设置,完成回调事件参数配置,具体操作请参见回调设置。
- 获取回调事件返回的
FileName
参数,通过地址拼接的方式获取播放地址,拼接方式如下所示。
- "协议://播放域名/FileName"
- 例如:
- Filename: /abc123456test.mp4
- 最终播放地址:http://play.vod.com/abc123456test.mp4
有鉴权 CDN
- 登录视频点播控制台,进入空间,在系统设置 > 回调设置,完成回调事件参数配置,具体操作请参见回调设置。
- 获取回调事件返回的
FileName
参数。 - 在签名工具中获取签名参数,具体操作请参见签名计算。
- 通过地址拼接的方式获取播放地址,拼接方式如下所示。
- "协议://播放域名/FileName?签名参数"
- 例如:
- FileName: /abc123456test.mp4
- 签名参数:auth_key=1681656307-435245-0-6ec8166**9a75276f8119e8
- 最终播放地址:http://play.vod.com/abc123456test.mp4?auth_key=1681656307-435245-0-6ec8166**9a75276f8119e8