# 自定义视频封面
#### 环境准备
已[下载SDK](https://support.huaweicloud.com/ssdk-vod/vod_05_0074.html)。
#### 场景说明
随着视频点播存储视频文件量的增加，设置视频封面不仅能提升展示的美观性，还能方便通过封面查找相关视频。同时，上传的视频封面也将会生成对应的封面地址，实现加速分发，可以直接将封面与视频文件一同引用到网页中。
上传视频时，点播服务会默认截取视频第一秒的首帧作为封面图片。您也可以通过上传图片或截图封面来更新视频的封面。
- 上传封面：适用于需要通过封面表达视频的大概内容及重点的场景。在上传前，您需要提前线下设计一张JPG或PNG格式的封面图片。
- 截图封面：适用于希望将视频中的某个瞬间画面来设置成封面的场景。无需要额外准备工作，您可以直接使用视频点播的截图功能生成。
 
您可以通过以下方式自定义视频封面：
- [控制台设置视频封面]
- [调用API设置视频封面]
- [使用SDK设置视频封面]
 
 #### 控制台设置视频封面
用户可以在视频点播控制台的音视频管理中，上传封面图片，详细操作如下所示：
1. 登录[视频点播控制台](https://console.huaweicloud.com/vod2/#/vod/home)。
2. 在左侧导航栏中，选择"媒资管理 \> 音视频管理"，进入"音视频管理"页面。
3. 在需要上传封面的视频行单击"管理"，在"基本信息"页签，单击界面右侧的"编辑"。
4. 单击"封面"右侧的添加框，上传本地的封面图片，上传完成后单击"保存"即可。
 
用户也可以在视频点播控制台的"视频处理 \> 视频截图"中设置封面图片。
1. 登录[视频点播控制台](https://console.huaweicloud.com/vod2/#/vod/home)。
2. 在左侧导航栏中，选择"视频处理 \> 视频截图"，进入视频截图页面。
3. 勾选需要截图的视频，单击"截图"，在弹出的"截图设置"对话框中设置截图参数。
   - 按时间间隔截图：根据相同的时间间隔对视频截取多张图像，从视频首帧开始截图，以最后一帧截图结束，最大间隔不能超过12秒。
   
   - 指定时间点截图：指定一组时间点，截取视频在这组时间点的图像，一组最多可以设置10个时间点。
   
   - 指定数量截图：指定截图数量，会按照视频时长平均后截图。
   
   
   须知：
   - 暂只支持对视频格式为MP4、TS、MOV、MXF、FLV、MPG、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV、WEBM、RMVB、VOB、RM、MTS、DV、DAT、QT、M2T、SWF的视频文件进行截图。
   
   - 暂只支持截图生成JPG格式的图片文件。
    
   图1截图设置   
   ![](https://support.huaweicloud.com/bestpractice-vod/zh-cn_image_0000001567939806.png) 
4. 单击"确定"，视频开始截图。
5. 截图完成后，单击"详情"，可以在详情页面中选择某一张截图作为封面。
 
 #### 调用API设置视频封面
视频点播API支持通过媒资上传、视频更新、视频处理三种方式设置视频的封面图片。
- 视频上传时设置封面
  视频点播提供了上传、OBS转存、URL拉取三种创建媒资的方式，其中上传方式创建媒资支持上传或截图封面，其它二种方式仅支持截图封面。具体如下所示：
  - 上传方式创建媒资 **上传封面** ：调用[创建媒资：上传方式](https://support.huaweicloud.com/api-vod/vod_04_0196.html)接口，在请求参数中设置"cover_type"，即上传封面的图片类型，然后在请求的返回参数中获取"cover_upload_url"，通过"cover_upload_url"上传封面图片即可。
    **截图封面** ：调用[创建媒资：上传方式](https://support.huaweicloud.com/api-vod/vod_04_0196.html)接口，在请求参数中设置"thumbnail"，设置截图类型，指定某张截图作为封面。
    
  
  - OBS转存和URL拉取方式创建媒资 分别调用创建媒资：[OBS转存方式](https://support.huaweicloud.com/api-vod/vod_04_0201.html)口或[创建媒资：URL拉取注入](https://support.huaweicloud.com/api-vod/vod_04_0052.html)接口，在请求参数中设置"thumbnail"，设置截图类型，指定某张截图作为封面。
    
    
- 视频更新时设置封面 调用[视频更新](https://support.huaweicloud.com/api-vod/vod_04_0207.html)接口，在请求参数中设置"cover_type"，即上传封面的图片类型，然后在请求的返回参数中获取"cover_upload_url"，通过"cover_upload_url"上传封面图片即可。
  
- 视频处理时设置封面 调用[视频处理](https://support.huaweicloud.com/api-vod/vod_04_0206.html)接口生成截图，然后指定某张截图作为封面。若您需要在已生成的截图中更换封面，则可以先调用查询媒资详细信息接口，获取该视频的截图URL，然后调用[设置封面](https://support.huaweicloud.com/api-vod/vod_04_0209.html)接口修改截图封面。
  
 
 #### 使用SDK设置视频封面
视频点播提供的服务端SDK，对API接口进行了封装，您可以在[SDK中心](https://sdkcenter.developer.huaweicloud.com/zh-cn?product=VOD)下载对应SDK，然后进行集成开发。
- 视频上传时设置封面：服务端SDK提供了[本地上传](https://apiexplorer.developer.huaweicloud.com/apiexplorer/sdk?product=VOD&api=CreateAssetByFileUpload)、[OBS转存](https://apiexplorer.developer.huaweicloud.com/apiexplorer/sdk?product=VOD&api=PublishAssetFromObs)、[URL拉取](https://apiexplorer.developer.huaweicloud.com/apiexplorer/sdk?product=VOD&api=UploadMetaDataByUrl)三种媒资上传方法，可以在对应的方法中上传本地图片设置封面，或者截图设置封面。
- 视频更新时设置封面：[服务端SDK](https://apiexplorer.developer.huaweicloud.com/apiexplorer/sdk?product=VOD&api=UpdateAsset)支持在视频上传完成后，可以调用视频更新方法时上传本地图片，更新视频封面。
- 视频处理时设置封面：[服务端SDK](https://apiexplorer.developer.huaweicloud.com/apiexplorer/sdk?product=VOD&api=UpdateCoverByThumbnail)支持在视频上传完成后，可以调用音视频方法时设置截图参数，选择某张截图作为视频封面。