播放器服务接口

查询媒资分发信息

通过媒资的唯一标识 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": "媒资封面图的实际路径"
     }
  ]
}