播放器服务接口
更新时间:2022-05-20
查询媒资分发信息
通过媒资的唯一标识 mediaId 查询指定媒资的标题、时长、可播放文件及媒资封面图的实际路径等,用于自定义播放器的开发。
通过多个模版(模板组)转码出来的媒资,使用本接口查询时,只返回转码时使用模板组中的默认模板提供的转码结果。如果需要获取全量转码结果,需要参考“查询指定媒资”接口中响应参数的playableUrlList字段。
请求语法
GET /v{version}/media/{mediaId}/delivery?transcodingPresetName={transcodingPresetName} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}
请求头域
无特殊请求头域。
请求参数
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
mediaId | String | 媒资的唯一标识,开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
transcodingPresetName | String | 转码模版名称 | 否 |
请求示例
GET /v1/media/mda-11111/delivery?transcodingPresetName=presetName111 HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:08:44Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: d97c57d0-ca44-4d1c-bfeb-941a92440968
content-type: application/json
响应头域
无特殊响应头域。
响应参数
参数 | 类型 | 描述 |
---|---|---|
mediaId | String | 媒资的唯一标识,开发者可通过 mediaId 查询指定媒资的详细信息 |
file | String | 可播放文件的实际路径 |
cover | String | 媒资封面图的实际路径。获取到路径后,可通过图片服务(图片样式除外)对媒资封面图进行缩放、裁剪、格式转换、旋转、添加水印等实时处理 |
title | String | 媒体标题 |
duration | Integer | 媒资播放时长,单位:秒 |
响应示例
HTTP/1.1 200 OK
x-bce-request-id: 299b099a-9063-45eb-8d14-15563768926f
cache-control: no-cache
content-type: application/json;charset=UTF-8
transfer-encoding: chunked
date: Thu, 16 Jun 2016 03:45:58 GMT
connection: close
server: BWS
{
"success":true,
"result":
{
"media_id": "mda-gcseezyb93g5hqpp",
"file": "http://gcikixy9wpfkpdx3qbb.exp.bcevod.com/mda-gcseezyb93g5hqpp/mda-gcseezyb93g5hqpp.m3u8",
"cover": "http://gcikixy9wpfkpdx3qbb.exp.bcevod.com/mda-gcseezyb93g5hqpp/mda-gcseezyb93g5hqpp.jpg",
"title":"test title",
"duration":120
}
}
其中,cover
的返回值可使用图片服务对媒资封面图进行缩放、裁剪、格式转换、旋转、添加水印等实时处理,详见使用图片服务处理媒资封面图。
使用图片服务处理媒资封面图
使用图片服务可对媒资封面图进行缩放、裁剪、格式转换、旋转、添加水印等实时处理,URL格式如下所示:
# 例1:将媒资封面图(600×330)缩略成宽度为200,高度按原图比例等比例缩放
http://gcikixy9wpfkpdx3qbb.exp.bcevod.com/mda-gcseezyb93g5hqpp/mda-gcseezyb93g5hqpp.jpg@w_200
# 例2:将媒资封面图(600×330)拉伸到200×150的比例,再等比例缩放至宽200,高150
http://gcikixy9wpfkpdx3qbb.exp.bcevod.com/mda-gcseezyb93g5hqpp/mda-gcseezyb93g5hqpp.jpg@s_1,w_200,h_150
# 例3:将媒资封面图(600×330)等比例缩小330/150倍,再居中裁剪至宽200,高150
http://gcikixy9wpfkpdx3qbb.exp.bcevod.com/mda-gcseezyb93g5hqpp/mda-gcseezyb93g5hqpp.jpg@s_2,w_200,h_150
查询媒资播放代码
通过媒资的唯一标识 mediaId、基本外观数据及AK生成可扩展的播放器代码,便于开发者开发简单的播放器,仅对状态为PUBLISHED
的媒资有效。开发者还可基于获取到的播放器代码继续进行高级定制。
对于多模版(模板组)转码出来的媒资,使用本接口查询时,只返回转码时使用模板组中的默认模板提供的播放代码。 如果需要非默认模板转出的转码结果对应的播放代码,需要参考“查询指定媒资”接口中响应参数的playableUrlList字段。
请求语法
GET /v{version}/media/{mediaId}/code?transcodingPresetName={transcodingPresetName}&width={width}&height={height}&autostart={autostart}&ak={ak} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: {bce-request-id}
content-type: application/json
请求参数
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
mediaId | String | 媒资的唯一标识,开发者可通过 mediaId 查询指定媒资的详细信息 | 是 |
transcodingPresetName | String | 转码模版名 | 否 |
width | Number | 播放器宽度 | 是 |
height | Number | 播放器高度 | 是 |
autostart | Boolean | 是否自动播放,可选值: true, false | 是 |
ak | String | Access Key ID,用于用户鉴权 | 是 |
请求示例
GET /v1/media/mda-11111/code?transcodingPresetName=presetName111&width=640&height=480&autostart=true&ak=11add114dd5485d96da866190beac4 HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-03-24T13:06:02Z
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
content-type: application/json
authorization: bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:06:02Z/1800/host;x-bce-date/02f64774999996903cffa5ae4d6eef436127a96f581a4e8467497e239d824be8
响应头域
无特殊响应头域。
响应参数
无。
响应示例
HTTP/1.1 200 OK
x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
Date: Tue, 24 Mar 2015 13:06:02 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Cache-Control: no-cache
{
"codes":[
{
"codeType":"html",
"sourceCode": "以标准Base64编码的html代码片段,该片段可被直接嵌入到网页中执行"
},
{
"codeType":"file",
"sourceCode": "可播放文件的实际路径"
},
{
"codeType":"cover",
"sourceCode": "媒资封面图的实际路径"
}
]
}