GetPlayInfo - 获取音视频播放地址

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

接口说明

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

调试

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

调试

授权信息

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

请求参数

名称类型必填描述示例值
MediaIdstring

媒资ID。

86434e152b7d4f20be480574439fe***

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求ID。

******11-DB8D-4A9A-875B-275798******
MediaBaseobject

媒资信息。

CreationTimestring

创建时间。

2021-09-22T10:07:31+08:00
Statusstring

资源状态。取值范围:

- Init(初始状态:源文件未就绪)

- Preparing(源文件准备中:比如上传中或者剪辑合成中)

- PrepareFail(源文件准备失败:比如获取源文件信息失败)

- Normal(正常:源文件已就绪)

Normal
MediaIdstring

媒资ID。

2eea77a61c7b4ddd95bec34a6f65b***
CoverURLstring

封面URL。

https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg
Titlestring

标题。

testTitle
MediaTypestring

媒体文件类型,取值:

video:视频。 audio:纯音频。

video
PlayInfoListarray

音/视频播放信息(流信息)。

object

音/视频详细信息。

CreationTimestring

创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

2022-05-10T02:28:49Z
Statusstring

媒体流状态,取值:

  • Normal:正常。
  • Invisible:不可见。
Normal
NarrowBandTypestring

窄带高清类型。取值:

  • 0:普通。
  • 1.0:窄带高清1.0。
  • 2.0:窄带高清2.0。

仅当配置了窄带高清1.0内置转码模板的清晰度时才会生效。更多详情,请参见转码模板配置-Definition

0
HeightLong

媒体流高度。单位:px。

1080
Bitratestring

媒体流码率。单位:Kbps。

20
ModificationTimestring

更新时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

2022-05-13T11:39:41.714+08:00
WatermarkIdstring

当前媒体流关联的水印ID。

5bed88672b1e2520ead228935ed51***
EncryptLong

媒体流是否加密流,取值:

  • 0:否。
  • 1:是。
0
Definitionstring

视频流清晰度定义。取值:

  • FD:流畅。
  • LD:标清。
  • SD:高清。
  • HD:超清
  • OD:原画。
  • 2K:2K。
  • 4K:4K。
  • SQ:普通音质。
  • HQ:高音质。
  • AUTO:自适应码率。
HD
EncryptTypestring

媒体流加密类型。取值:

  • AliyunVoDEncryption:阿里云视频加密。
  • HLSEncryption:HLS标准加密。
说明如果加密类型为AliyunVoDEncryption,则只能使用阿里云播放器SDK才能正常播放。
AliyunVoDEncryption
StreamTypestring

媒体流类型。 若媒体流为视频则取值:video,若是纯音频则取值:audio

video
SizeLong

媒体流大小。单位:Byte。

418112
WidthLong

媒体流宽度。单位:px。

1024
Fpsstring

媒体流帧率。单位:帧/每秒。

25
Durationstring

媒体流长度。单位:秒。

9.0464
PlayURLstring

视频流的播放地址。

https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4
Formatstring

媒体流格式。

  • 若媒体文件为视频则取值: mp4m3u8
  • 若是纯音频则取值:mp3
mp4
HDRTypestring

媒体流HDR类型。取值:

  • HDR
  • HDR10
  • HLG
  • DolbyVision
  • HDRVivid
  • SDR+
HDR
BitDepthinteger

颜色位深。

8
FileURLstring

文件OSS地址。

http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg
TransTemplateTypestring

转码模板类型,取值:

  • Normal:普通模板
  • AudioTranscode:音频转码
  • Remux:转封装
  • NarrowBandV1:窄带高清1.0
  • NarrowBandV2:窄带高清2.0
  • UHD:音画增强(超高清)
Normal

示例

正常返回示例

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"
    }
  ]
}

错误码

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

阿里云首页 智能媒体生产 相关技术圈