视频直播支持直播事件消息回调功能，您可以针对全部流或部分流开启推流开始、推流结束、录制、截图和截图审核事件类型的回调。本文为您介绍如何通过视频直播控制台添加回调配置。

前提条件 #

已获取用于接收回调消息的地址。该地址需支持 HTTP 或 HTTPS 协议，并可通过公网访问。

注意事项 #

生效时间：添加、编辑或删除回调配置后，必须等待 3-5 分钟才会生效。

操作步骤 #

1. 登录视频直播控制台。
2. 左侧导航栏选择功能管理 > 功能配置，并在右侧功能配置页面单击回调配置页签。
3. 在页面域名空间的下拉列表中，选择域名空间。
   
4. 单击添加配置，打开添加回调配置对话框。
5. 完成以下配置并单击确定。
   
   

   参数	说明
   回调地址	用于接收回调消息的地址。该地址需支持 HTTP 或 HTTPS 协议，并可通过公网访问。长度为 1 到 100 个字符。
   回调类型	回调消息的类型。 推流开始：推流开始时触发回调。 推流结束：推流结束时触发回调。 录制：存储直播录制文件时触发回调。 截图：存储直播截图时触发回调。 截图审核：存储直播审核截图时触发回调。
   回调范围	选择触发回调的范围。 域名：选择当前域名空间下的全部域名或指定域名，仅选择的域名会触发回调。 AppName：输入指定 AppName，仅该指定 AppName 会触发回调。如不配置，则所有 AppName 均会触发回调。 说明 该参数仅在回调类型选择录制、截图或截图审核时可见。
   配置域名	选择当前域名空间下的全部域名或指定域名。仅选择的域名会触发回调。 例如域名选择 push.example.com，回调类型选择推流开始，则仅在使用域名 push.example.com 推流时，会触发推流开始回调。 说明 当回调类型选择录制、截图或截图审核时，该参数仅在回调范围选择域名时可见。
   AppName	输入 AppName。仅该 AppName 会触发回调。如不配置，则所有 AppName 均会触发回调。 说明 该参数仅在回调范围选择 AppName 时可见。
   转码流回调	是否额外对转码流触发推流开始或推流结束回调。默认关闭，仅对源流触发回调。 开启：如果当前域名空间下存在匹配的转码配置，视频直播会同时对源流和对应转码流触发回调。转码配置中的 AppName 与推流地址中的 AppName 相同，或转码配置中的 AppName 为 * 时，均表示匹配。例如回调类型为推流开始，且当前域名空间下存在 AppName 为 live、转码流后缀为 _uhd 的转码配置，则使用 AppName live、StreamName test 推流时，会分别对源流 test 和转码流 test_uhd 触发推流开始回调。 关闭：仅对源流触发回调。 说明 该参数仅在回调类型选择推流开始或推流结束时可见。
   回调密钥	配置回调密钥后，业务服务器可根据签名参数验证请求来源的合法性。 支持大小写字母（A-Z、a-z）及数字（0-9），长度不超过 32 个字符。

6. 配置添加成功后，需等待 3-5 分钟生效。您也可以单击操作列的编辑或删除，编辑回调配置的转码流回调开关状态或回调密钥，或删除指定回调配置。