You need to enable JavaScript to run this app.
导航
使用 veImageX 实时处理点播空间存储图片
最近更新时间:2024.02.02 18:38:22首次发布时间:2023.12.22 18:03:01

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

背景信息

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

前提条件

注意事项

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

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

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

  • 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 支持对以下三种点播空间存储的图片进行处理,请参考以下内容获取拼接所需的各类型图片文件路径。

获取封面图文件路径

说明

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

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

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

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

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

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

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

  • URL :http://test.com/tos-cn-p-ku**00/ac3e587****df990e28c1ed238ed2c6b~tplv-vod-noop.image
  • 文件路径:ac3e587****df990e28c1ed238ed2c6b

获取视频截图文件路径

说明

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

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

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

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

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

  • URL:https://test.com/tos-vod-cn-v-03e4d54**112705/7b4d8bbc6****5e9b3ffbc3ab82fb06e~noop.image
  • 文件路径:7b4d8bbc6****5e9b3ffbc3ab82fb06e

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

说明

请确保您已在视频点播设置封面加速域名

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

  2. 单击左侧导航栏媒资管理 > 素材管理,进入素材管理页面。

  3. 切换至 Vid 模式或者 DirectUrl 模式页签,单击操作列的详情按钮。

  4. 在素材详情的图片预览下方,复制该图的文件路径

拼接处理图 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