设置视频封面
最近更新时间：2024.05.11 17:38:27
首次发布时间：2021.02.23 10:42:39
视频封面是视频的重要组成部分，可更加清晰、直观地展示视频内容，帮助提升视频的点击率与用户体验。本文为您介绍设置视频封面的方法和操作步骤。
功能介绍
视频点播提供了多种设置视频封面的方法，详细说明如下表所示。
方法 | 说明 |
|---|---|
设置普通封面 | 通过抽取首张非黑帧、抽取指定时间点的帧、手动上传图片等方式设置视频封面。普通封面为静态图，支持 JPG 和 PNG 格式。 |
将截图结果设置为封面 | 截图结果中保存了视频的关键帧或关键片段。这些帧与片段是系统通过对视频的多模态理解生成的。可将以下类型的截图结果设置为视频封面：
|
使用智能封面候选 | 智能抽取多个关键帧作为封面候选（最多 8 张），然后从这些封面候选中选择一张作为视频封面。封面候选为静态图，格式为 JPG。 |
前提条件
方法一：设置普通封面
步骤一：生成普通封面
- 在点播控制台开启自动生成封面功能。
- 上传视频，系统自动从视频中抽取第一张非黑帧作为封面。
说明
系统支持在指定时间点进行截图。您可以在上传时指定抽取时间点
SnapshotTime，配置方法参见媒资上传概述。
3.（可选）如果未选择自动生成封面或需要修改封面，请在视频上传完成后，进入视频详情页，手动上传或更新封面图。
步骤二：获取封面图 URL
通过以下 2 种方式获取封面图 URL：
- 调用获取播放地址，从返回参数
PosterUrl中获取到封面图 URL。 - 先通过以下 3 种方式获取封面的
PosterUri，再基于封面图 URL 拼接规则得到封面图 URL。- 上传成功后，在返回结果中获取封面的
PosterUri。 - 在上传完成的回调中获取
PosterUri，详情参见媒资上传完成事件和 URL 批量拉取上传完成事件。 - 通过查询媒资信息获取
PosterUri。
- 上传成功后，在返回结果中获取封面的
方法二：将截图结果设置为封面
步骤一：生成截图结果
在点播控制台通过以下 3 种方式生成截图结果：
步骤二：获取截图 StoreUri
工作流执行完成后，在回调中获取图片的 StoreUri。详情参见工作流执行完成事件。
步骤三：将截图结果设置为封面
调用修改媒资信息将截图设置为视频封面。您需要在请求参数 PosterUri 中，传入在步骤二中获取到的 StoreUri 的值。
步骤四：获取封面图 URL
通过以下 2 种方式获取封面图 URL：
- 调用获取播放地址，从返回参数
PosterUrl中获取到封面图 URL。 - 基于封面的
PosterUri，参考封面图 URL 拼接规则得到封面图 URL。
方法三：使用智能封面候选
步骤一：生成封面候选
步骤二：选择一张设为封面
通过以下 2 种方式从封面候选中选择一张设为封面：
- 进入控制台的视频详情页，从封面候选中选择一张作为视频封面，并保存更改。
- 调用获取封面候选结果，获取某一封面候选的
StoreUri，再调用修改媒资信息，在请求参数PosterUri中，传入获取到的封面候选StoreUri的值。
步骤三：获取封面图 URL
通过以下 2 种方式获取封面图 URL：
拼接封面图 URL
获取 PosterUri 或 StoreUri 后，您可以自行拼接封面图 URL。
拼接规则
封面图 URL 的拼接规则如下。
{协议}://{封面图域名}/{PosterUri 或 StoreUri}~{封面图处理模板}.{图片格式}
拼接封面图 URL所需的参数说明如下表所示。
参数 | 说明 |
|---|---|
协议 | |
封面图域名 | 即您在视频点播控制台空间管理-分发加速设置中添加的封面图域名。 |
PosterUri 或 StoreUri |
|
封面图处理模板 | 支持以下封面图处理模板：
说明 查看封面图处理模板示例。 |
图片格式 | 支持以下图片格式：
|
拼接示例
例如，在视频截图中选择一张静态图作为封面图。假设：
- 封面图域名使用 HTTP 协议
- 封面图域名为 vod.demo.com
- 获取到的截图
StoreUri值为tos-path-v-da1111/123456abcdef123456abcdef12345*** - 对截图进行居中剪裁，宽高比为 720:480，则封面图处理模板为
tplv-vod-cc:720:480 - 封面保留截图的原格式
拼接后的封面图 URL 如下：
http://vod.demo.com/tos-path-v-da1111/123456abcdef123456abcdef12345***~tplv-vod-cc:720:480.image
封面图处理模板示例
假设原图的宽高为 640×360，如下图所示：
设置为不同的封面图处理模板后，效果如下：
- 封面图处理模板设为
tplv-vod-rs:540:180时，输出图片的宽高为 320×180，效果如下图所示： - 封面图处理模板设为
tplv-vod-cc:540:180时，输出图片的宽高为 540×180，效果如下图所示： - 封面图处理模板设为
tplv-vod-cs:360:180时，输出图片的宽高为 360×180，效果如下图所示：