此接口用于通过 Vid
获取指定音视频资源中的封装格式、编码格式、清晰度等参数,获取所需的播放地址。
前提条件:调用 UpdateMediaPublishStatus 接口,设置 Status
为 Published
时,才可以获取播放地址。
请求频率:单用户请求频率限制为 1000 次/秒。
计费说明:从点播的播放地址直接下载或者播放视频将产生流量费用。
请求地址:https://vod.volcengineapi.com?Action=GetPlayInfo&Version=2020-08-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetPlayInfo | 接口名称。当前 API 的名称为 GetPlayInfo 。 |
Version | String | 是 | 2020-08-01 | 接口版本。当前 API 的版本为 2020-08-01 。 |
Vid | String | 是 | v029c1g10003civ2i5mqib******* | 音视频 ID。音视频上传后,获取
|
Format | String | 否 | mp4 | 封装格式。
|
Codec | String | 否 | H265 | 编码格式。
说明
|
Definition | String | 否 | 1080p | 视频流清晰度。仅当
说明
|
FileType | String | 否 | video | 流文件类型。取值如下:
|
LogoType | String | 否 | aa | 水印贴片标签。您可在点播控制台创建水印贴片模板时设置水印贴片标签,详见水印贴片模板。 |
Ssl | String | 否 | 1 | 是否返回 HTTPS 播放地址。取值如下:
|
NeedThumbs | String | 否 | 0 | 是否返回雪碧图。取值如下:
|
NeedBarrageMask | String | 否 | 0 | 是否需要蒙版弹幕。取值如下:
|
UnionInfo | String | 否 | 87878*** | 加密视频和加密音频时使用,播放端从浏览器或设备中取出能够标识访问或设备唯一性的信息。详情请见私有 DRM 加密。 |
HDRDefinition | String | 否 | 1080p | 查询 HDR 清晰度。默认为不查询 HDR 清晰度。取值如下:
说明
|
PlayScene | String | 否 | preview | 播放场景。指定获取对应场景的音视频流。当前仅支持设为 preview ,表示试看场景,详见点播试看说明。 |
DrmExpireTimestamp | String | 否 | 1695037103 | 加密视频和加密音频时使用,DRM 过期时间戳。Unix 时间戳,单位为秒。 |
Quality | String | 否 | higher | 音频音质参数。仅当
|
PlayConfig | String | 否 | {"PlayDomain":"vod.test_domain"} | 自定义播放配置。为 JSON 字符串,支持指定播放域名。例如: 说明
|
NeedOriginal | String | 否 | 0 | 是否返回原视频信息。取值如下:
|
ForceExpire | String | 否 | 60 | 强行指定本次请求的时间戳防盗链,单位为秒,取值范围为 [60,315360000]。 说明 该 |
GetAll | Boolean | 否 | false | 是否获取全部转码流的播放信息。取值如下:
|
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Vid | String | v029c1g10003civ2i5mqib******* | 视频 ID。 |
Status | Integer | 10 | 视频状态,取值如下:
|
PosterUrl | String | https://img.***.com/1234/8511abe****.jpeg | 封面存储地址。 |
Duration | Float | 0.1 | 播放时长,单位为秒。 |
FileType | String | video | 流文件类型。取值如下:
|
EnableAdaptive | Boolean | false | 是否关键帧对齐。取值如下:
|
TotalCount | Integer | 1 | 播放列表数量。 |
PlayInfoList | Object[] | - | 播放列表。 |
FileId | String | v029c1g10003civ2i5mqib******* | 文件 ID。 |
Md5 | String | 398e352f8342aa29a6feee2a18e***** | 文件哈希值。 |
FileType | String | video | 文件类型,取值如下:
|
Definition | String | 1080p | 视频分辨率。 |
Quality | String | normal | 音频质量,取值如下:
|
Format | String | mp4 | 视频格式。 |
Codec | String | H265 | 编码类型。 |
LogoType | String | default | 水印贴片标签。 |
MainPlayUrl | String | http://video.***.com/oIpB7fCZQ2ttbMe4Iklnvx******** | 主播放地址。 |
BackupPlayUrl | String | http://video.***.com/oIpB7fCZQ2ttbMe4Iklnvx******** | 备用播放地址。 |
Bitrate | Integer | 1381635 | 码率,单位为 bps。 |
Width | Integer | 1920 | 视频宽度,单位为 px。 |
Height | Integer | 1080 | 视频高度,单位为 px。 |
Size | Double | 1653067 | 文件大小,单位为字节。 |
CheckInfo | String | "a:v029c1g10003civ2i5mqib*******|b:0-983-ac368d50ea39b160********|c:0-983-****" | 劫持校验信息。 |
IndexRange | String | 974-1089 | DASH segment_base 分片信息,用以描述 sidx(分段索引)的范围。 |
InitRange | String | 0-973 | DASH segment_base 分片信息,用以描述头信息的范围。 |
PlayAuth | String | **** | 加密密钥。 |
PlayAuthId | String | **** | 密钥 ID。 |
BarrageMaskOffset | String | 100 | 蒙版弹幕偏移量。 |
Volume | Object | - | 音量均衡响度信息。 说明 无对应的请求字段,有数据则下发。 |
Loudness | Double | 0.1 | 音量响度。 |
Peak | Double | 0.1 | 音量峰值。 |
MainUrlExpire | String | 1690534212 | 主播放 URL 过期时间,Unix 时间戳。 |
BackupUrlExpire | String | 1690534212 | 备用播放 URL 过期时间,Unix 时间戳。 |
KeyFrameAlignment | String | 在转对齐,使用的帧对齐转码版本。 | |
ThumbInfoList | Object[] | - | 雪碧图列表。 |
CaptureNum | Integer | 1 | 包含的截图总数。 |
StoreUrls | String[] | [] | 雪碧图 URL 列表。 |
CellWidth | Integer | 1 | 小图宽,单位为 px。 |
CellHeight | Integer | 1 | 小图高,单位为 px。 |
ImgXLen | Integer | 1 | 雪碧图每行包含的小图数量。 |
ImgYLen | Integer | 1 | 雪碧图每列包含的小图数量。 |
Interval | Double | 0.1 | 截图间隔。 |
Format | String | jpg | 图片格式,取值为 jpg 。 |
BarrageMaskUrl | String | http://****.com/460224cfc86a9177b80b************ | 蒙版弹幕 URL。 |
SubtitleInfoList | Object[] | - | 字幕信息列表。 |
Vid | String | v029c1g10003civ2i5mqib******* | 视频 ID。 |
FileId | String | v029c1g10003civ2i5mqib******* | 文件 ID。 |
Language | String | eng-US | 字幕语言。 |
LanguageId | Integer | 1 | 字幕语言 ID。 |
Format | String | webvtt | 字幕格式。 |
SubtitleId | String | 123 | 字幕 ID。 |
Title | String | subtitle.vtt | 字幕标题。 |
Tag | String | subtitle | 字幕标签。 |
Status | String | enable | 字幕状态。 |
Source | String | MU | 字幕来源。 |
StoreUri | String | tos-vod-cn-****/191fe22a1c4a49189a69************ | 字幕存储 URI。 |
SubtitleUrl | String | http://****.com/191fe22a1c4a49189a69************ | 字幕存储 URL。 |
CreateTime | String | 2019-10-12T07:20:50.52Z | 创建时间。 |
Version | String | 1 | 字幕版本。 |
BarrageMaskInfo | Object | - | 蒙版弹幕信息。 |
Version | String | v1 | 蒙版弹幕版本,取值如下:
|
BarrageMaskUrl | String | http://****.com/460224cfc86a9177b80b************ | 蒙版弹幕 URL。 |
FileId | String | v029c1g10003civ2i5mqib******* | 蒙版弹幕文件 ID。 |
FileSize | Double | 1 | 蒙版弹幕文件大小,单位为字节。 |
FileHash | String | c2e595ab2db511daf6fc************ | 蒙版弹幕文件哈希值。 |
UpdatedAt | String | 1676017784 | 蒙版弹幕文件更新日期。 |
Bitrate | Integer | 1 | 蒙版弹幕文件码率,单位为 bps。 |
HeadLen | Double | 1 | 蒙版弹幕文件头部大小。 |
https://vod.volcengineapi.com?Action=GetPlayInfo&Version=2020-08-01&Vid=v029c1g10003civ2i5mqib*******&Format=mp4&Codec=H265&Definition=1080p&FileType=video&LogoType=&Base64=&Ssl=1&NeedThumbs=0&NeedBarrageMask=0&CdnType=&UnionInfo=&HDRDefinition=1080p&PlayScene=preview&DrmExpireTimestamp=1695037103&Quality=higher&PlayConfig={"PlayDomain":"vod.test_domain"}&NeedOriginal=0 g
{ "ResponseMetadata": { "RequestId": "202306041104200100100232280022D31", "Action": "GetPlayInfo", "Version": "2020-08-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "Vid": "v029c1g10003civ2i5mqib*******", "Status": 1, "PosterUrl": "https://img.***.com/1234/8511abe****.jpeg", "Duration": 0.1, "FileType": "video", "EnableAdaptive": true, "TotalCount": 1, "PlayInfoList": [ { "FileId": "v029c1g10003civ2i5mqib*******", "Md5": "398e352f8342aa29a6feee2a18e*****", "FileType": "video", "Definition": "1080p", "Quality": "normal", "Format": "mp4", "Codec": "H265", "LogoType": "default", "MainPlayUrl": "http://video.***.com/oIpB7fCZQ2ttbMe4Iklnvx********", "BackupPlayUrl": "http://video.***.com/oIpB7fCZQ2ttbMe4Iklnvx********", "Bitrate": 1381635, "Width": 1920, "Height": 1080, "Size": 1653067, "CheckInfo": "\"a:v029c1g10003civ2i5mqib*******|b:0-983-ac368d50ea39b160********|c:0-983-****\"", "IndexRange": "974-1089", "InitRange": "0-973", "PlayAuth": "****", "PlayAuthId": "****", "BarrageMaskOffset": "100", "Volume": { "Loudness": 0.1, "Peak": 0.1 }, "MainUrlExpire": "1690534212", "BackupUrlExpire": "1690534212" } ], "ThumbInfoList": [ { "CaptureNum": 1, "StoreUrls": [ "http://****.com/611d9a3c188150d69435************" ], "CellWidth": 1, "CellHeight": 1, "ImgXLen": 1, "ImgYLen": 1, "Interval": 0.1, "Format": "jpg" } ], "BarrageMaskUrl": "http://****.com/460224cfc86a9177b80b************", "SubtitleInfoList": [ { "Vid": "v029c1g10003civ2i5mqib*******", "FileId": "v029c1g10003civ2i5mqib*******", "Language": "eng-US", "LanguageId": 1, "Format": "webvtt", "SubtitleId": "123", "Title": "subtitle.vtt", "Tag": "subtitle", "Status": "enable", "Source": "MU", "StoreUri": "tos-vod-cn-****/191fe22a1c4a49189a69************", "SubtitleUrl": "http://****.com/191fe22a1c4a49189a69************", "CreateTime": "2019-10-12T07:20:50.52Z", "Version": "1" } ], "BarrageMaskInfo": { "Version": "v1", "BarrageMaskUrl": "http://****.com/460224cfc86a9177b80b************", "FileId": "v029c1g10003civ2i5mqib*******", "FileSize": 1, "FileHash": "c2e595ab2db511daf6fc************", "UpdatedAt": "1676017784", "Bitrate": 1, "HeadLen": 1 } } }
下表列举了本接口特有的错误码。如需了解更多错误码,详见视频点播公共错误码。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | InvalidParameter.InvalidVid | - | 非法的 Vid。可能是因为请求参数内 Vid 为空或长度异常。 |
400 | InvalidParameter.VidNotExist | - | Vid 不存在。 |
404 | ResourceNotFound.NoAvailableDomain | - | 未配置 CDN 域名。 |
点播 OpenAPI 提供了配套的服务端 SDK,支持多种编程语言,帮助您实现快速开发。建议使用服务端 SDK 来调用 API。此 API 各语言调用的示例代码,请参考如下: