直播转存点播

接口URL

http://api.polyv.net/live/v2/channel/recordFile/{channelId}/convert

接口说明

1、作用:将直播录制文件转存至点播后台中。
2、接口支持https协议
3、接口URL中的{channelId}为 频道ID
4、同一个POLYV账号,调用该接口的间隔至少5分钟

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
appId string 从API设置中获取,在直播系统登记的appId
timestamp string 当前13位毫秒级时间戳,3分钟内有效
userId string 直播账号ID
fileUrl string 转存到录制文件地址(该参数从获取频道录制视频信息接口获取url的值) (可以同时传fileUrl和sessionId,或必传其中一个)
sessionId string 直播场次ID,只传此参数时,可将对应场次的直播录制视频转存到点播(可以同时传fileUrl和sessionId,或必传其中一个)
fileName string 转存后的点播视频名称
cataid string 目录id,不填或者填写错误即为默认分类
cataname string 目录名称,默认值为默认分类,当cataid设置为-1时,会新建一个名称为cataname的目录,并将视频放到该目录下
sign string 签名,32位大写MD5值
toPlayList string ,取值为Y或N 是否存放到回放列表默认为N :不存放 Y:存放到回放列表
setAsDefault string ,取值为Y或N 是否设为默认回放视频,默认值为Y:设置默认回放视频(转存后在回放列表中位于第一个),N:转存后在回放列表位于最后一个。此参数仅在toPlayList=Y 时生效

响应成功JSON示例:

{
  code: 200,
  status: "success",
  message: "",
  data: "e8888b74d1f25cd1dc0849aabc8df9f1_e"
}

字段说明

参数名 说明
status 响应状态
data 响应结果,请求成功时返回转存成功后的点播视频的id(即vid)
code http响应状态码
message 异常错误信息

php请求示例

<?php

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

//接口需要的参数(非sign)赋值
$userId = "XXXXXXXX";
$channelId = "127075";
$fileUrl = "http://rflive.videocc.net/6dd9ef824d20170425162041072/recordf.6dd9ef824d20170425162041072_20170510105906.flv";
$fileName = "转存视频1";
$cataid = "1";
$cataname = "直播回放";
$toPlayList = "Y";

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'fileUrl' => $fileUrl,
  'fileName' => $fileName,
  'cataid' => $cataid,
  'cataname' => $cataname,
  'toPlayList' => $toPlayList,
  'userId' => $userId
);

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

$url = "http://api.live.polyv.net/v2/channel/recordFile/$channelId/convert";
$data = array (
  'appId' => $appId,
  'timestamp' => $timestamp,
  'fileUrl' => $fileUrl,
  'fileName' => $fileName,
  'cataid' => $cataid,
  'cataname' => $cataname,
  'sign' => $sign,
  'toPlayList' => $toPlayList,
  'userId' => $userId
);

$ch = curl_init ();
curl_setopt ( $ch, CURLOPT_URL, $url );
curl_setopt ( $ch, CURLOPT_POST, 1 );
curl_setopt ( $ch, CURLOPT_HEADER, 0 );
curl_setopt ( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt ( $ch, CURLOPT_POSTFIELDS, $data );
$return = curl_exec ( $ch );
curl_close ( $ch );
print_r($return);

?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...