直播转存点播

接口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 转存到录制文件地址(flv地址)(该参数从获取频道录制视频信息接口获取url的值)
sessionId string 直播场次ID,只传此参数时,可将对应场次的直播录制视频转存到点播
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...

设置后台回放开关

接口URL

http://api.polyv.net/live/v2/channelSetting/{userId}/setPlayBackEnabled

接口说明

1、作用:能够控制单个/全部频道的回放开关,开启以及关闭。
2、接口URL中的{userId}为 直播账号ID
3、接口支持https协议

请求方式

POST

请求参数

参数名 必选 类型 说明
appId string 从API设置中获取,在直播系统登记的appid
sign string 签名,32位大写MD5值
timestamp string 当前13位毫秒级时间戳,3分钟内有效
playBackEnabled string 回放开关是开/关的状态,值为Y/N,必填
channelId int 频道ID,非必填,不填添加该用户的所有频道ID的回放开关都设置为开/关

响应成功JSON示例

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

响应异常JSON示例

{
  code: 400,
  status: "error",
  message: "invalid timestamp.",
  data: ""
}

响应参数

参数名 说明
status 响应状态
data 响应结果
code http响应状态码
message 异常错误信息

PHP请求示例

<?php

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

//接口需要的参数(非sign)赋值
$userId = "XXXXXXXX";
$channelId = "127075";//非必填
$playBackEnabled = "N";

if(empty($channelId)){
    $params = array(
        'appId'=>$appId,
        'playBackEnabled'=>$playBackEnabled,
        'timestamp'=>$timestamp
      );
}else {
    $params = array(
        'appId'=>$appId,
        'playBackEnabled'=>$playBackEnabled,
        'channelId'=>$channelId,
        'timestamp'=>$timestamp
      );
}
//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法

if(empty($channelId)){
    $url="http://api.live.polyv.net/v2/channelSetting/{$userId}/setPlayBackEnabled?appId=$appId&playBackEnabled=$playBackEnabled&sign=$sign&timestamp=$timestamp";
}else{
    $url="http://api.live.polyv.net/v2/channelSetting/{$userId}/setPlayBackEnabled?appId=$appId&channelId=$channelId&playBackEnabled=$playBackEnabled&sign=$sign&timestamp=$timestamp";
}

$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;

?>

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

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

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

获取频道录制视频信息

点击这里查看旧版

接口URL

http://api.polyv.net/live/v2/channels/{channelId}/recordFiles

接口说明

1、作用:获取频道录制视频信息
2、接口支持https协议
3、接口URL中的{channelId}为 频道ID

请求方式

GET

请求参数

参数名 必选 类型 说明
appId string 从API设置中获取,在直播系统登记的appId
sign string 签名,32位大写MD5值
timestamp string 当前13位毫秒级时间戳,3分钟内有效
userId string 直播账号ID
startDate string 开始日期,格式为:yyyy-MM-dd
endDate string 结束日期,格式为:yyyy-MM-dd
sessionId string 直播的场次ID

响应参数

参数名 说明
status 响应状态
data 响应结果
code http响应状态码
msg 异常错误信息
channelId 频道号
url 录制文件地址
startTime 开始录制时间
endTime 结束录制时间
fileSize 录制文件大小(单位:字节)
duration 时长(单位:秒)
bitrate 录制文件码率(单位:字节)
resolution 分辨率
channelSessionId 直播的场次ID

响应成功JSON示例

{
  code: 200,
  status: "success",
  message: "",
  data: [
    {
      channelId: 89001,
      url: "http://rflive.videocc.net/i6ro0hxj0020150529112242035/recordf.i6ro0hxj0020150529112242035_20170120184803.flv",
      startTime: "20170120184803",
      endTime: "20170120185435",
      fileSize: 15367077,
      duration: 392,
      bitrate: 313613,
      resolution: "1280x720",
      channelSessionId:"2399kkkjjd"
    },
    {
      channelId: 89001,
      url: "http://rflive.videocc.net/i6ro0hxj0020150529112242035/recordf.i6ro0hxj0020150529112242035_20170120163848.flv",
      startTime: "20170120163848",
      endTime: "20170120164104",
      fileSize: 12267077,
      duration: 136,
      bitrate: 407723,
      resolution: "1280x720",
      channelSessionId:"2ii9kkkjjd"
    }
  ]
}

响应异常JSON示例

{
  code: 400,
  status: "error",
  message: "invalid timestamp.",
  data: ""
}

PHP请求示例

<?php

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

//接口需要的参数(非sign)赋值
$channelId="127075";
$userId="XXXXXXXX";
$startDate="2017-01-20";
$endDate="2017-01-20";
$sessionId="2ii9kkkjjd";

$params = array(
    'appId'=>$appId,
    'userId'=>$userId,
    'startDate'=>$startDate,
    'endDate'=>$endDate,
    'sessionId'=>$sessionId,
    'timestamp'=>$timestamp
  );

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

//接口请求url
$url="http://api.live.polyv.net/v2/channels/$channelId/recordFiles?appId=".$appId."&timestamp=".$timestamp."&userId=".$userId."&sign=".$sign."&endDate=".$endDate."&startDate=".$startDate."&sessionId=".$sessionId;

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

?>

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

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

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