保利威文档中心

幫助中心

取得影片庫列表（回傳包含轉存的mp4）

更新時間：2022-09-02 18:08:07

介面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伺服器取得回應資料【詳見簽名產生規則】

回應成功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

//引用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);

?>
联系客服，在线咨询