导出合并的录制文件并回调mp4下载地址

接口URL

http://api.polyv.net/live/v3/channel/record/merge-mp4

接口说明

(接口调用有频率限制,详细请查看)

1、接口用于合并直播录制mp4文件
2、该接口为文件合并过程为异步处理过程
3、该接口合并的录制文件必须在8小时内
4、接口支持https
5、三分屏的录制将自动经过重制课件后再合并mp4
6、mp4下载地址30天内有效,超出后需要重新导出

请求方式

POST

请求参数

参数名 必选 类型 说明
appId string 管理员的appId
timestamp long 13位当前时间戳
sign string 签名值
channelId string 频道ID
startTime long 录制文件开始时间(13位时间戳),与endtime最大不能超过8小时
endTime long 录制文件结束时间(13位时间戳),与startTime最大不能超过8小时
callbackUrl string 合并成功或失败回调的url
fileName string 合并后文件名

响应成功JSON示例:

//提交的视频正在合并处理中
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "fileId": "xxxxxxx",
        "fileUrl": ""
    }
}
//合并文件已存在
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "fileId": "xxxxxxx",
        "fileUrl": "http://www.polyv.net/1.mp4"
    }
}

响应失败JSON示例:

// 未输入appId
{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}
// appId不正确
{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}
// 时间戳错误
{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}
// 签名错误
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

字段说明

参数名 说明
code 响应代码,成功为200,失败为400,签名错误为403,异常错误500
status 成功为success,失败为error
message 错误时为错误提示消息
data 成功响应时为相关的信息
data.fileId 文件ID
data.fileUrl 已合并返回文件地址,合并中返回空字符串

php请求示例

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

$params = array(
  'appId' => "填写获取到的appId",
  'timestamp' => "填写13位时间戳",
  'channelId' => "填写频道号",
  'startTime' => "开始时间",
  'endTime' => '结束时间',
  'fileName' => "合并测试",
  'callbackUrl'=> "http://demo.polyv.net/wfy/test.php"
);

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


$url="http://api.polyv.net/live/v3/channel/record/merge-mp4";

function post($url, $post_data = '', $timeout = 5){
   $ch = curl_init();
   curl_setopt ($ch, CURLOPT_URL, $url);
   curl_setopt ($ch, CURLOPT_POST, 1);
   if($post_data != ''){
      curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
   }

   curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
   curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
   curl_setopt($ch, CURLOPT_HEADER, false);
   $file_contents = curl_exec($ch);
   curl_close($ch);
   return $file_contents;
}

$params["sign"] = $sign;
echo post($url, $params);
?>

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

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

回调说明

该接口为异步处理,如果需要获取合并的结果,可以在请求接口时提交callbackUrl 参数,在程序合并成功后,会对callbackUrl 进行回调通知

回调参数

参数 说明
status 接口处理结果,取值:success(成功),error(出错)
channelId 频道号,成功时返回
fileId 合并后的文件ID,成功时返回
fileIds 合并前的所有文件ID,成功时返回
fileUrl 合并后的MP4的地址,成功时返回
fileName 合并后的文件名称,成功时返回
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...