直播录像

注意事项

使用前提

• 请先联系商务开通云直播服务、CDN服务、KS3服务及点播转码服务

• 主账号需要有可用的AKSK，用于存放录像文件的bucket设置为公开读写

配置生效时间

• 配置生效时间默认为5分钟

• 配置作用时间是在直播推流开始时刻，录制过程中不更新配置

说明

• 开通MP4/FLV录像功能，需要先开启HLS录像

• 支持录像的直播中心：华北1（北京）、华北2（北京）、东南亚1（新加坡）

• 文件保存时间可以自定义修改，在对象存储（KS3）控制台操作即可

• 直播录像是对音视频封装格式的转换，不修改编码参数，因此当同一个录制文件前后编码参数不一致时，可能导致MP4、FLV录制文件异常。当相同流名前后推流编码参数不一致时建议关闭拼接功能，若有拼接需求可通过媒体处理将文件拼接

概念解释

• 切割：设置切割时长，当录制文件超过设定的切割时长后将按照命名规则生成新文件。假设推流6h，设置切割时长为2h，即每过2h会生成一次录制文件，最终会产生3个命名不同的文件。

• 断流拼接：假设断流拼接时长设为3min，断流3min之内重新推流，会在之前的录制文件后拼接；如果超过3min，重新推流，会按命名规则生成新文件。

开通方式

• 云直播控制台开通

录像格式

录制文件格式支持：HLS、MP4、FLV

录像规则

HLS录像

• 录像生成规则：同流名3分钟（可配）内断流重推对录像文件进行拼接，录像文件总时长超过6小时(可配)进行切割

• ks3存储空间： 自定义设置

• ks3存储路径：/record/{App}/{StreamName}/hls/

• 文件名：{StreamName}-{StartTime}-{EndTime}.m3u8

• 文件名格式：[流名]-[文件开始录制时间]-[文件结束录制时间].m3u8

• 存储路径：/record/{App}/{StreamName}/hls/{StreamName}-{StartTime}-{EndTime}.m3u8

• 示例：/record/yourapp/yourstream/hls/yourstream-1585829187-1585829324.m3u8

MP4录像

• 录像生成规则：同一条直播流3分钟（可配）内断流重推对录像文件进行拼接，录像文件总时长超过6小时进行切割

• ks3存储空间： 自定义设置

• ks3存储路径：/record/{App}/{StreamName}/mp4/

• 文件名：{StreamName}-{StartTime}-{EndTime}.mp4

• 文件名格式：[流名]-[文件开始录制时间]-[文件结束录制时间].mp4

• 示例：/record/yourapp/{yourstream}/mp4/yourstream-1585829187-1585829324.mp4

FLV录像

• 录像生成规则：同流名3分钟（可配）内断流重推对录像文件进行拼接，录像文件总时长超过6小时（可配）进行切割

• ks3存储空间： 自定义设置

• ks3存储路径：/record/{App}/{StreamName}/flv/

• 文件名：{StreamName}-{StartTime}-{EndTime}.flv

• 文件名格式：[流名]-[文件开始录制时间]-[文件结束录制时间].flv

• 示例：/record/yourapp/{yourstream}/flv/yourstream-1585829187-1585829324.flv

录像回调

HLS录像回调

回调url配置

在云直播控制台配置录像文件的回调url即可，在录像文件生成后我们会通过HTTP POST的方式发回调通知您。

回调示例

回调信息如下：

{
    "status":3,
    "taskid":"xxxxx",
    "items":[
        {
           
            "desc":"success",
            "keys":[
                "/record/yourapp/StreamName/hls/StreamName-1594951180-1594953010.m3u8"
            ],
            //以下为历史遗留字段，无实际意义，忽略即可
            "cmd":"",
            "vdoid":"",
            "code":3
        }
    ],
    "mediaSize":0
}

如您需要在回调内容中增加录像文件的开始时间、结束时间、bucket等信息，请联系技术支持配置新版hls录像回调。

参数说明

MP4/FLV录像回调

回调url配置

在云直播控制台配置录像文件的回调url即可，在录像文件生成后我们会通过HTTP POST的方式发回调通知您。

回调示例

{
    "taskid":"eb12e806cd3042345919d4ee8e539ez120230505",
    "type":"avtrans",
    "details":{
        "errnum":0,
        "bucket":"yourks3bucket",
        "starttime":"1456800010",
        "endtime":"1456800020",
        "stream":"yourstreamname",
        "items":[
            {
                "dstpath":"/record/yourapp/StreamName/mp4/StreamName-1594951180-1594953010.mp4",
                "outMediainfo":"{\"metadata\":{},\"format\":{\"format_name\":\"mp4\",\"size\":1027254935,\"duration\":\"5241\",\"bit_rate\":1568024},\"streams\":[{\"codec_name\":\"h264\",\"codec_type\":\"video\",\"width\":1280,\"height\":720,\"r_frame_rate\":\"25/1\"},{\"index\":1,\"codec_name\":\"aac\",\"codec_type\":\"audio\",\"channels\":2,\"sample_rate\":32000}]}"
            }
        ]
    },
 //以下为历史遗留字段，无实际意义，忽略即可
    "items":[
        {
            "cmd":"tag=avtranstag=saveas&bucket=media-kslive&object=YTMwNGQzNzQzZTdhNGRmNmE1NzAwZjkxNDJhY2RjZTlfdmRvaWQyMDE3MDkwNC5tcDQ=",
            "desc":"success",
            "keys":[
                "xxxxx.mp4"
            ],
            "code":3
        }
    ]，
 "status":3
}

参数说明

• 对details更详细的说明：

• 对items更详细的说明：

• 对输出文件信息outMediainfo的说明

metadata部分

streams部分

format部分