封面图和封面候选
最近更新时间：2023.05.31 11:29:57
首次发布时间：2021.02.23 10:42:39
视频封面是视频的重要组成部分。在缩略图模式下，视频封面可以更加清晰、直观地展示视频。
功能介绍
视频点播提供了多种设置和修改视频封面的方法，帮助提升视频的点击率与用户体验。
- 支持自动生成普通封面和智能候选封面；
- 支持将关键帧和关键片段设置为智能封面。
背景信息
本章介绍 3 种设置视频封面的方式，详细说明如下表所示。
| 方式 | 说明 |
|---|---|
| 设置普通封面 | 通过抽取首张非黑帧、抽取指定时间点的帧、手动上传图片等方式生成视频封面。普通封面为静态图，支持 JPG 和 PNG 格式 |
将截图结果配置为智能封面 | 截图结果中保存了视频的关键帧或关键片段。这些帧与片段是系统通过对视频的多模态理解生成的。将这些截图作为视频封面，可以提升视频点击率及用户体验。可获取的截图类型如下。
|
| 使用智能候选封面 | 智能抽取多个关键帧作为候选封面，最多支持生成 8 张候选封面。您可从智能候选封面中选择一张作为视频截图。 候选封面为静态图，默认图片格式为 JPG。 |
前提条件
类型一：设置普通封面
操作流程
操作步骤
Step 1：生成普通封面
说明
系统支持在指定时间点进行截图。您可以在上传时指定抽取时间点 SnapshotTime，配置方法参见媒资上传概述。
- （可选）如果未选择自动生成封面或需要修改封面，请在视频上传完成后，进入视频详情页，手动上传或更新封面图。
Step 2：获取封面 PosterUri 或 PosterUrl
视频点播支持通过以下 3 种方式获取封面的 PosterUri 或 PosterUrl。
- 上传成功后，在返回结果中获取封面的
PosterUri； - 在上传完成的回调中获取
PosterUri，详情参见媒资上传完成事件和 URL 批量拉取上传完成； - 通过 OpenAPI/服务端 SDK 获取
PosterUri/PosterUrl，详情参见查询媒资信息或获取播放地址。
Step 3：使用封面
- 如已获取封面图的
PosterUrl，可直接使用PosterUrl； - 如仅获取封面图的
PosterUri，请参考封面图 URL 拼接，完成 URL 拼接。
类型二：将截图结果配置为智能封面
操作流程
操作步骤
Step 1：生成截图结果
点播控制台支持通过 3 种方式生成截图结果。
Step 2：获取截图 StoreUri 或 StoreUrl
视频点播支持通过以下 2 种方式获取截图的StoreUri或StoreUrl。
Step 3：将截图配置为封面
参考修改媒资信息完成封面图设置。
- 如果在 Step 2 中获取了截图的
StoreUrl，请将视频PosterUrl的值修改为StoreUrl的值； - 如果在 Step 2 中获取了截图的
StoreUri，请将视频PosterUri的值修改为StoreUri的值；
Step 4：使用封面
- 如果配置了封面的
PosterUrl，可直接使用PosterUrl； - 如果配置了封面的
PosterUri，请参考封面图 URL 拼接，完成 URL 的拼接。
类型三：使用智能候选封面
操作流程
操作步骤
Step 1：生成候选封面
Step 2：选择一张设为封面
支持 2 种从候选封面中选择视频封面的方法。
- 进入控制台的视频详情页，从封面候选中选择一张作为视频封面，并保存更改。
- 在候选封面中选中一张，参考获取封面候选结果，获取该候选封面的
StoreUri；再参考修改媒资信息将视频的PosterUri的值修改为候选封面StoreUri的值。
Step 3：获取封面 PosterUri 或 PosterUrl
如封面的PosterUri和PosterUrl均未获取，请通过 OpenAPI/服务端 SDK 获取 ，详情参见查询媒资信息或获取播放地址。
Step 4：使用封面
- 如已获取封面图的
PosterUrl，可直接使用PosterUrl； - 如仅获取封面图的
PosterUri，请参考封面图 URL 拼接，完成 URL 拼接。
参考信息
手动拼接封面图 URL
- 获取 PosterUri 或 StoreUri。
- 拼接封面图 URL。封面图 URL 的拼接规则如下。
{协议}://{封面图域名}/{PosterUri或StoreUri}~{封面图处理模版}.{图片格式}
拼接 URL 所需的参数说明如下表所示。
| 参数 | 说明 |
|---|---|
| 协议 | 支持 http 和 https 协议。 注意 若使用 https 协议，您需要给封面图域名开启 HTTPS，并配置证书。 |
| 封面图域名 | 封面图域名为您在视频点播控制台空间管理-分发加速设置中，添加的封面图域名。 |
| PosterUri 或 StoreUri |
|
| 封面图处理模板 | 支持 5 种封面图处理模版。
|
| 图片格式 | 支持以下 3 种图片格式。
|
拼接示例
例如，在视频截图中选择一张静态图作为封面图。
- 封面图域名使用 http 协议；
- 封面图域名为 vod.demo.com；
- 查询到的截图 StoreUri 值为 tos-path-v-da1111/123456abcdef123456abcdef12345***；
- 对封面图进行居中剪裁，宽高比为 720:480，则封面图处理模版为 tplv-vod-cc:720:480；
- 封面保留截图的源格式。
则拼接后的封面图 URL 如下。
https://vod.demo.com/tos-path-v-da1111/123456abcdef123456abcdef12345***~tplv-vod-cc:720:480.image