评测平均分事件通知

最近更新时间:2025-08-18 15:01:12

我的收藏
若您配置了评测平均分回调地址,在评测过程中,后台会将结果以 JSON 形式回调至您的回调地址。您可以通过回调内容,进行后续的处理操作。
本文主要介绍触发评测平均分回调事件后,腾讯云云直播发送给用户的回调消息通知字段。

注意事项

阅读本文之前,希望您已经了解腾讯云直播是如何配置回调功能、您是如何接收回调消息的,具体请参见 如何接收事件通知

评测平均分事件参数说明

事件类型参数

事件类型
字段取值说明
评测阈值
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
具体的评测类型:
PSNR
SSIM
VMAF
无参考评分(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"
}