开始 CDN 录制

1 描述

CDN 可配置是否对所有直播流录制，若需要选择录制某条具体的直播流，可调用本接口实现。相关回调请参考 录制文件生成回调。

在使用腾讯云提供的 CDN 服务时，要明确以下录制参数：

• 录制文件格式：支持 M3U8、FLV、MP4、AAC（单音频）和 MP3（单音频）。
• 录制间隔：录制文件的时长，单位为秒 (s)，取值范围为 300 s ～ 7200 s，默认值为 7200 s。此参数对 M3U8 录制文件格式无效。如果希望录制文件的时长超过 7200 s（2 小时），则需要使用录制文件合并接口对多个录制文件进行合并。
• 存储时长：明确录制文件的保留时长。

2 接口原型

• 请求方法：GET
• 请求地址：https://rtc-api.zego.im/?Action=StartCDNRecord
• 传输协议：HTTPS
• 调用频率限制：20 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考 调用方式 中的 “2.1 公共请求参数”。

4 请求示例

https://rtc-api.zego.im/?Action=StartCDNRecord
&StreamId[]=cdn01
&StreamId[]=cdn02
&Vendor=Tencent
&EndTime=1616415377
&<公共请求参数>

5 响应参数

6 响应示例

{
    "Code":0,
    "Message":"success",
    "Data":{
        "Tencent":[ //此 Key 仅对 Vendor 设置为 Tencent 有效
            {
                "StreamName":"cdn01",
                "TaskId":"UUpTbkZUQV5WQVxrRFtDUQIUB29FWwMeAxwALBxMAggNHxw7WRUWGBVeEzoTDl0CDEoFNgIESVpXQV9rRVRCXlVKWGlFV0daVENeaFdURVNY",
                "RequestId":"70628bcd-5652-4d5c-aa04-97956a4e771a",
                "Code":"",
                "Message":""
            }
        ],
        "Ws":{//此 Key 仅对 Vendor 设置为 Ws 有效
            "call_time": "2022-04-27 14:27:48",
            "http_code": 200,
            "list": [
                {
                    "http_code": 200,
                    "id": "vega_test",
                    "msg": "success",
                    "persistentId": "2020bc8b648883c64e7e81f03cf72b70b86f",
                    "task": "mp4"
                }
            ],
            "msg": null,
            "trace_id": "15ccf21b-f3c2-4ee3-aaad-d995393f80cd"
        },
        "Huawei":[ //此 Key 仅对 Vendor 设置为 Huawei 有效
            {
                "StreamName":"hwtest",
                "RequestId":"c373b2cc8a51159d4d60e0ec543csd88",
                "Code":0,
                "Message":"success"            
            }
        ]
    },
    "RequestId":"4191282558729715911"
}

7 返回码

以下仅列出了常见的接口业务逻辑相关的返回码，完整返回码请参考 全局返回码。