调用GetVideoPreviewPlayInfo获取视频播放信息_网盘与相册服务(PDS)-阿里云帮助中心

获取视频播放信息。

接口说明

详细请参考最佳实践文档：在线预览视频。

调试

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

调试

授权信息

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

请求语法

POST /v2/file/get_video_preview_play_info HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
share_id	string	否	分享 id。如果通过分享操作文件，请携带`x-share-token` header 鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。 `share_id`和`drive_id`两者必须有一个字段赋值。	7JQX1FswpQ8
drive_id	string	否	空间 id	1
file_id	string	是	文件 id	9520943DC264
category	string	是	所属分类。需要开通对应的转码功能，枚举如下： live_transcoding（live 边转边播） quick_video（quick 边转边播） offline_audio（离线音频转码） offline_video（离线视频转码）枚举值： live_transcoding：在线视频边转边播。	live_transcoding
template_id	string	否	清晰度模板 id。填空表示取所有可用清晰度模板	264_480p
get_without_url	boolean	否	是否不获取播放 url。如果填 true，只会获取转码元信息，并不会触发 ts 转码，返回的信息中没有播放 url。否则会返回播放 url，如果此 template_id 的视频还未转码，后台将触发器转码。转码会产生对应的增值服务费用	true
url_expire_sec	long	否	url 超时时间，单位：秒。默认 15 分钟，最大 4 小时。	3600
get_master_url	boolean	否	是否获取 master m3u8 的 url，仅在 category = quick_video 时有效	false

返回参数

名称	类型	描述	示例值
	object	Schema of Response
domain_id	string	域 id	bj1
share_id	string	分享 id	7JQX1FswpQ8
drive_id	string	空间 id	1
file_id	string	文件 id	fileid1
video_preview_play_info	VideoPreviewPlayInfo	播放信息

示例

正常返回示例

JSON格式

{
  "domain_id": "bj1",
  "share_id": "7JQX1FswpQ8",
  "drive_id": "1",
  "file_id": "fileid1",
  "video_preview_play_info": {
    "category": "live_transcoding",
    "meta": {
      "duration": 4.2898,
      "width": 1920,
      "height": 1040
    },
    "live_transcoding_task_list": [
      {
        "template_id": "264_480p",
        "status": "finished",
        "url": "https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD",
        "keep_original_resolution": true,
        "preview_url": ""
      }
    ],
    "quick_video_list": [
      {
        "template_id": "",
        "status": "",
        "url": "",
        "preview_url": ""
      }
    ],
    "offline_video_transcoding_list": [
      {
        "template_id": "264_1080p",
        "status": "finished",
        "keep_original_resolution": true,
        "url": "https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD\n"
      }
    ],
    "live_transcoding_subtitle_task_list": [
      {
        "language": "",
        "status": "",
        "url": ""
      }
    ],
    "quick_video_subtitle_list": [
      {
        "language": "",
        "status": "",
        "url": ""
      }
    ],
    "offline_video_transcoding_subtitle_list": [
      {
        "language": "",
        "status": "",
        "url": ""
      }
    ],
    "master_url": "https://pds-xxx-valueadd.oss-xxx.aliyuncs.com/qv/xxx/master.m3u8"
  }
}

错误码

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