提交点播转直播任务更新时间：2021-10-22 17:28:41

提交点播转直播任务

基本信息

Path： /api/v2/vod

接口描述：

提交点播转直播播放/停止任务，异步处理转播任务，转播结果需要等待事件回调通知

结果请监听回调事件：点播转直播开始, 点播转直播播放结束, 点播转直播停止

场景描述：

将提前录好的点播课，利用该接口转成直播的方式来播放，可规避一部分直播过程中产生的突发状况，也可提前针对课程做好充分准备。

注： 停止任务方式： 方式1：cmd=stop+必填项； 方式2：cmd=stop+必填项+task_id; 推荐使用方式2下发停止任务，效率更高，更准确；

请求参数

Query

参数名称 类型 是否必须 示例 备注
action string 是 SubmitVODToLive 固定参数，SubmitVODToLive
app_id string 是 f4efa787 app_id
vod_id string 是 4377e1d5 点播ID
cmd string 是 start start 开始转播
stop 停止转播
room_id string 是 lss_1dfe8xxx 直播房间ID
quality string 否 same 指定转播清晰度，取值范围：

360p
480p
720p
1080p
same
默认采用片源最高清晰度
loop int 否 1 转播循环模式

0 循环播放
1 播放一次
默认值1
task_id string 否 4ce3e316-8f0a-4145-8683-e8d62ef380c5 转播任务ID
channel_id string 否 ch_b9dd840e 纯视频直播可以不填，视频+文档直播必填，默认为纯视频直播
options string 否 video,document video(纯视频)，video,document(视频+文档)，默认video

出参

参数 类型 是否必选 含义
task_id string 是 转播任务ID

返回数据

{
  "msg": "task pending",
  "code": 200,
  "request_id": "B36A562C-BBE7-4B16-9F4A-C7A03AC9D6E2",
  "data": {
    "task_id": "22dec813-868c-450c-96d8-48e716cf8c5c"
  }
}