视频点播提供强大的图片管理与实时处理能力。无论是您直接上传的图片（如水印、海报），还是系统生成的视频截图，均支持通过简单的 URL 拼接实现缩放、裁剪、格式转换等动态处理。此外，您可以灵活地将这些图片设置为视频的封面。

准备图片素材 #

在处理图片前，您需要先将图片存储在视频点播服务中，并获取其唯一的存储标识：StoreUri 或 PosterUri。

• 手动上传图片：​适用于准备封面海报、水印贴片或剪辑素材。您可以通过控制台、客户端上传 SDK、视频点播服务端 SDK 等方式，上传 JPG、PNG 等格式的图片。上传完成后，您会收到包含图片素材 StoreUri 的素材上传完成事件通知，并且可通过控制台指定空间内的素材管理页面管理图片素材。具体请参考媒资上传概述。
• 生成视频截图：​适用于从视频中自动提取精彩画面。您可以在工作流中使用截图模板，从视频中生成截图。每张截图的 StoreUri 都可以在工作流执行结果中获取。具体请参考获取工作流执行状态和结果。
• 自动生成封面：​您可以通过配置空间设置，系统自动提取已上传视频中的首张非黑帧（黑帧标准：黑色元素占比超 80%）作为封面。系统在过程中自动生成一个图片素材，并将其 PosterUri 与视频的元数据相关联。具体请参考步骤 2：获取封面图 URL。

手动拼接图片 URL 并实时处理图片 #

视频点播支持“地址即处理”模式。您只需在图片 URL 后附加处理指令，CDN 边缘节点即可实时完成处理并返回。

前提条件 #

在拼接图片 URL 前，需要满足以下条件：

1. 已存储图片素材至视频点播服务；
2. 已获取图片的 StoreUri 或 PosterUri；
3. 已在视频点播控制台添加封面加速域名。

拼接规则 #

图片 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，效果如下图所示：
  

业务应用：设置视频封面 #

您可以根据业务需求，通过自动或手动方式为视频指定官方封面（Poster）。

方法 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。