You need to enable JavaScript to run this app.
导航
直播视频截图到 veImageX
最近更新时间:2024.07.26 17:56:37首次发布时间:2023.09.19 10:07:33

直播视频截图到 veImageX 的能力可以为您提供一站式的直播截图、截图存储、编辑和分发解决方案。

火山引擎视频直播支持将截图文件存储到 veImageX 中,便于您随时查找和访问。同时,您还可以使用 veImageX 提供的处理能力,对截图文件进行二次制作,包括基础图片处理、图像压缩、增值能力处理等。

前提条件

操作步骤

创建截图模板

本步骤为您介绍通过控制台创建截图配置的方法,您可以通过 CreateSnapshotPreset 接口创建截图配置。
创建完成后,当推流信息与截图模板信息符合时,视频直播将按照您的截图模板配置进行截图并存储。

  1. 登录视频直播控制台

  2. 在左侧导航栏选择功能管理 > 功能配置,选择截图配置页签。

  3. 域名空间的下拉列表中选择域名空间。

    说明

    如果页面显示存储位置选择按钮,请选择存储至 veImageX

  4. 单击添加配置按钮,打开添加截图配置对话框。

    说明

    首次配置需要进行服务授权,单击添加配置按钮后,在弹出的对话框中单击前往申请按钮,根据提示进行授权。详细说明请参见操作参考

  5. 根据页面提示配置 AppName、截图频率、图片格式和服务等参数。

    参数说明如下表所示。

    参数说明
    AppName填写该推流域名对应的 AppName,仅支持小写
    截图频率配置截图频率,直播支持秒级截图,取值范围是 4~60s
    图片格式支持 JPG 和 JPEG,默认为 JPG
    veImageX 服务在下拉列表中选择域名空间,如果没有域名空间,可进入 veImageX 控制台进行配置

配置截图回调

本步骤为您介绍通过控制台配置截图回调的方法,您也可以调用 UpdateCallback API 进行配置。您在配置完成后,可以通过回调地址接收回调参数。

  1. 登录视频直播控制台

  2. 在左侧导航栏选择功能管理 > 功能配置,选择回调配置页签。

  3. 域名空间的下拉列表中选择与 创建截图模板中相同的域名空间。

  4. 单击添加配置按钮,打开添加回调配置对话框。

  5. 根据页面提示配置回调地址、回调类型、域名或 AppName 等参数。

    参数说明
    回调地址接收回调消息的回调地址,支持 HTTP 和 HTTPS 协议。
    回调类型回调消息的类型,选择截图
    回调密钥回调密钥,支持大小写字母及数字,长度不超过 32 个字符。
    域名选择当前域名空间下的域名。选择域名时表示对使用当前域名的所有 AppName 适用。
    AppName选择 创建截图模板,如中的 AppName。如果选择了域名,则不可同时选择 AppName。
  6. 单击确定按钮,完成回调配置。在回调配置列表中可以看到新增加的回调配置。

生成推流地址

本步骤为您介绍通过控制台生成推流地址的方法,您也可以调用 GeneratePushURL API 生成。

  1. 登录视频直播控制台

  2. 在左侧导航栏选择直播工具 > 地址生成器

  3. 单击生成地址按钮,可在生成结果下获取新生成的推流地址。

开始直播推流

使用生成推流地址在生成的推流地址,进行直播推流。

视频直播支持以下推流方式:

  • 使用视频直播控制台上的 Web 推流工具进行推流;

  • 使用推流工具(如 OBS)进行推流;

  • 使用客户端 SDK 进行推流。

获取图片存储 URI

当直播结束后,直播截图的文件会存储到对应的 veImageX 空间,您可以通过截图文件的 URI 找到图片。视频直播支持通过以下 3 种方式获取截图文件的 URI。

控制台支持查询最近 90 天内的直播截图文件,每次查询的时间跨度不超过 7 天。

  1. 登录视频直播控制台

  2. 在左侧导航栏选择功能管理 > 直播管理 > 截图管理

  3. 根据提示填写域名、AppName、StreamName,并选择查询时间范围。

  4. 点击查询按钮,开始查询。

  5. 在结果列表中可以查看到对应截图文件的 URI。您也可以单击跳转 veImageX 管理按钮,进入 veImageX 控制台查看截图结果。

创建截图文件处理模板(可选)

veImageX 支持锐化、图文水印、画质增强等多种图片处理能力, 您可按需创建模板。

  1. 选择 veImageX 控制台图片处理配置 > 新建模板

  2. 在新建模板页面,按照具体业务需求完成功能选择和参数配置。您可在图片处理配置查看各基础能力说明。

    说明

    如您需要使用 veImageX 增值服务,请在 veImageX 控制台开通所需的附加组件能力后,再向模板中增加相应配置。

  3. 单击保存按钮,完成图片模板配置。

获取截图文件访问 URL(可选)

  1. 选择资源管理 > 上传文件

  2. 在文件的操作列,单击获取地址

  3. 选择域名和图像模板,单击生成地址,得到结果图 URL。

    1. 获取模板处理结果图地址:默认地址、精简地址

    2. 获取截图原图访问地址:源地址、精简源地址

    说明

    在您获取截图源地址前,请开通源地址访问功能。

访问 URL(可选)

在浏览器输入获取的原图或结果图地址,访问图片。

示例:等比 contain 模式下且指定宽度为 400,高度为 400 的图片访问 URL:http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-resize-v1:400:400.image

使用智能审核检测图片类型(可选)

veImageX 提供了图片智能审核功能,支持智能检测图片中涉黄、涉政、涉暴恐、违法违规等禁用行为,并通过回调返回给您最终识别结果,您根据识别结果可对违规图片执行冻结或删除等处理。从而满足您的业务审核场景,避免违规图片给您带来的业务和法律上的风险。

您可参考智能审核帮助文档新建审核任务,查看直播截图相关审核结果。