一、注意事项
阅读这篇之前,希望你已经了解腾讯云直播是如何配置回调功能、你是如何接收回调消息的,具体请参见 如何接收事件通知。
二、事件类型参数
| 事件类型 | 字段取值说明 |
| 评测阈值 | event_type = 345 |
三、回调公共参数
| 字段名称 | 类型 | 说明 |
| 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 | 业务 ID。 |
| appname | string | 推流 path 路径。 |
| stream_id | string | 流 ID。 |
| domain | string | 推流域名。 |
| event_time | int64 | 请求发送时间,UNIX 时间戳(秒)。 |
| transcode_template_id | int | 转码模板 ID。 |
| watermark_template_id | int | 水印模板 ID,有参考评测(PSNR/SSIM/VMAF)只评测转码流,无水印模板 ID。 |
| frames | Array of Frame | 评测周期内的每帧分数及时间。 |
| average_score | float | 评测周期内的平均分。 |
| max_score | float | 评测周期内的最大分值。 |
| min_score | float | 评测周期内的最小分值。 |
| function | string | 功能大类:评测(Assessment)。 |
| class | string | 具体的评测类型:PSNRSSIMVMAF无参考评分(VQA) |
五、Frame
单帧的评测分数和时间。
| 名称 | 类型 | 描述 |
| score | float | 评分。 |
| time | int64 | UNIX 时间戳(毫秒)。 |
六、回调消息示例
{ "event_type": 344, "appid": 1234576, "appname": "live", "domain": "abc.record.test.org", "stream_id": "livestream1", "transcode_template_id": 12345, "event_time": 1752130787, "frames": [ { "score": 22.78, "time": 1752130785280 }, { "score": 32.75, "time": 1752130786281 } ], "average_score": 27.765, "max_score": 32.75, "min_score": 22.78, "function": "Assessment", "class": "PSNR"}