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

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

前提条件

• 已完成火山引擎账号注册，并完成实名认证。

• 已开通火山视频直播和 veImageX 服务。若未开通，请前往开通视频直播和 veImageX。

• 在视频直播控制台已添加直播推流域名并配置 CNAME。

• 在 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。

创建截图文件处理模板（可选）

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

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

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

   说明

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

   

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

获取截图文件访问 URL（可选）

访问 URL（可选）

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

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

使用智能审核检测图片类型（可选）

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

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