云直播 如何接收事件通知

当直播过程中域名关联模板事件被触发时,腾讯云将主动发送请求到客户服务器,客户服务器负责应答请求。验证通过后,可以被动获取到含直播事件回调信息的 JSON 数据包。

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

目前直播事件触发消息通知支持的事件包括:直播推流、直播断流、直播录制、直播截图、直播画面审核事件通知、直播音频审核事件通知、推流异常事件通知、拉流转推事件通知、监播事件通知。

一、整体流程

流程说明:

1. 主播在控制台或直接调用云 API 配置事件消息通知 URL 以及录制、截图等相关功能。

2. 主播进行直播推断流。

3. 当直播服务内部有事件发生时,消息将会经由事件消息通知服务统一回调给客户后台。

二、网络协议

·请求:HTTP POST 请求,包体内容为 JSON,每一种消息的具体包体内容参见后文。

·应答:HTTP STATUS CODE = 200,服务端忽略应答包具体内容,为了协议友好,建议客户应答内容携带 JSON: {"code":0}

三、通知可靠性

事件通知服务具备重试能力,截图事件通知重试间隔为2分钟,总计重试5次,除此之外直播推流、直播断流、直播录制、直播画面审核消息事件通知、直播音频审核事件通知重试间隔为1分钟,总计重试12次。
为了避免重试对你的服务器以及网络带宽造成冲击,请保持正常回包。触发重试条件如下:

·长时间(20 秒)未回包应答。

·应答 HTTP STATUS 不为200。

四、回调事件配置方式

回调配置主要通过两种方式实现,一种是通过 云直播控制台,另一种是通过调用 服务端 API。

注意:直播回调事件消息通知 URL 支持对推流事件、断流事件、录制事件、截图事件、画面审核事件、音频审核事件配置独立回调 URL。

五、云直播控制台

1. 进入云直播控制台的 功能配置 > 直播回调,创建回调模板,具体操作可参见 创建回调模板。

2. 在 域名管理找到你需操作的推流域名,单击管理 > 模板配置,将此域名与回调模板进行关联。具体操作请参见 回调配置。

六、服务端 API

1. 调用 CreateLiveCallbackTemplate 创建回调模板接口,设置你需要的回调参数信息。

2. 调用 CreateLiveCallbackRule 创建回调规则,设置参数推流域名 DomainName 和 TemplateId(第1步返回),填写与推流和播放地址中一致的 AppName,实现部分直播流开启回调的效果。

七、回调信息参数说明

回调模板关联域名成功后,当直播过程中触发模板事件,腾讯云将主动发送含回调信息的 JSON 包到客户服务器,回调信息具体参数说明如下:

·推流事件消息通知

·断流事件消息通知

·录制文件事件消息通知

·录制状态事件消息通知

·截图事件消息通知

·画面审核消息事件通知

·音频审核消息事件通知

·质检事件通知

·评测阈值事件通知

·评测平均分事件通知

·智能擦除事件通知

·直播字幕事件通知

·直播摘要事件通知

·高光切片事件通知

·推流异常事件通知

·录制异常事件通知

·拉流转推事件通知

·监播事件通知

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