视频直播 LIVE-直播事件回调:截图回调

时间:2024-07-25 19:53:31

截图回调

直播截图回调用于推送截图状态信息,当截图文件生成时触发该回调事件。回调消息字段如表3所示。

表3 消息体字段说明

字段

描述

domain

推流 域名

app

应用名称。

stream_name

流名称。

snapshot_url

截图下载链接。

width

图片宽度。

单位:像素。

height

图片高度。

单位:像素。

obs_addr

截图所在的OBS桶地址,具体结构体说明如下所示:
  • bucket:OBS的桶名称。
  • location:OBS桶所在数据中心。
  • object:OBS对象路径。

auth_timestamp

事件通知签名过期UNIX时间戳。当配置了“鉴权密钥”时,携带该字段。

格式为十进制的UNIX时间戳,即从1970年1月1日(UTC/GMT的午夜)以来的当前时间秒数。

示例:1592639100(即2020-06-20 15:45)

auth_sign

事件通知签名。当配置了“鉴权密钥”时,携带该字段。

auth_sign = HmacSHA256(domain + app + stream_name + snapshot_url + width + height + obs_addr.bucket + obs_addr.location + obs_addr.object + auth_timestamp,key)

其中,key为鉴权密钥值。

消息示例如下所示:

{ 
    "domain": "play.example.com",
    "app": "live",
    "stream_name": "test001",
    "snapshot_url": "https://xxx.obs.cn-north-4.myhuaweicloud.com:443...",
    "width":"720",
    "height":"1280",
    "obs_addr": {
        "bucket": "xxx",
        "location": "cn-north-4",
        "object": "xxx.jpg"
    },
    "auth_timestamp":1587954140,
    "auth_sign":"4918b1axxxxxxb583cffa119d72513bbc35a989f8569fxxxxxx057646154a04a"
}
support.huaweicloud.com/bestpractice-live/live_14_0003.html