全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
视频点播

获取视频播放地址

更新时间:2017-11-16 18:21:15

获取视频播放地址

描述

通过视频ID直接获取媒体文件(支持视频和音频)的播放地址。

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值: GetPlayInfo
VideoId String 视频ID
Formats String 视频流格式,多个用逗号分隔,支持格式mp4,m3u8,mp3,默认获取所有格式的流
AuthTimeout String 播放地址过期时间,默认为3600秒,支持设置最小值为3600秒。只有开启了URL鉴权才会生效。
StreamType String 视频流类型,多个用逗号分隔,支持类型video,audio,默认获取所有类型的流

返回参数

名称 类型 描述
RequestId String 请求ID
VideoBase VideoBase 视频基本信息
PlayInfoList PlayInfo[] 视频流信息列表

特殊错误码

错误代码 错误描述 HTTP状态码 语义
InvalidVideo.NotFound The video not exist. 404 视频不存在
InvalidVideo.NoneStream The video has no stream to play. 404 找不到可以播放的媒体流
Forbidden.IllegalStatus Status of the video is illegal. 403 视频状态无效,不能播放。只有Status为Normal的视频才能播放

示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=GetPlayInfo&VideoId=93ab850b4f6f44eab54b6e91d24d81d4&Format=JSON&<公共参数>

注:示例中的“公共参数”需要有效传参,详情请查看 公共参数说明文档

返回示例

Json:

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "VideoBase": {
  4. "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
  5. "Title": "阿里云VOD",
  6. "Duration": "15.0",
  7. "CoverURL": "http://image.example.com/sample.jpg?auth_key=2333232-atbb667",
  8. "Status": "Normal",
  9. "MediaType": "video"
  10. "CreationTime": "2017-06-26T05:38:48Z"
  11. },
  12. "PlayInfoList": {
  13. "PlayInfo":[
  14. {
  15. "Bitrate": "925.0",
  16. "Definition": "LD",
  17. "Duration": "15.0",
  18. "Encrypt": 0,
  19. "PlayURL": "http://vod.aliyunsample.com/ABEBDE15CC479FD4D1329/62cb3151eba5289f8e2da3b55bc57c49.mp4?auth_key=122123-323232abbb",
  20. "Format": "mp4",
  21. "StreamType": "video",
  22. "Fps": "30.0",
  23. "Height": 960,
  24. "Size": 1815321,
  25. "Width": 540,
  26. "JobId":"23ef850b4f6f44eab54b6e91d24d8123"
  27. },
  28. {
  29. "Bitrate": "1575.0",
  30. "Definition": "SD",
  31. "Duration": "15.0",
  32. "Encrypt": 0,
  33. "PlayURL": "http://vod.aliyunsample.com/ABEBDE15CC479FD4D1329/52a53151eba5226f8e2da3b55bc57c49.m3u8?auth_key=abdf2123-6783232accc",
  34. "Format": "m3u8",
  35. "StreamType": "video",
  36. "Fps": "30.0",
  37. "Height": 960,
  38. "Size": 3090951,
  39. "Width": 540,
  40. "JobId":"23ef850b4f6f44eab54b6e91d24d8456"
  41. }
  42. ]
  43. }
  44. }
本文导读目录