Commit aacd32684edce3c8b1e67557234d0400a1c2a402

Authored by 刘炯
1 parent 9ba8ffc9

2

01.点播云/1.1 获取点播信息接口.md renamed to 01.点播云/1.0 获取点播信息接口Server.md
01.点播云/1.1 获取点播信息接口App.md 0 → 100644
  1 +/*
  2 +Title: 1.1 获取点播信息接口
  3 +*/
  4 +
  5 +### 接口描述 ###
  6 +
  7 +
  8 +### 接口地址 ###
  9 +http://api.cnlive.com/open/api2/vod_epg/getVodInfo
  10 +
  11 +### 接口协议 ###
  12 +HTTP GET
  13 +
  14 +### 接口请求参数 ###
  15 +|参数名| 参数类型 | 必选 | 参数说明 |
  16 +|:----- | :------: | :------: | :------: |
  17 +|appId| string | true | 应用ID |
  18 +|vId| string | true | 点播节目标识 |
  19 +|timestamp| int | true | 精确到秒,当前Unix时间戳,请保证请求服务器时间正确 |
  20 +|sign| String | true | 签名规则见 [签名详情] (http://help.open.cnlive.com/common.html) |
  21 +
  22 +### 返回值 ###
  23 +
  24 +| 参数名 | 参数类型 | 必选 | 参数说明 |
  25 +| :-----------| :------: | :------: | :------: |
  26 +| errorCode| int | true | 错误类型号 |
  27 +| errorMessage| string | true | 错误类型 |
  28 +| title| string | true | 节目标题 |
  29 +| subTitle| string | false | 节目副标题 |
  30 +| description| string | false | 节目描述 |
  31 +| createTime| string | true | 创建时间,格式:yyyyMMddHHmmss |
  32 +| publishTime| string | true | 发布时间,格式:yyyyMMddHHmmss |
  33 +| status| string | true | 节目状态,0:待发布,1:已发布,2:下线 |
  34 +| vId| string | true | 节目的唯一标识 |
  35 +| packagePomID| string | false | 节目的产品包ID |
  36 +| onePomID| string | false | 节目的产品ID |
  37 +| freePlayLength| string | false | 免费播放时长,单位 s,默认 60 |
  38 +| mp4_url_rate1 | string | false |流畅版的mp4播放地址 |
  39 +| mp4_url_rate2 | string | true | 标清版的mp4播放地址,必须有|
  40 +| mp4_url_rate3 | string | false | 高清版的mp4播放地址 |
  41 +| mp4_url_rate4 | string | false | 超清版的mp4播放地址 |
  42 +| hls_url_rate1 | string | false |流畅版的m3u8播放地址 |
  43 +| hls_url_rate2 | string | true | 标清版的m3u8播放地址,必须有|
  44 +| hls_url_rate3 | string | false | 高清版的m3u8播放地址 |
  45 +| hls_url_rate4 | string | false | 超清版的m3u8播放地址 |
  46 +
  47 +返回JSON格式的节目元数据信息,json示例如下:
  48 +
  49 +``` json
  50 +{
  51 + "errorMessage":"请求成功",
  52 + "data":{
  53 + "createTime":"20160808125905",
  54 + "publishTime":"20160808131657",
  55 + "status":"1",
  56 + "vId":"174e6c5f3d9e4ddeb739feed1906fa11",
  57 + "hls_url_rate1":"",
  58 + "hls_url_rate3":"",
  59 + "hls_url_rate2":"",
  60 + "vipFlag":"0",
  61 + "packagePomID":"3_ent/xingwenrebao/yuleqianxian/",
  62 + "hls_url_rate4":"",
  63 + "subTitle":"BTOB对粉丝甜喊:我想你们了",
  64 + "mp4_url_rate1":"",
  65 + "title":"BTOB甜喊:我想你们了",
  66 + "mp4_url_rate3":"",
  67 + "mp4_url_rate2":"",
  68 + "description":"@TV娱乐前线:韩国男团BTOB近日在台北国际会议中心举行演唱会。",
  69 + "freePlayLength":"60",
  70 + "mp4_url_rate4":"",
  71 + "onePomID":"3_174e6c5f3d9e4ddeb739feed1906fa11"
  72 + },
  73 + "errorCode":"0"
  74 +}
  75 +```
  76 +#### java 示例
  77 +
  78 +```java
  79 +public Object getVodUrl() {
  80 + String result = "";
  81 + Map params = new HashMap<>();
  82 + params.put("appId", "iqj730vn11");
  83 + params.put("vId", "174e6c5f3d9e4ddeb739feed1906fa11");
  84 + params.put("timestamp", System.currentTimeMillis()/1000+"");
  85 + String url = OpenUtil.buildURL("http://api.cnlive.com/open/api/dianbo/getVodInfo", params, "appId对应key值");
  86 + HttpURLConnection connection;
  87 + try {
  88 + URL requestUrl = new URL(url);
  89 + connection = (HttpURLConnection)requestUrl.openConnection();
  90 + connection.setRequestMethod("GET");
  91 + connection.setDoInput(true);
  92 + connection.setDoOutput(true);
  93 + connection.connect();//连接
  94 +
  95 + //获得返回值
  96 + if(connection.getResponseCode() == HttpURLConnection.HTTP_OK){
  97 + InputStream in = connection.getInputStream();
  98 + String currentLine = "";
  99 + if(in != null){
  100 + BufferedReader br = new BufferedReader(new InputStreamReader(in,"utf-8"));
  101 + while((currentLine = br.readLine()) != null){
  102 + result += currentLine;
  103 + }
  104 + br.close();
  105 + }
  106 + }
  107 + }catch (Exception e) {
  108 + e.printStackTrace();
  109 + }
  110 +
  111 + if(BaseUtil.notBlank(result)) {
  112 + JSONObject resultJson = JSONObject.parseObject(result);
  113 + return resultJson
  114 + }
  115 +
  116 + return "";
  117 + }
  118 +```
0 \ No newline at end of file 119 \ No newline at end of file