# 获取视频库列表（返回包含转存的mp4）

### 接口URL

```
http://api.polyv.net/live/v3/channel/playback/special-list
```

### 接口说明

```
1、作用：获取回放视频的视频列表信息，返回内容包括经过处理的mp4地址(如果回放视频是合并或者剪辑后再转存的，则返回mp4为null),
2、接口支持https协议。
```

### 支持格式

```
JSON
```

### 请求方式

```
GET
```

### 请求参数

| 参数名       | 必选 | 类型     | 说明                                                                                                                                                                                                        |
| --------- | -- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| appId     | 是  | string | 从API设置中获取，在直播系统登记的appId                                                                                                                                                                                   |
| timestamp | 是  | string | 当前13位毫秒级时间戳，3分钟内有效                                                                                                                                                                                        |
| page      | 是  | string | 页数，默认每页显示12条数据                                                                                                                                                                                            |
| pageSize  | 否  | string | 每页显示的数据条数                                                                                                                                                                                                 |
| channelId | 是  | int    | 查询的频道号                                                                                                                                                                                                    |
| listType  | 否  | string | playback-回放列表，vod-点播列表; 默认普通直播场景为vod，三分屏为playback                                                                                                                                                         |
| sign      | 是  | String | 签名，为32位大写的MD5值,`生成签名的appSecret密钥作为通信数据安全的关键信息，严禁保存在客户端直接使用，所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据`【详见[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/buildSign/README.md)】 |

### 响应成功JSON示例：

```json
{
  "code": 200,
  "status": "success",
  "message": "",
  "data": {
    "pageNumber": 1,
    "totalItems": 3,
    "contents": [
      {
        "videoId": "6ce905500b",
        "videoPoolId": "54df86edc42918572a835cb32295895b_5",
        "userId": "54df86edc4",
        "channelId": 100000,
        "title": "保利威视",
        "firstImage": "http://img.videocc.net//uimage/5/54df86edc4/b/54df86edc42918572a835cb32295895b_0.jpg",
        "duration": "00:27:10",
        "myBr": "1",
        "qid": null,
        "seed": 0,
        "ordertime": 0,
        "createdTime": 1526018843000,
        "lastModified": 1526018940000,
        "rank": 9,
        "asDefault": "N",
        "url": "http://mpv.videocc.net/54df86edc4/b/54df86edc42918572a835cb32295895b_1.m3u8",
        "channelSessionId": null,
        "mergeInfo": "[\"20180509192019,956,f0v8mk8lfx\",\"20180510092124,673,f0v8mk8lfx\"]",
        "status": "Y",
        "fileUrl": "http://videolib.videocc.net/ec7paqepj320161102141026068/recordmerge.ec7paqepj320161102141026068_20180511140712.m3u8",
        "fileId": "dc673c60ffa36bf04743a255a2eabe61",
        "startTime": "20180509192019",
        "liveType": "alone",
		"mp4":null
      },
      {
        "videoId": "752d0bd60f",
        "videoPoolId": "54df86edc489fb78f3fab89eb77094c4_5",
        "userId": "54df86edc4",
        "channelId": 100000,
        "title": "保利威视",
        "firstImage": "http://img.videocc.net//uimage/5/54df86edc4/4/54df86edc489fb78f3fab89eb77094c4_0.jpg",
        "duration": "00:00:37",
        "myBr": "1",
        "qid": null,
        "seed": 0,
        "ordertime": 0,
        "createdTime": 1525879207000,
        "lastModified": 1525879207000,
        "rank": 6,
        "asDefault": "N",
        "url": "http://mpv.videocc.net/54df86edc4/4/54df86edc489fb78f3fab89eb77094c4_1.m3u8",
        "channelSessionId": "f0t3g29fwb",
        "mergeInfo": null,
        "status": "Y",
        "fileUrl": "http://videolib.videocc.net/ec7paqepj320161102141026068/recordf.ec7paqepj320161102141026068_20180507155013.m3u8",
        "fileId": "c21fd49fae4f42a7b1c637be6ab749f1",
        "startTime": "20180507155013",
        "liveType": "ppt",
		  "mp4":"http://videolib.videocc.net/ec7paqepj320161102141026068/recordf.ec7paqepj320161102141026068_20180507155013.mp4"
      },
      {
        "videoId": "4d8a9ec87f",
        "videoPoolId": "54df86edc45346b768f5437cb91844e8_5",
        "userId": "54df86edc4",
        "channelId": 100000,
        "title": "保利威视",
        "firstImage": "http://img.videocc.net//uimage/5/54df86edc4/8/54df86edc45346b768f5437cb91844e8_0.jpg",
        "duration": "00:00:42",
        "myBr": "1",
        "qid": null,
        "seed": 0,
        "ordertime": 0,
        "createdTime": 1525879189000,
        "lastModified": 1525879201000,
        "rank": 4,
        "asDefault": "N",
        "url": "http://mpv.videocc.net/54df86edc4/8/54df86edc45346b768f5437cb91844e8_1.m3u8",
        "channelSessionId": "f0gp7zunbp",
        "mergeInfo": null,
        "status": "Y",
        "fileUrl": "http://videolib.videocc.net/ec7paqepj320161102141026068/recordf.ec7paqepj320161102141026068_20180426140123.m3u8",
        "fileId": "424ecdd5d0689408f7531878b49a2c7d",
        "startTime": "20180426140123",
        "liveType": "alone"
		 "mp4":"http://videolib.videocc.net/ec7paqepj320161102141026068/recordf.ec7paqepj320161102141026068_20180426140123.mp4"
      }
    ],
    "endRow": 3,
    "startRow": 1,
    "firstPage": true,
    "prePageNumber": 1,
    "totalPages": 1,
    "nextPageNumber": 1,
    "lastPage": true,
    "limit": 3,
    "offset": 0
  }
}
```

