tencent cloud

文档反馈

录制状态事件通知

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

    注意事项

    阅读本文之前,希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的,具体请参见 如何接收事件通知
    在拉流转推录制回调中,流 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
    recordevent
    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"
    }
    
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持