全部产品
视频点播

获取视频播放地址

更新时间:2017-08-17 11:54:20   分享:   

获取视频播放地址

描述

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

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值: GetPlayInfo
VideoId String 视频ID
Formats String 视频流格式,多个用逗号分隔,支持格式mp4,m3u8,默认获取所有格式的流
AuthTimeout String 播放鉴权过期时间,默认为1800秒,支持设置最小值为1800秒

返回参数

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

特殊错误码

错误代码 错误描述 HTTP状态码 语义
InvalidVideo.NotFound The video not exist. 404 视频不存在
InvalidVideoStream.Damaged The video stream has been Damaged. 403 视频流信息已损坏
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. "Fps": "30.0",
  22. "Height": 960,
  23. "Size": 1815321,
  24. "Width": 540
  25. },
  26. {
  27. "Bitrate": "1575.0",
  28. "Definition": "SD",
  29. "Duration": "15.0",
  30. "Encrypt": 0,
  31. "PlayURL": "http://vod.aliyunsample.com/ABEBDE15CC479FD4D1329/52a53151eba5226f8e2da3b55bc57c49.m3u8?auth_key=abdf2123-6783232accc",
  32. "Format": "m3u8",
  33. "Fps": "30.0",
  34. "Height": 960,
  35. "Size": 3090951,
  36. "Width": 540
  37. }
  38. ]
  39. }
  40. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?