混流录制

描述

• 在开始录制前, 必须调用 mix 方法请求一个用于云端录制的 taskId

接口请求地址

• 请求方式：POST/JSON
• 传输协议：HTTPS
• 调用频次限制：50 次/秒
• 请求 URL：
  

https://brtc-api.baijiayun.com/vcs/recording/stream/mix

API鉴权

参见 Restful API 基本认证

请求参数

input_params 成员

fill_frame 成员

watermarks 成员

• 一个视频输出文件最多可以添加 25 个文字、25 个时间水印和 25 个图片水印
• 水印框完全透明, 无颜色
• 如果水印超出画布范围, 则水印框与画布的交集区域会作为显示区域
• 图片水印, 图片宽高为图片的实际宽高

mix_config 成员

input_list 成员

video 成员

输出视频的分辨率size可选值

请求示例

• 请求包体内容：
  

{
    "app_id": "BZ2no1v919Die6mLc2nNOGvfqcQNSfKO",
    "room_id": "33669",
    "input_params": {
        "main_user_id": "20",
        "fill_frame": {
            "fill_mode": 1
        },
        "watermarks": [{
                "type": "text",
                "text": "abc123",
                "offset_x": 100,
                "offset_y": 100,
                "font_size": 70,
                "font_color": "#FFFFFF"
            },
            {
                "type": "text",
                "text": "this is name",
                "offset_x": 100,
                "offset_y": 100,
                "font_size": 70,
                "font_color": "#FFFFFF"
            },
            {
                "type": "time",
                "offset_x": 100,
                "offset_y": 100,
                "font_size": 70,
                "font_color": "#FFFFFF"
            },
            {
                "type": "image",
                "offset_x": 100,
                "offset_y": 100,
                "url": "https://xxx.png"
            }
        ],
        "mix_config": {
            "mix_mode": 1,
            "input_list": [{
                    "user_id": "122333",
                    "stream_type": 1,
                    "x": 2,
                    "y": 2,
                    "width": 360,
                    "height": 240,
                    "z_order": 1
                },
                {
                    "user_id": "12333",
                    "stream_type": 1,
                    "x": 200,
                    "y": 40,
                    "width": 360,
                    "height": 240,
                    "z_order": 1
                }
            ],
            "audio_only": [
                "1111",
                "222",
                "555"
            ],
            "video": {
                "size": "1280x720",
                "bit_rate": 1024,
                "background_color": "#ffffff",
                "fps": 15
            }
    }
  }
}

响应参数

响应示例

• 响应包体内容：
  

{
    "code": 200,
    "data": {
        "task_id": "33669@BZ2no1v919Die6mLc2nNOGvfqcQNSfKO"
    },
    "msg": "succeed"
}