使用 veImageX 实时处理点播空间图片

您可以通过 veImageX 来实时处理存储在点播本地空间的图片资源，同步实现例如格式转换、图像压缩、缩放等一系列的处理操作。

背景信息

视频点播是一款可提供集媒资上传、媒资管理、多媒体处理、内容加速分发和视频播放功能于一体的音视频服务。其中对于图片文件的处理，您可通过跨服务授权的方式，使用 veImageX 对存放在点播空间中的图片文件进行实时处理，包括画质增强、图片压缩等操作。经过处理后的图片文件将仍然存储在点播空间中，进而通过 veImageX-CDN 回源到点播对处理后的图片文件进行加速分发。

前提条件

• 已开通 veImageX 服务，且服务状态正常。

• 已开通视频点播服务，且本地空间内拥有相应图片资源。

注意事项

• 在 veImageX 控制台授权跨服务访问后，访问控制中角色列表里会新增一个名为 ServiceRoleForImageX 的角色。如果删除了该角色，将导致跨服务访问不可用，即从 veImageX 侧访问点播空间中的文件会因权限问题而失败。

• 如果删除了 veImageX 授权绑定的点播空间，veImageX 则无法访问该点播空间的资源。

• 组合使用视频点播和 veImageX 时，原图资源仅会存储在点播空间中。但是如果您在 veImageX 模板开启处理结果持久化配置，那么经模板处理后的结果图数据会在 veImageX 进行缓存。再次访问处理图时默认优先加载 veImageX 缓存数据。

• veImageX 仅支持读取存储在点播本地的图片资源，如果您的点播空间且已将存储地址切换为 TOS 存储桶时，此时 veImageX 无法保证能高可用读取。若您需要对 TOS 存储图片使用 veImageX 处理能力，请参考使用 veImageX 实时处理 TOS 存储图片。

计费说明

• 使用视频点播将收取相应的存储费用，具体计费详情请参考媒资存储。

• 当您涉及以下操作项时 veImageX 将收取相应费用，具体计费详情参考 veImageX 计费说明。

  • 高效图像压缩费用：在模板中将指定图片格式转换为 HEIC、HEIF、AVIF、AVIS 和 VVIC 这 5 种先进格式。

  • 增值服务费用：在模板中使用了截帧、小视频转动图及模板支持的附加组件能力。

  • 基础图像处理费用：在模板中使用了除高效压缩和增值服务以外的其他配置，如亮度、对比度等。

  • 资源存储费用：在模板中开启持久化后缓存的结果图数据。

  • 资源分发费用：访问缓存结果。

操作步骤

绑定点播空间

1. 登录 veImageX 控制台，进入服务管理页面。

2. 选择待配置的服务后，单击基础配置按钮。

3. 在存储配置页签下，选择点播授权配置项，单击去授权按钮。

4. 在授权状态为已授权后，单击修改图标，绑定点播空间，以便 veImageX 可读取该空间的图片资源。

   

获取访问域名

1. 在完成绑定点播空间后，单击分发配置页签。

2. 在域名信息中获取已解析且状态正常的域名。

   

创建图片处理模板

1. 在 veImageX 控制台，进入处理配置页面。

2. 单击新建模板按钮，根据模板配置说明按需创建图像处理模板。

3. 在模板配置完成后，复制模板配置，例如tplv-ydxxxxx2k-test.png。

   

获取点播空间图片文件路径

veImageX 支持对以下三种点播空间存储的图片进行处理，请参考以下内容获取拼接所需的各类型图片文件路径。

获取封面图文件路径

在点播控制台获取

通过回调事件获取

通过 OpenAPI 获取

说明

请确保您已在视频点播完成以下设置。

• 在系统设置 > 上传存储设置中开启自定生成封面和候选封面，具体详见封面图。

• 在分发加速设置 > 域名管理中新增封面加速域名。

1. 登录视频点播控制台，进入空间。

2. 单击左侧导航栏媒资管理 > 视频管理，进入视频管理页面。

3. 切换至 Vid 模式或者 DirectUrl 模式页签，单击操作列的详情按钮，进入视频详情页面。

4. 切换基础信息页面，单击复制封面图地址获取封面图加载 URL 后，从中截取所需的文件路径。

1. 在系统设置 > 回调设置，在参数配置页签下，勾选媒资上传完成事件。

2. 在回调记录中查看回调内容，获取 FileName 。具体详见媒资上传完成事件。

调用确认上传 API，获取视频对应的封面图 PosterUri，例如tos-vod-cn-v-03e4d5***12705/视频01_cover，截取第一级目录后的部分作为文件路径，即 视频01_cover。

获取视频截图文件路径

在点播控制台获取

通过回调事件获取

通过 OpenAPI 获取

说明

请确保您已在视频点播设置截图工作流模板。

1. 登录视频点播控制台，进入空间。

2. 单击左侧导航栏媒资管理 > 视频管理，进入视频管理页面。

3. 切换至 Vid 模式或者 DirectUrl 模式页签，单击操作列的详情按钮，进入视频详情页面。

4. 切换截图结果页签，单击复制链接按钮获取完整的 URL 后 ，从中截取所需的文件路径。

1. 在系统设置 > 回调设置，在参数配置页签下，勾选工作流执行完成事件。

2. 在回调记录中，查看回调内容，获取不同截图类型对应的 FileName。具体详见工作流执行完成事件。

调用获取截图结果 API，获取截图 StoreUri，例如tos-vod-cn-v-03e***12705/2df***8f，截取第一级目录后的部分作为文件路径为，即 2df***8f。

获取上传素材图片文件路径

拼接处理图 URL

您可参考下图，依次拼接各参数获取最终结果图访问 URL，查看处理效果。

拼接示例：

您已参考以上步骤获取了 veImageX 访问域名test.example.com、点播图片文件路径voddemo.png 和 veImageX 图片模板配置~tplv-f0****5k-test.png。

则最终结果图访问 URL 为 http://test.example.com/voddemo.png~tplv-f0****5k-test.png。