更新云端录制

API接口URL

https://sdk.cloudroom.com/CLOUDMEETING-API/v2/record/update

请求方式：POST

参数

公共参数

接口参数

说明：audioFileCfg 和 videoFileCfg 请至少选择一种。

AudioFileCfg 音频文件配置

仅单流模式支持更新已有音频配置（合流模式不支持）。

注意：不可传 svrPathName，文件名不可修改。

VideoFileCfg 视频文件配置

单流模式 — 更新已有视频配置：

注意：不可传 svrPathName、aStreamType。

合流模式 — 更新已有视频配置：

注意：不可传 aChannelType、aChannelContent、vWidth、vHeight、vFps、vBps、vQP。

请求示例

单流 - 更新视频订阅名单

将录制所有人的默认摄像头改为仅录制指定用户的摄像头：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "videoFileCfg": {
        "subscribeVideos": ["user1.-1", "user2.1"]
    }
}

单流 - 更新音频订阅名单

将录制所有人的音频改为只录制指定用户：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "AppId": "demo",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "audioFileCfg": {
        "subscribeAudios": ["user1", "user2"]
    }
}

单流 - 同时更新音频和视频订阅名单

同时更换音频和视频的订阅用户：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "AppId": "demo",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "audioFileCfg": {
        "subscribeAudios": ["user1", "user2"]
    },
    "videoFileCfg": {
        "subscribeVideos": ["user1.-1", "user2.1"]
    }
}

单流 - 更新视频订阅名单 + 推流配置

更新订阅名单的同时，将指定摄像头的流推到第三方直播平台：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "videoFileCfg": {
        "subscribeVideos": ["user1.-1", "user2.1"],
        "pushCfg": [
            {
                "streamID": "user1.-1",
                "urls": ["rtmp://push.example.com/live/stream1"]
            }
        ]
    }
}

合流 - 更新布局并增加输出格式

原任务录制 MP4，现增加 FLV 格式和 RTMP 推流，同时调整布局为左右分屏：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "AppId": "demo",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "videoFileCfg": {
        "svrPathName": "/2025-12-01/房间号/2025-12-01_mixed.mp4;/2025-12-01/房间号/2025-12-01_mixed.flv;rtmp://push.example.com/live/stream1;",
        "layoutConfig": [
            {
                "type": 0,
                "top": 180,
                "left": 0,
                "width": 640,
                "height": 360,
                "keepAspectRatio": 1,
                "param": { "camid": "user1.-1" }
            },
            {
                "type": 0,
                "top": 180,
                "left": 640,
                "width": 640,
                "height": 360,
                "keepAspectRatio": 1,
                "param": { "camid": "user2.-1" }
            }
        ]
    }
}

合流 - 仅更新输出格式

原任务录制 MP4，现增加 FLV 文件和 RTMP 推流，布局不变：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "AppId": "demo",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "videoFileCfg": {
        "svrPathName": "/2025-12-01/房间号/2025-12-01_mixed.mp4;/2025-12-01/房间号/2025-12-01_mixed.flv;rtmp://push.example.com/live/stream1;"
    }
}

合流 - 仅更新布局

不改变输出格式，仅将布局从单画面切换为左右分屏：

{
    "RequestId": "95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID": 111111,
    "SecretKey": "08635988d9be4151fcb5251b0af2b3c1",
    "AppId": "demo",
    "RoomId": 81954961,
    "RecordID": "9eda74eecb5de36e492dbab55aaaa071",
    "videoFileCfg": {
        "layoutConfig": [
            {
                "type": 0,
                "top": 180,
                "left": 0,
                "width": 640,
                "height": 360,
                "keepAspectRatio": 1,
                "param": { "camid": "user1.-1" }
            },
            {
                "type": 0,
                "top": 180,
                "left": 640,
                "width": 640,
                "height": 360,
                "keepAspectRatio": 1,
                "param": { "camid": "user2.-1" }
            }
        ]
    }
}

返回数据

返回参数示例

{
    "RspCode": 0,
    "RspDesc": "请求成功"
}

返回状态码RspCode说明