直播录像

注意事项

使用前提

• 请先联系商务开通云直播服务、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",
    "itmes":[
        {
           
            "desc":"success",
            "keys":[
                "/record/yourapp/StreamName/hls/StreamName-1594951180-1594953010.m3u8"
            ],
            //历史字段，忽略即可
            "cmd":"",
            "vdoid":"",
            "code":3
        }
    ],
    "mediaSize":0
}

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

参数说明

参数	示例	描述
status	3	任务执行的状态（3：成功；4：失败）
taskid	00PNwad2wdoO	执行本次录像操作的唯一任务ID
desc	success	任务执行的结果
keys	见回调示例	m3u8文件在ks3中的路径

MP4/FLV录像回调

回调url配置

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

回调示例

{
    "taskid":"xxxxx",
    "status":3,
    "type":"avtrans",
    "details":{
        "errnum":0,
        "bucket":"xxxx",
        "starttime":"1456800010",
        "endtime":"1456800020",
        "stream":"xxxx",
        "throughParams":"xxxx",
        "items":[
            {
                "dstpath":"/record/yourapp/StreamName/mp4/StreamName-1594951180-1594953010.mp4",
                "ETag":"cb1b99f6657c91dac6c1913cd99131a1",
                "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
        }
    ]
}

参数说明

字段名	类型	是否必有	描述
taskid	string	是	任务ID
status	int	是	任务状态：3为成功，4为失败
type	string	是	任务类型，与创建任务时使用的模板类型一致
details	json object	是	更详细的信息

• 对details更详细的说明：

字段名	类型	是否必有	描述
errnum	int	是	视频信息
errmsg	string	是	视频metadata
bucket	string	是	视频流信息列表
stream	string	否	流名
starttime	string	否	该流起始时间
endtime	string	否	该流结束时间
throughParams	string	否	透传参数
items	json array	是	回调中用户定制的输出文件信息等

• 对items更详细的说明：

字段名	类型	是否必有	描述
dstpath	int	是	文件在ks3中的路径
ETag	string	是	视频内容的md5值
outMediainfo	string	是	avtrans任务的回调字段，输出视频的信息。string类型，string内部是json串

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

字段名	类型	是否必有	描述
metadata	json object	是	视频metadata
streams	json array	是	视频流信息列表
format	json object	是	视频文件信息

metadata部分

字段名	类型	是否必需	描述
rotate	string	否	旋转信息

streams部分

字段名	类型	是否必需	描述
index	int	是	序号
codec_type	string	是	流类型
codec_name	string	是	编码格式
bit_rate	int	是	码率，单位bps
width	int	否	宽
height	int	否	高
r_frame_rate	string	否	帧率
channels	int	否	声道数
sample_rate	int	否	音频采样率

format部分

字段名	类型	是否必需	描述
duration	string	是	文件时长，单位秒
format_name	string	是	文件格式
size	int	是	文件大小，单位字节