You need to enable JavaScript to run this app.
导航
视频直播
  • 文档首页
    • /
  • 视频直播

直播视频截图到 veImageX

最近更新时间：2024.01.03 10:27: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 提供了图片智能审核功能，支持智能检测图片中涉黄、涉政、涉暴恐、违法违规等禁用行为，并通过回调返回给您最终识别结果，您根据识别结果可对违规图片执行冻结或删除等处理。从而满足您的业务审核场景，避免违规图片给您带来的业务和法律上的风险。

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