### 字段说明

| 参数名              | 说明                                 |
| ---------------- | ---------------------------------- |
| status           | 响应状态                               |
| data             | 响应结果                               |
| message          | 异常错误信息                             |
| pageNumber       | 视频列表页数（默认以12条数据为1页）                |
| totalItems       | 回放视频总个数                            |
| videoId          | 直播系统生成的id                          |
| videoPoolId      | 点播视频vid                            |
| userId           | 点播后台用户id                           |
| channelId        | 回放视频对应的直播频道id                      |
| title            | 视频标题                               |
| firstImage       | 视频首图                               |
| duration         | 视频长度                               |
| myBr             | 默认视频的播放清晰度，1为流畅，2为高清，3为超清          |
| qid              | 访客信息收集id                           |
| seed             | 视频加密状态，1表示为加密状态，0为非加密              |
| createdTime      | 添加为回放视频的日期                         |
| lastModified     | 视频最后修改日期                           |
| asDefault        | 是否为默认播放视频，值为Y/N                    |
| url              | 视频播放地址，注：如果视频为加密视频，则此地址无法访问        |
| channelSessionId | 用于PPT请求数据，与PPT直播的回放相关，普通直播回放值为null |
| mergeInfo        | 视频合并信息，后续补充                        |
| startTime        | 直播开始时间                             |
| mp4              | 转存后的回放视频对应的mp4                     |
| **lang**         | 视频语言类型 EN英文、zh\_CN中文               |
| firstPage        | 是否为第一页，值为：true/false               |
| lastPage         | 是否为最后一页，值为：true/false              |
| nextPageNumber   | 下一页编号                              |
| prePageNumber    | 上一页编号                              |
| totalPages       | 总页数                                |
| startRow         | 当前页第一个视频在回放视频中的位置                  |
| endRow           | 当前页最后一个视频在回放视频中的位置                 |
| limit            | 当前页视频个数                            |

### php请求示例

```php
<?php

//引用config.php
include 'config.php';

//接口需要的参数（非sign）赋值
$channelId = "127075";
$page = "1"; //页数
$pageSize="10";//每页显示的数据

$params = array(
    'appId'=>$appId,
	'channelId'=>$channelId,
	'page'=>$page,
	'pageSize'=>$pageSize,
    'timestamp'=>$timestamp
  );

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法

//接口请求url
$url = "http://api.polyv.net/live/v3/channel/playback/special-list?appId=$appId"."&page=$page"."&pageSize=$pageSize"."&timestamp=$timestamp"."&sign=$sign"."&channelId=".$channelId;

//输出接口请求结果
echo file_get_contents($url);

?>
```