创建拉流配置
创建拉流配置
API 地址
api.vhallyun.com/api/v2/room/create-live-pull-stream-config
描述
根据源流(url或vhall房间ID) 、拉流的目标房间(vhall房间ID)、开始时间、结束时间创建直播拉流配置,创建完成后将按照开始/结束时间执行任务。
回调事件类型: 直播拉流事件
入参
关于公共请求参数详细内容,请参考 公共请求参数。
| 参数 | 类型 | 是否必选 | 含义 |
|---|---|---|---|
| room_id | string | 是 | 拉流房间ID |
| source_type | int | 是 | 标识拉流来源类型 0:第三方URL类型 1:vhall直播间类型 |
| source_url | string | 是 | 来源的视频流URL 支持rtmp,http格式 (当source_type为0的类型会校验url正确性,其他类型时字段值可以为空) |
| source_room_id | string | 是 | 来源的vhall直播房间ID (当source_type为1的类型会校验来源房间正确性,其他类型时字段值可以为空) |
| start_time | string | 是 | 拉流开始时间,格式如2019-01-01 12:00:00 |
| end_time | string | 是 | 拉流结束时间,格式如2019-01-02 12:00:00 结束时间和开始时间必须大于当前时间 拉流结束时间和开始时间间隔在 5 天内,且结束时间要大于开始时间 |
出参
| 参数 | 类型 | 是否必选 | 含义 |
|---|---|---|---|
| config_id | string | 是 | 拉流配置ID |
错误码
| 错误码 | 类型 | 含义 |
|---|---|---|
| 10008 | int | 房间ID不能为空 |
| 10082 | int | 拉流来源类型不能为空 |
| 20002 | int | 房间查询为空 |
| 30001 | int | 不是当前房间拥有者 |
| 40004 | int | 时间类型不正确 |
| 40040 | int | 请求参数错误 |
| 40041 | int | 创建拉流配置失败 |
| 40042 | int | 创拉流配置冲突 |
| 40071 | int | 参数类型错误 |
| 40076 | int | 参数可选值错误 |
| 40079 | int | 拉流结束时间必须大于当前时间 |
| 40080 | int | 拉流源站URL地址不合法 |
响应格式
{
"code": 200,
"msg": "",
"data": {
"config_id":"18930"
}
}
