云直播 录制状态事件通知

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

相关产品
云直播 产品页,含版本规格、价格与购买入口。

这篇主要讲解触发录制状态回调事件后,腾讯云直播发送给用户的回调消息通知字段。

一、注意事项

·阅读这篇之前,希望你已经了解腾讯云直播是如何配置回调功能、你是如何接收回调消息的,具体请参见 如何接收事件通知。

·在拉流转推录制回调中,流 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:FLV2:HLS3:MP44:AAC5:MP3record_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 录制任务 ID,仅 API 创建的录制任务有意义,即 CreateRecordTask 返回的任务 ID。
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}

赞 (0)
上一篇 4天前
下一篇 4天前