直播文件截图到 veImageX 的能力可以为您提供一站式的直播截图、截图存储、编辑和分发解决方案。
火山引擎视频直播支持将截图文件存储到 veImageX 中,便于您随时查找和访问。同时,您还可以使用 veImageX 提供的处理能力,对截图文件进行二次制作,包括基础图片处理、图像压缩、增值能力处理等。
已完成火山引擎账号注册。
本步骤为您介绍通过控制台创建截图配置的方法,您可以通过 CreateSnapshotPreset 接口创建截图配置。
创建完成后,当推流信息与截图模板信息符合时,视频直播将按照您的截图模板配置进行截图并存储。
登录视频直播控制台。
在左侧导航栏选择功能管理 > 功能配置,选择截图配置页签。
在域名空间的下拉列表中选择域名空间。
说明
如果页面显示存储位置选择按钮,请选择存储至 veImageX。
单击添加配置按钮,打开添加截图配置对话框。
说明
首次配置需要进行服务授权,单击添加配置按钮后,在弹出的对话框中单击前往申请按钮,根据提示进行授权。详细说明请参见操作参考。
根据页面提示配置 AppName、截图频率、图片格式和服务等参数。
参数说明如下表所示。
参数 | 说明 |
---|---|
AppName | 填写该推流域名对应的 AppName,仅支持小写 |
截图频率 | 配置截图频率,直播支持秒级截图,取值范围是 4~60s |
图片格式 | 支持 JPG 和 JPEG,默认为 JPG |
veImageX 服务 | 在下拉列表中选择域名空间,如果没有域名空间,可进入 veImageX 控制台进行配置 |
本步骤为您介绍通过控制台配置截图回调的方法,您也可以调用 UpdateCallback API 进行配置。您在配置完成后,可以通过回调地址接收回调参数。
登录视频直播控制台。
在左侧导航栏选择功能管理 > 功能配置,选择回调配置页签。
在域名空间的下拉列表中选择与 创建截图模板中相同的域名空间。
单击添加配置按钮,打开添加回调配置对话框。
根据页面提示配置回调地址、回调类型、域名或 AppName 等参数。
参数 | 说明 |
---|---|
回调地址 | 接收回调消息的回调地址,支持 HTTP 和 HTTPS 协议。 |
回调类型 | 回调消息的类型,选择截图。 |
回调密钥 | 回调密钥,支持大小写字母及数字,长度不超过 32 个字符。 |
域名 | 选择当前域名空间下的域名。选择域名时表示对使用当前域名的所有 AppName 适用。 |
AppName | 选择 创建截图模板,如中的 AppName。如果选择了域名,则不可同时选择 AppName。 |
单击确定按钮,完成回调配置。在回调配置列表中可以看到新增加的回调配置。
本步骤为您介绍通过控制台生成推流地址的方法,您也可以调用 GeneratePushURL API 生成。
登录视频直播控制台。
在左侧导航栏选择直播工具 > 地址生成器。
单击生成地址按钮,可在生成结果下获取新生成的推流地址。
使用生成推流地址在生成的推流地址,进行直播推流。
视频直播支持以下推流方式:
当直播结束后,直播截图的文件会存储到对应的 veImageX 空间,您可以通过截图文件的 URI 找到图片。视频直播支持通过以下 3 种方式获取截图文件的 URI。
控制台支持查询最近 90 天内的直播截图文件,每次查询的时间跨度不超过 7 天。
登录视频直播控制台。
在左侧导航栏选择功能管理 > 直播管理 > 截图管理。
根据提示填写域名、AppName、StreamName,并选择查询时间范围。
点击查询按钮,开始查询。
在结果列表中可以查看到对应截图文件的 URI。您也可以单击跳转 veImageX 管理按钮,进入 veImageX 控制台查看截图结果。
veImageX 支持锐化、图文水印、画质增强等多种图片处理能力, 您可按需创建模板。
选择 veImageX 控制台的图片处理配置 > 新建模板。
在新建模板页面,按照具体业务需求完成功能选择和参数配置。您可在图片处理配置查看各基础能力说明。
说明
如您需要使用 veImageX 增值服务,请在 veImageX 控制台开通所需的附加组件能力后,再向模板中增加相应配置。
单击保存按钮,完成图片模板配置。
选择资源管理 > 上传文件。
在文件的操作列,单击获取地址。
选择域名和图像模板,单击生成地址,得到结果图 URL。
获取模板处理结果图地址:默认地址、精简地址
获取截图原图访问地址:源地址、精简源地址
说明
在您获取截图源地址前,请开通源地址访问功能。
在浏览器输入获取的原图或结果图地址,访问图片。
示例:等比 contain 模式下且指定宽度为 400,高度为 400 的图片访问 URL:http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example.jfif~tplv-x9vch4xmek-resize-v1:400:400.image
veImageX 提供了图片智能审核功能,支持智能检测图片中涉黄、涉政、涉暴恐、违法违规等禁用行为,并通过回调返回给您最终识别结果,您根据识别结果可对违规图片执行冻结或删除等处理。从而满足您的业务审核场景,避免违规图片给您带来的业务和法律上的风险。
您可参考智能审核帮助文档新建审核任务,查看直播截图相关审核结果。