设置伪直播

接口描述

1、批量添加伪直播的视频，需预先将视频上传至点播系统或者视频来源于直播暂存录制
2、调用接口后，如果当前频道未在直播中，会自动设置直播方式为“伪直播“
3、如果当前使用其他直播推流方式直播中，则需要在直播结束后，调用”修改频道推流方式“接口修改为伪直播，才会在所设置的开始时间进行直播
4、接口支持https协议

接口URL

http://api.polyv.net/live/v3/channel/stream/add-disk-videos

在线API调用

请求方式

POST

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

2、仅支持正常延迟的纯视频频道设置伪直播

3、不允许添加加密视频、不允许添加m3u8格式的视频

请求参数描述

参数名

必选

类型

说明

appId

true

String

timestamp

true

Long

当前13位毫秒级时间戳，3分钟内有效

sign

true

String

channelId

true

String

频道号，仅支持正常延迟的纯视频频道设置伪直播

vids

true

String

要设置伪直播的点播视频ID或者直播暂存文件fileId，多个以英文逗号分割

startTimes

false

String

伪直播开始时间列表，13位毫秒级时间戳，多个以英文逗号分割，需要与vids数量匹配。如果为空，则表示不设置直播时间如果不为空，需大于当前时间，当设置的vid为直播暂存文件的时候该字段不能为空。

origin

false

String

伪直播视频来源，值为空或者是vod是点播视频，值为record时候代表是来自直播暂存文件

示例

http://api.polyv.net/live/v3/channel/stream/add-disk-videos

表单参数：

vids=1b448be32389b93ea8be08bf0d257043_1&appId=frlr1zazn3&sign=2A861BD280299A4D7E6FF556C77C88D2&channelId=2149710&timestamp=1621843071824&startTimes=1616557881536

响应参数描述

参数名

类型

说明

code

Integer

status

String

响应状态文本信息

message

String

响应描述信息，当code为400或者500的时候，辅助描述错误原因

data

String

成功或失败都返回空字符串

Java请求示例

快速接入基础代码请下载相关依赖源码，点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。

强烈建议您使用直播Java SDK完成API的功能对接，直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

private static final Logger log = LoggerFactory.getLogger(ChannelOperateTest.class);
/**
 * 设置伪直播
 * @throws IOException
 * @throws NoSuchAlgorithmException
 */
@Test
public void testAddDiskVideos() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId = super.appId;
    String appSecret = super.appSecret;
    String userId = super.userId;
    String timestamp = String.valueOf(System.currentTimeMillis());
    //业务参数
    String url = "http://api.polyv.net/live/v3/channel/stream/add-disk-videos";
    String channelId = "2149710";
    String vids = "1b448be32389b93ea8be08bf0d257043_1";
    String startTimes = "1615356953000";
    
    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("timestamp", timestamp);
    requestMap.put("vids", vids);
    requestMap.put("startTimes", startTimes);
    requestMap.put("channelId", channelId);
    requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret));
    String response = HttpUtil.postFormBody(url, requestMap);
    log.info("测试设置伪直播，返回值：{}", response);
    //do somethings
    
}

响应示例

系统全局错误说明详见全局错误说明

成功示例

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

异常示例

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

Previous添加频道商品 Next设置伪直播

Last updated 4 months ago

Was this helpful?

1、批量添加伪直播的视频，需预先将视频上传至点播系统或者视频来源于直播暂存录制 2、调用接口后，如果当前频道未在直播中，会自动设置直播方式为“伪直播“ 3、如果当前使用其他直播推流方式直播中，则需要在直播结束后，调用”修改频道推流方式“接口修改为伪直播，才会在所设置的开始时间进行直播 4、接口支持https协议

private static final Logger log = LoggerFactory.getLogger(ChannelOperateTest.class); /** * 设置伪直播 * @throws IOException * @throws NoSuchAlgorithmException */ @Test public void testAddDiskVideos() throws IOException, NoSuchAlgorithmException { //公共参数,填写自己的实际参数 String appId = super.appId; String appSecret = super.appSecret; String userId = super.userId; String timestamp = String.valueOf(System.currentTimeMillis()); //业务参数 String url = "http://api.polyv.net/live/v3/channel/stream/add-disk-videos"; String channelId = "2149710"; String vids = "1b448be32389b93ea8be08bf0d257043_1"; String startTimes = "1615356953000"; Map<String, String> requestMap = new HashMap<>(); requestMap.put("appId", appId); requestMap.put("timestamp", timestamp); requestMap.put("vids", vids); requestMap.put("startTimes", startTimes); requestMap.put("channelId", channelId); requestMap.put("sign", LiveSignUtil.getSign(requestMap, appSecret)); String response = HttpUtil.postFormBody(url, requestMap); log.info("测试设置伪直播，返回值：{}", response); //do somethings }