文档反馈
文档反馈

更新推流任务

连麦者上线时、修改推流任务的画面布局时需要调用此接口更新推流任务。

限制说明

URL

URL 中参数说明:

参数名称 类型 是否必选 示例 描述
cid int64 6207760637435905 房间 ID。该 ID 为创建房间接口调用成功后返回的房间 ID。

请求参数

参数名称 类型 是否必选 示例 描述
taskId String 必选 stream_1 自定义的推流任务ID。请保证此ID唯一。
streamUrl String 必选 rtmp://test.url 推流地址,例如rtmp://test.url。
此处的推流地址可设置为网易云信直播产品中服务端API创建频道的返回参数pushUrl。
layout Json 必选 - 互动直播中的布局相关参数。
详细参数说明请参考layout。布局参数的配置方式及典型配置示例请参考旁路推流画面布局
record Boolean 必选 true 旁路推流是否需要进行音视频录制。

返回参数

参数名称 类型 示例 描述
code int 200 状态码。
errmsg String invalid params 错误详情。仅在状态码为 200 以外的其他状态中返回。errmsg 仅供参考,请勿基于 errmsg 实现业务逻辑。

示例

请求示例

{
    "taskId" : "stream_1",  
    "streamUrl": "rtmp://test.url",  
    "layout":{
        "canvas": {
             "width": 720,
             "height": 640,
             "color": 16777215
                },
        "users": [{
            "uid": 66601,
            "x": 0,
            "y": 0,
            "width": 360,
            "height": 640,
            "adaption": 1,
            "pushAudio": true,
            "pushVideo": true
        },
         {
            "uid": 66602,
            "x": 360,
            "y": 0,
            "width": 360,
            "height": 640,
            "adaption": 1,
            "pushAudio": true,
            "pushVideo": true
        }
    ],
         "images": [{
            "url": "www.163.com/test.jpg",
            "x": 360,
            "y": 0,
            "width": 360,
            "height": 640,
            "adaption": 1
        }]
},                  
    "record":true                  
}

正常返回示例

{   
    "code" : 400,                         
    "errmsg" : "invalid params"            
}

错误码

该接口在 HTTP Body 中返回错误码,错误码列表请参考业务错误码

×

反馈成功

非常感谢您的反馈,我们会继续努力做得更好。