更新时间：2024-10-10 GMT+08:00
自定义视频封面
环境准备
已下载SDK。
场景说明
随着视频点播存储视频文件量的增加，设置视频封面不仅能提升展示的美观性，还能方便通过封面查找相关视频。同时，上传的视频封面也将会生成对应的封面地址，实现加速分发，可以直接将封面与视频文件一同引用到网页中。
上传视频时，点播服务会默认截取视频的第一帧作为封面图片。您也可以通过上传图片或截图封面来更新视频的封面。
- 上传封面：适用于需要通过封面表达视频的大概内容及重点的场景。在上传前，您需要提前线下设计一张JPG或PNG格式的封面图片。
- 截图封面：适用于希望将视频中的某个瞬间画面来设置成封面的场景。无需要额外准备工作，您可以直接使用视频点播的截图功能生成。
您可以通过以下方式自定义视频封面：
控制台设置视频封面
在视频点播控制台的音视频管理中上传封面图片。
- 暂只支持对视频格式为FLV、MP4、TS、MOV、MXF、MPG、WMV、AVI、M4V、F4V、MPEG、ASF、MKV、3GP、WEBM、VOB、RM、MTS的视频文件进行截图。
- 暂只支持截图生成JPG格式的图片文件。
- 登录视频点播控制台。
- 在左侧导航栏中，选择“音视频管理”，进入音视频管理页面。
- 在需要上传封面的视频行单击“管理”，在“基本信息”页签单击“编辑”。
- 单击添加框，上传本地的封面图片，上传完成后单击“保存”即可。
在视频点播控制台的“视频处理 > 视频截图”中设置封面图片。
- 登录视频点播控制台。
- 在左侧导航栏中，选择“视频处理 > 视频截图”，进入视频截图页面。
- 勾选需要截图的视频，单击“截图”，在弹出的截图设置框中设置截图参数。
图1 截图设置
- 按时间间隔：根据设置的时间间隔，从视频首帧开始截图，以最后一帧截图结束，最大间隔不能超过12秒。可选择是否将首帧截图作为视频封面。
- 指定时间点：根据设置指定时间从视频中截取图片，最多可设置10个时间点。可选择是否将某张截图作为视频封面。
- 单击“确定”，视频开始截图。
- 截图完成后，单击“详情”，可以在详情页面中选择某一张截图作为封面。
调用API设置视频封面
视频点播API支持通过媒资上传、视频更新、视频处理三种方式设置视频的封面图片。
- 视频上传时设置封面
视频点播提供了上传、OBS转存、URL拉取三种创建媒资的方式，其中上传方式创建媒资支持上传或截图封面，其它二种方式仅支持截图封面。具体如下所示：
- 上传方式创建媒资
上传封面：调用创建媒资：上传方式接口，在请求参数中设置“cover_type”，即上传封面的图片类型，然后在请求的返回参数中获取“cover_upload_url”，通过“cover_upload_url”上传封面图片即可。
截图封面：调用创建媒资：上传方式接口，在请求参数中设置“thumbnail”，设置截图类型，指定某张截图作为封面。
- OBS转存和URL拉取方式创建媒资
分别调用创建媒资：OBS转存方式口或创建媒资：URL拉取注入接口，在请求参数中设置“thumbnail”，设置截图类型，指定某张截图作为封面。
- 上传方式创建媒资
- 视频更新时设置封面
调用视频更新接口，在请求参数中设置“cover_type”，即上传封面的图片类型，然后在请求的返回参数中获取“cover_upload_url”，通过“cover_upload_url”上传封面图片即可。
- 视频处理时设置封面
调用视频处理接口生成截图，然后指定某张截图作为封面。若您需要在已生成的截图中更换封面，则可以先调用查询媒资详细信息接口，获取该视频的截图URL，然后调用设置封面接口修改截图封面。
