全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
视频点播

获取视频播放地址

更新时间:2018-06-13 14:00:38

描述

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

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:GetPlayInfo
VideoIdString视频ID。
FormatsString视频流格式。多个用逗号分隔,支持格式:
  • mp4
  • m3u8
  • mp3
默认获取所有格式的流。
AuthTimeoutString播放地址过期时间。
  • 支持设置最小值为3600秒(当指定时间小于3600秒时,设置为默认3600秒)。
  • 只有开启了 URL鉴权 才会生效。
默认值:3600秒
StreamTypeString视频流类型。多个用逗号分隔,支持类型:
  • video
  • audio
默认获取所有类型的流。
DefinitionString视频流清晰度。
多个用逗号分隔,取值范围:
  • FD(流畅)
  • LD(标清)
  • SD(高清)
  • HD(超清)
  • OD(原画)
  • 2K(2K)
  • 4K(4K)
默认获取所有清晰度的流。
ResultTypeString返回数据类型,支持类型:
  • Single(每种清晰度和格式只返回一路最新转码完成的流)
  • Multiple(每种清晰度和格式返回所有转码完成的流)
默认为Single类型。

返回参数

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

错误码

下面的表格只列举了本接口特有的错误码,视频点播通用的错误码信息,参见 错误码列表

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

示例

请求示例

  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. "WatermarkId": "c169d97d995040d6af5b815dfff14e3f"
  28. },
  29. {
  30. "Bitrate": "1575.0",
  31. "Definition": "SD",
  32. "Duration": "15.0",
  33. "Encrypt": 0,
  34. "PlayURL": "http://vod.aliyunsample.com/ABEBDE15CC479FD4D1329/52a53151eba5226f8e2da3b55bc57c49.m3u8?auth_key=abdf2123-6783232accc",
  35. "Format": "m3u8",
  36. "StreamType": "video",
  37. "Fps": "30.0",
  38. "Height": 960,
  39. "Size": 3090951,
  40. "Width": 540,
  41. "JobId":"23ef850b4f6f44eab54b6e91d24d8456",
  42. "WatermarkId": "c169d97d995040d6af5b815dfff14e3f"
  43. }
  44. ]
  45. }
  46. }
本文导读目录