所有文档

          音视频点播 VOD

          播放器服务接口

          查询媒资分发信息

          通过媒资的唯一标识 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": "媒资封面图的实际路径"
               }
            ]
          }
          上一篇
          音视频媒资接口
          下一篇
          转码模板组接口