tencent cloud

文档反馈

直播回调

最后更新时间:2024-10-25 16:51:31
    云直播提供直播回调功能,支持通过控制台配置回调模板,针对各触发事件设置接收相关回调信息的路径。并在推流域名下进行模板关联。关联成功后,当直播过程中根据所配置模板事件触发回调功能,腾讯云主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后事件对应路径即可获取回调信息的 JSON 数据包。 本文将向您介绍如何通过控制台创建、修改及删除回调配置模板。
    其中,创建回调配置模板有以下两种方式:
    通过云直播控制台创建模板,具体操作步骤请参见 创建回调模板
    通过 API 创建模板,具体参数及示例说明请参见 创建回调模板

    注意事项

    创建成功后,还需到对应的推流域名下关联回调配置,关联成功后约5分钟 - 10分钟生效。
    回调配置中,用于接收回调事件的回调地址 httphttps 服务器必须能正常收到响应。
    控制台的回调模板管理为域名维度,暂时无法取消关联接口创建的规则,如果是通过直播回调相关接口关联指定流的,则需要通过调用 删除回调规则 解除关联。
    直播回调相关协议,请参见 事件消息通知协议
    直播回调消息通知参数说明,具体请参见:

    创建回调模板

    1. 登录 云直播控制台
    2. 在左侧菜单栏选择功能配置 > 直播回调
    3. 单击创建模板,在直播回调新建模板中填写回调信息,选择回调类型并填写回调地址,可多选。单击保存即可。
    
    
    
    配置项
    说明
    模板名称
    回调模板名称,仅支持填写中文、英文、数字、_、-,不超过30个字符。
    模板描述
    回调模板描述信息,仅支持中文、英文、数字、空格、_、-,不超过100个字符。
    回调密钥
    自定义回调密钥。字符由大小写字母及数字组成的,最多32个字符。相关使用请参见事件消息通知公共参数
    推流回调
    填写用来接收推流回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    断流回调
    填写用来接收断流回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    录制文件回调
    填写用来接收录制文件回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    录制状态回调
    填写用来接收录制状态回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    截图回调
    填写用来接收截图回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    图片审核回调
    填写用来接收图片审核回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    音频审核回调
    填写用来接收音频审核回调事件的路径,可支持协议头:HTTP、HTTPS 等。
    推流异常事件回调
    填写用来接收推流异常事件回调的路径,可支持协议头:HTTP、HTTPS 等。

    关联域名

    1. 登录云直播控制台,进入功能配置 > 直播回调
    2. 通过以下方式进入域名绑定窗口:
    直接关联域名:单击左上方的绑定域名
    
    
    
    新回调模板创建成功后关联域名回调模板创建成功后,单击提醒框中的去绑定域名
    
    
    
    3. 在域名绑定窗口中,选择您需绑定的回调模板推流域名,单击确定即可绑定成功。
    
    
    
    说明:
    支持通过单击添加为当前模板绑定多个播放域名。

    解除绑定

    1. 登录云直播控制台,进入功能配置 > 直播回调
    2. 选择已关联域名的回调模板,单击解绑
    
    
    
    3. 确认是否解绑当前关联域名,单击确定即可解绑。
    
    
    

    修改模板

    1. 登录云直播控制台,进入功能配置 > 直播回调
    2. 选择您已创建成功的回调模板,并单击右侧的编辑,即可进入修改模板信息。
    
    
    
    3. 单击保存即可。

    删除模板

    注意:
    若模板已被关联,需要先解除绑定,才可以进行删除操作。
    删除模板后将无法恢复,请谨慎操作。
    1. 登录云直播控制台,进入功能配置 > 直播回调
    2. 选择您已创建成功的回调模板,单击右侧的删除
    
    
    
    3. 确认是否删除当前回调配置模板,单击确定即可成功删除。
    
    
    

    相关操作

    域名维度绑定和解绑回调模板的具体操作及相关说明,请参见 回调配置
    联系我们

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

    技术支持

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

    7x24 电话支持