调用GetPlayInfo获取音视频播放地址_智能媒体服务-阿里云帮助中心

调用GetPlayInfo通过音视频ID直接获取媒体文件（支持视频和音频）的播放地址。

接口说明

通过音视频ID来获取音视频的播放地址。通过集成阿里云播放器SDK（适用于URL播放方式）或第三方播放器后，可使用获取到的播放地址用于音视频的播放。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
MediaId	string	否	媒资ID。 MediaId 和 InputURL 字段，至少一个不为空。	86434e152b7d4f20be480574439fe***
InputURL	string	否	注册媒资时填写的InputURL，详情见RegisterMediaInfo。 MediaId 和 InputURL 字段，至少一个不为空。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 或 vod://**20b48fb04483915d4f2cd8ac**

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求ID。	****11-DB8D-4A9A-875B-275798****
MediaBase	object	媒资信息。
CreationTime	string	创建时间。	2021-09-22T10:07:31+08:00
Status	string	资源状态。取值范围： - Init（初始状态：源文件未就绪） - Preparing（源文件准备中：比如上传中或者剪辑合成中） - PrepareFail（源文件准备失败：比如获取源文件信息失败） - Normal（正常：源文件已就绪）	Normal
MediaId	string	媒资ID。	2eea77a61c7b4ddd95bec34a6f65b***
CoverURL	string	封面URL。	https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg
Title	string	标题。	testTitle
MediaType	string	媒体文件类型，取值： video：视频。 audio：纯音频。	video
PlayInfoList	array	音/视频播放信息（流信息）。
	object	音/视频详细信息。
CreationTime	string	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2022-05-10T02:28:49Z
Status	string	媒体流状态，取值： Normal：正常。 Invisible：不可见。	Normal
NarrowBandType	string	窄带高清类型。取值： 0：普通。 1.0：窄带高清1.0。 2.0：窄带高清2.0。仅当配置了窄带高清1.0内置转码模板的清晰度时才会生效。更多详情，请参见转码模板配置-Definition。	0
Height	long	媒体流高度。单位：px。	1080
Bitrate	string	媒体流码率。单位：Kbps。	20
ModificationTime	string	更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2022-05-13T11:39:41.714+08:00
WatermarkId	string	当前媒体流关联的水印ID。	5bed88672b1e2520ead228935ed51***
Encrypt	long	媒体流是否加密流，取值： 0：否。 1：是。	0
Definition	string	视频流清晰度定义。取值： FD：流畅。 LD：标清。 SD：高清。 HD：超清 OD：原画。 2K：2K。 4K：4K。 SQ：普通音质。 HQ：高音质。 AUTO：自适应码率。	HD
EncryptType	string	媒体流加密类型。取值： AliyunVoDEncryption：阿里云视频加密。 HLSEncryption：HLS标准加密。说明如果加密类型为AliyunVoDEncryption，则只能使用阿里云播放器SDK才能正常播放。	AliyunVoDEncryption
StreamType	string	媒体流类型。若媒体流为视频则取值：video，若是纯音频则取值：audio。	video
Size	long	媒体流大小。单位：Byte。	418112
Width	long	媒体流宽度。单位：px。	1024
Fps	string	媒体流帧率。单位：帧/每秒。	25
Duration	string	媒体流长度。单位：秒。	9.0464
PlayURL	string	视频流的播放地址。	https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4
Format	string	媒体流格式。若媒体文件为视频则取值： mp4、 m3u8。若是纯音频则取值：mp3。	mp4
HDRType	string	媒体流HDR类型。取值： HDR HDR10 HLG DolbyVision HDRVivid SDR+	HDR
BitDepth	integer	颜色位深。	8
FileURL	string	文件OSS地址。	http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg
TransTemplateType	string	转码模板类型，取值： Normal：普通模板 AudioTranscode：音频转码 Remux：转封装 NarrowBandV1：窄带高清1.0 NarrowBandV2：窄带高清2.0 UHD：音画增强（超高清）	Normal
StreamTags	string	流标签，用于标识转码处理类型。	"{\"ims.audioServiceType\": \"AudioEnhancement\"}"
JobId	string	任务 ID。	36c9d38e70bf43ed9f7f8f48d6356***

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaBase": {
    "CreationTime": "2021-09-22T10:07:31+08:00",
    "Status": "Normal",
    "MediaId": "2eea77a61c7b4ddd95bec34a6f65b***",
    "CoverURL": "https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg",
    "Title": "testTitle",
    "MediaType": "video"
  },
  "PlayInfoList": [
    {
      "CreationTime": "2022-05-10T02:28:49Z",
      "Status": "Normal",
      "NarrowBandType": "0",
      "Height": 1080,
      "Bitrate": "20",
      "ModificationTime": "2022-05-13T11:39:41.714+08:00",
      "WatermarkId": "5bed88672b1e2520ead228935ed51***",
      "Encrypt": 0,
      "Definition": "HD",
      "EncryptType": "AliyunVoDEncryption",
      "StreamType": "video",
      "Size": 418112,
      "Width": 1024,
      "Fps": "25",
      "Duration": "9.0464",
      "PlayURL": "https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4",
      "Format": "mp4",
      "HDRType": "HDR",
      "BitDepth": 8,
      "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg",
      "TransTemplateType": "Normal",
      "StreamTags": "\"{\\\"ims.audioServiceType\\\": \\\"AudioEnhancement\\\"}\"",
      "JobId": "36c9d38e70bf43ed9f7f8f48d6356***"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2022-11-29

OpenAPI 返回结构发生变更

变更项	变更内容
出参	OpenAPI 返回结构发生变更