视频封面是视频的重要组成部分，可更加清晰、直观地展示视频内容，帮助提升视频的点击率与用户体验。本文为您介绍设置视频封面的方法和操作步骤。

功能介绍

视频点播提供了多种设置视频封面的方法，详细说明如下表所示。

前提条件

在视频点播控制台添加封面加速域名，详见添加域名。

方法 1：上传后自动生成普通封面

步骤 1：生成普通封面

1. 参考以下步骤在视频点播控制台开启自动生成封面：
   1. 登录视频点播控制台，进入指定空间。
   2. 单击左侧导航栏系统设置 > 上传存储设置。
   3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
   4. 开启自动生成封面开关。
   5. （可选）单击高级设置按钮，开启自定义文件路径开关。您可以输入固定字符串和变量来自定义生成的封面图文件路径。详情规则请参见自定义媒体处理输出文件路径。

      说明

      • 不支持以 /、\ 开头。
      • 不支持连续 /、空格、+ 等特殊字符。
      • 不支持 {{count}} 变量。
   6. 单击确定按钮。
2. 上传视频：通过控制台、客户端上传 SDK、视频点播服务端 SDK 等方式将待处理的短剧视频上传至视频点播服务。具体介绍和操作步骤请见媒资上传概述。视频上传成功时，系统自动选取首张非黑帧（黑帧标准：黑色元素占比超 80%）作为封面。

   说明

   系统也支持在指定时间点进行截图。您可以在上传时指定抽取时间点 SnapshotTime，配置方法参见媒资上传概述。

3. （可选）如果需要修改封面，可在视频上传完成后，手动上传或更新封面图：
   1. 登录视频点播控制台，进入指定空间。
   2. 在视频管理页面，单击目标视频操作列的详情按钮，进入视频详情页面。
   3. 在基础信息页签下，单击上传封面图，将您本地的图片上传至视频点播服务作为该视频的封面。
   4. 单击保存。

步骤 2：获取封面图 URL

通过以下两种方式获取封面图 URL：

• 调用 GetPlayInfo - 获取播放地址，直接从返回参数 PosterUrl 中获取到封面图 URL。
• 先通过以下 3 种方式获取封面的 PosterUri，再基于封面图 URL 拼接规则得到封面图 URL。
  • 上传成功后，在返回结果中获取封面的 PosterUri。
  • 在上传完成事件回调中获取 PosterUri。详情参见媒资上传完成事件和 URL 批量拉取上传完成事件。
  • 调用 GetMediaInfos - 获取媒资信息获取 PosterUri。

方法 2：将截图结果设置为封面

步骤 1：生成截图结果

在视频点播控制台通过以下 3 种方式生成截图结果：

• 设置自动触发默认工作流。
• 上传视频时选择工作流。
• 上传后触发媒体处理任务。

步骤 2：获取截图 StoreUri

工作流执行完成后，在回调中获取图片的 StoreUri。详情请见工作流执行完成事件。

步骤 3：将截图结果设置为封面

调用 UpdateMediaInfo - 更新媒资信息将截图设置为视频封面。您需要在请求参数 PosterUri 中，传入在步骤 2 中获取到的 StoreUri 值。

步骤 4：获取封面图 URL

通过以下两种方式获取封面图 URL：

• OpenAPI/服务端 SDK 方式：调用 GetPlayInfo - 获取播放地址，从返回参数 PosterUrl 中获取到封面图 URL。
• 自行拼接：基于封面的 PosterUri，参考封面图 URL 拼接规则得到封面图 URL。

方法 3：使用智能封面候选

步骤 1：生成封面候选

1. 参考以下步骤在视频点播控制台开启自动生成封面候选：
   1. 登录视频点播控制台，进入指定空间。
   2. 单击左侧导航栏系统设置 > 上传存储设置。
   3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
   4. 开启自动生成候选封面开关。
   5. 单击确定按钮。
2. 上传视频：通过控制台、客户端上传 SDK、视频点播服务端 SDK 等方式将待处理的短剧视频上传至视频点播服务。具体介绍和操作步骤请见媒资上传概述。视频上传成功时，系统将对成功上传的视频智能抽取 8 个关键帧作为候选封面。

步骤 2：选择一张设为封面

通过以下两种方式从封面候选中选择一张设为封面：

• 控制台方式：
  1. 登录视频点播控制台，进入指定空间。
  2. 在视频管理页面，单击目标视频操作列的详情按钮，进入视频详情页面。
  3. 在基础信息页签下，查看封面候选并从中选择一张作为封面。
  4. 单击保存。
• OpenAPI/服务端 SDK 方式：
  1. 调用 GetRecommendedPoster - 获取封面候选结果，获取某一封面候选的 StoreUri。
  2. 调用 UpdateMediaInfo - 更新媒资信息，在请求参数 PosterUri 中，传入获取到的封面候选 StoreUri 的值。

步骤 3：获取封面图 URL

通过以下两种方式获取封面图 URL：

• OpenAPI/服务端 SDK 方式：调用 GetPlayInfo - 获取播放地址，从返回参数 PosterUrl 中获取到封面图 URL。
• 自行拼接：基于封面的 PosterUri，参考拼接封面图 URL得到封面图 URL。

参考信息

拼接封面图 URL

获取 PosterUri 或 StoreUri 后，您可以自行拼接封面图 URL。

拼接规则

封面图 URL 的拼接规则如下。

{协议}://{封面图域名}/{PosterUri 或 StoreUri}~{封面图处理模板}.{图片格式}

拼接封面图 URL所需的参数说明如下表所示。

拼接示例

例如，在视频截图中选择一张静态图作为封面图。假设：

• 封面图域名使用 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，效果如下图所示：