公告
录制状态事件通知
直播录制是根据推流域名已绑定好的录制模板实时录制直播流画面，并生成对应的录制文件存储到云点播中。而录制状态回调则用于推送录制状态信息，主要包括录制启动成功、录制启动失败、录制暂停、录制续录成功、录制异常、录制结束。您需在回调模板中配置录制事件回调消息接收服务器地址，并将该模板与推流域名进行关联。当直播流触发录制事件后，腾讯云直播后台会将录制事件信息回调到您设置的接收服务器中。
本文主要讲解触发录制状态回调事件后，腾讯云直播发送给用户的回调消息通知字段。
注意事项
阅读本文之前，希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的，具体请参见 如何接收事件通知。
在拉流转推录制回调中，流 ID 指的是拉流转推任务的 Task ID。
录制状态回调参数说明
事件类型参数
事件类型 | 字段取值说明 |
直播录制 | event_type = 332 |
回调公共参数
字段名称 | 类型 | 说明 |
t | int64 | 过期时间，事件通知签名过期 UNIX 时间戳。 来自腾讯云的消息通知默认过期时间是10分钟，如果一条消息通知中的 t 值所指定的时间已经过期，则可以判定这条通知无效，进而可以防止网络重放攻击。 t 的格式为十进制 UNIX 时间戳，即从1970年01月01日（UTC/GMT 的午夜）开始所经过的秒数。 |
sign | string | 事件通知安全签名 sign = MD5（key + t）。 说明：腾讯云把加密 key 和 t 进行字符串拼接后通过 MD5 计算得出 sign 值，并将其放在通知消息里，您的后台服务器在收到通知消息后可以根据同样的算法确认 sign 是否正确，进而确认消息是否确实来自腾讯云后台。 |
录制状态回调消息参数
字段名称 | 类型 | 说明 |
appid | int | |
appname | string | 推流路径 |
domain | string | 推流域名 |
event_time | int | 事件时间 |
event_type | int | 事件类型 |
record_detail | string | file_format：文件格式 1：FLV 2：HLS 3：MP4 4：AAC 5：MP3 record_bps：码率 start_model：任务拉起方式 1：录制模板规则拉起 5：API调用拉起 record_content：录制内容 1：原始流 2：水印流 3：转码流 source_type：录制流类型 1：直播录制 2：拉流转推录制 codec_temp_id：转码模板 ID |
record_event | string | record_start_succeeded ：录制启动成功 record_start_failed：录制启动失败 record_paused ：录制暂停 record_resumed ：录制续录成功 record_error ：录制异常 record_ended ：录制结束 |
task_id | string | |
seq | string | 消息序号 |
session_id | string | 录制任务 ID |
stream_id | string | 直播流名称 |
回调消息示例
{"appid":123456789,"appname": "live","domain":"****.livepush.myqcloud.com","event_time":1700207929,"event_type":332,"record_detail":"{\\\\"file_format\\\\":2,\\\\"record_bps\\\\":0,\\\\"start_model\\\\":1,\\\\"record_content\\\\":1,\\\\"source_type\\\\":2,\\\\"codec_temp_id\\\\":0}","record_event":"record_ended","seq": "3266441426274648065","session_id":"2918085116267032069","stream_id":"2991615887188599295","sign": "ca3e25e5dc17a6f9909a9ae7281e300d","t": 1754623810}
文档反馈