录制状态事件通知

最近更新时间:2023-12-04 17:53:12

我的收藏
直播录制是根据推流域名已绑定好的录制模板实时录制直播流画面,并生成对应的录制文件存储到云点播中。而录制状态回调则用于推送录制状态信息,主要包括录制启动成功、录制启动失败、录制暂停、录制续录成功、录制异常、录制结束。您需在回调模板中配置录制事件回调消息接收服务器地址,并将该模板与推流域名进行关联。当直播流触发录制事件后,腾讯云直播后台会将录制事件信息回调到您设置的接收服务器中。
本文主要讲解触发录制状态回调事件后,腾讯云直播发送给用户的回调消息通知字段。

注意事项

阅读本文之前,希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的,具体请参见 如何接收事件通知
在拉流转推录制回调中,流 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 是否正确,进而确认消息是否确实来自腾讯云后台。
说明:
key功能配置 >直播回调 中的回调密钥,主要用于鉴权。为了保护您的数据信息安全,建议您填写。




录制状态回调消息参数

字段名称
类型
说明
appid
int
用户 APPID
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 :录制结束
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"
}