全部产品
云市场

获取视频播放地址

描述

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

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:GetPlayInfo
VideoIdString视频ID。
FormatsString视频流格式,多个用逗号分隔。支持格式:默认获取所有格式的流。
AuthTimeoutLong播放地址过期时间,单位:秒。
如果返回的是CDN加速地址:
  • 只有开启了URL鉴权播放地址才会定期失效,否则会永久有效。
  • 最小值:1
  • 最大值:无限制
  • 默认值:未设置时,取值为URL鉴权中设置的默认有效时长
如果返回的是OSS源站地址:
  • 只有存储权限为私有,播放地址才会定期失效,否则会永久有效
  • 最小值:1
  • 最大值:为降低源站安全风险,最大值为2592000(即30天)
  • 默认值:未设置时,取值为3600
StreamTypeString视频流类型,多个用逗号分隔。支持类型:
  • video
  • audio
默认获取所有类型的流。
DefinitionString视频流清晰度,多个用逗号分隔。取值范围:
  • FD(流畅)
  • LD(标清)
  • SD(高清)
  • HD(超清)
  • OD(原画)
  • 2K(2K)
  • 4K(4K)
  • SQ(普通音质)
  • HQ(高音质)
  • AUTO(自适应码率,仅当转码模板中配置了打包时才会有该清晰度输出,详见 转码模板配置-PackageSetting
默认获取所有清晰度的流。
ResultTypeString返回数据类型。取值范围 :
  • Single(每种清晰度和格式只返回一路最新转码完成的流)
  • Multiple(每种清晰度和格式返回所有转码完成的流)
默认为Single类型。
OutputTypeString输出地址类型。取值范围 :
  • oss(回源地址)
  • cdn(加速地址)
默认为cdn类型。注意:仅支持播放格式为mp4的oss地址
PlayConfigPlayConfig播放自定义设置,为JSON字符串,支持指定域名播放设置。
ReAuthInfoReAuthInfoCDN二次鉴权参数,为JSON字符串。当开启了CDN二次鉴权功能时,可通过该参数设置鉴权URL的uid和rand,详见URL鉴权

返回参数

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

API示例

请求示例

  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. "OutputType": "cdn",
  11. "CreationTime": "2017-06-26T05:38:48Z"
  12. },
  13. "PlayInfoList": {
  14. "PlayInfo":[
  15. {
  16. "Bitrate": "925.0",
  17. "Definition": "LD",
  18. "Duration": "15.0",
  19. "Encrypt": 0,
  20. "PlayURL": "http://vod.aliyunsample.com/ABEBDE15CC479FD4D1329/62cb3151eba5289f8e2da3b55bc57c49.mp4?auth_key=122123-323232abbb",
  21. "Format": "mp4",
  22. "StreamType": "video",
  23. "Fps": "30.0",
  24. "Height": 960,
  25. "Size": 1815321,
  26. "Width": 540,
  27. "JobId":"23ef850b4f6f44eab54b6e91d24d8123",
  28. "WatermarkId": "c169d97d995040d6af5b815dfff14e3f",
  29. "Status":"Normal",
  30. "CreationTime":"2018-07-04T06:36:56Z",
  31. "ModificationTime":"2018-07-04T06:37:13Z"
  32. },
  33. {
  34. "Bitrate": "1575.0",
  35. "Definition": "SD",
  36. "Duration": "15.0",
  37. "Encrypt": 0,
  38. "PlayURL": "http://vod.aliyunsample.com/ABEBDE15CC479FD4D1329/52a53151eba5226f8e2da3b55bc57c49.m3u8?auth_key=abdf2123-6783232accc",
  39. "Format": "m3u8",
  40. "StreamType": "video",
  41. "Fps": "30.0",
  42. "Height": 960,
  43. "Size": 3090951,
  44. "Width": 540,
  45. "JobId":"23ef850b4f6f44eab54b6e91d24d8456",
  46. "WatermarkId": "c169d97d995040d6af5b815dfff14e3f",
  47. "Status":"Invisible",
  48. "CreationTime":"2018-07-04T06:36:56Z",
  49. "ModificationTime":"2018-07-04T06:37:13Z"
  50. }
  51. ]
  52. }
  53. }

错误码

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

错误代码错误信息HTTP 状态码说明
Forbidden.IllegalStatusStatus of the video is illegal. Current Status is %s.403视频状态无效,当前状态为 %s。只有 Normal 状态的视频才能播放。
InvalidVideo.NotFoundThe video does not exist.404视频不存在。
InvalidVideo.NoneStreamThe video has no stream to play for the request parameter ‘Formats : mp4, Defintion : LD, StreamType : video’.404根据您的筛选条件找不到可以播放的转码输出流,请检查您的 转码配置 与 筛选条件是否匹配。
Forbidden.AliyunVoDEncryptionCurrently only the AliyunVoDEncryption stream exists, you must use the Aliyun player to play or set the value of ResultType to Multiple.403当前仅存在阿里云视频加密的转码输出流,必须使用阿里云播放器进行播放或者设置请求参数ResultType值为Multiple

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: