直播截图提供实时截图功能，满足您在观看直播同时的截图需求。本文详细为您介绍视频直播截图功能。
前提条件
直播截图功能需要将截图文件存放在Bucket中，因此需要开通OSS服务并且拥有至少一个Bucket用于存储这些截图文件。更多详情，请参见开通OSS服务和创建存储空间。
Bucket必须与播流域名的直播中心同地域，不支持跨地域截图。
直播截图规则
直播截图是针对推流的
AppName为粒度设置的。您可以设置某个AppName下所有推流的截图规则。说明如果设置
AppName为星号（*），则表示截图规则适用于该直播域名下的所有推流。直播截图功能配置时，可以定义覆盖截图和实时截图两种类型。
覆盖截图是每次新生成截图覆盖之前生成的截图文件。
实时截图是每次新生成的截图不覆盖之前生成的截图文件，截图递增存储。
目前直播截图仅支持生成JPG格式。
说明两种类型可同时设置，且必须设置其中之一。
直播截图功能介绍
新配置的截图模板对正在进行的直播流不生效，需要重新推流才生效。
视频截图功能配置
配置视频直播截图功能可以通过以下两种方法：
登录视频直播控制台。
在左侧导航栏选择功能管理> 直播截图，进入直播截图页面，选择截图配置页签。
选择待配置的播流域名。
单击添加。
配置截图模板。
截图模板参数及说明如下表所示。
参数
描述
AppName
视频的应用名称，输入的AppName必须与直播推流的AppName保持一致，方可生效。如果您想要进行域名级别截图配置，输入星号（*）即可。
截图频率
截图频率，单位：秒，取值范围：5~3600。
存储位置
选择截图文件在OSS上的存储位置。
OSS Bucket必须与播流域名的直播中心同地域，不支持跨地域截图。
存储方式
存储方式分两种类型，支持复选。
覆盖截图：视频截图按照截图频率依次截图，新截取的图片覆盖上一张旧图。
实时截图：视频截图按照截图频率依次截图，新图片按照N+1（N≥0）的顺序依次存储在OSS中。
说明复选时，会同时以两种方式进行截图。
说明配置完成后该域名下所有AppName（设置好的AppName），都会按照设置好的模板配置进行截图并存储。
截图设置修改后，会在下次推流后生效。
单击确定。
截图文件管理
查看截图文件
您可以通过三种方式查看截图文件。
登录视频直播控制台。
在左侧导航栏选择功能管理> 直播截图，进入直播截图页面，选择截图管理。
选择待查询的域名及时间，然后输入或选择AppName和StreamName。
单击查询，查看选择时间段内的截图。若截图无法查看，请确定OSS Bucket读写权限是否为公共读，具体操作，请参见配置OSS bucket读写权限。
将鼠标移动到某一图片上方，可以查看大图或复制截图的流地址。
删除截图文件
视频直播储存的是截图文件信息，如AppName，StreamName，OSS文件储存路径等，文件是储存在OSS中。如果在删除截图时需要同步删除储存在OSS中的文件，则需要创建服务角色AliyunMTSVideoLifecycleRole，并精确授权AliyunMTSVideoLifecycleRolePolicy系统策略。
在直播控制台删除截图或录制文件时需要先进行授权，您需要按照如下步骤在RAM控制台创建并授权RAM角色后，再登录直播控制台删除截图或录制文件。
创建普通服务角色
使用RAM管理员登录RAM控制台。
在左侧导航栏，选择。
在角色页面，单击创建角色。
在创建角色页面，选择信任主体类型为云服务，然后选择具体的阿里云服务，最后单击确定。
说明信任主体名称下拉框中请选择“媒体处理”。
在弹出的创建角色对话框，角色名称栏中输入“AliyunMTSVideoLifecycleRole”作为角色名称，然后单击确定。
角色创建成功后，在角色基本信息页面下选择权限管理页签。
点击精确授权，请按照以下参数配置：
选择权限类型：系统策略
输入策略名称：AliyunMTSVideoLifecycleRolePolicy
配置完成后，单击确定。
您可以通过三种方式删除截图文件：
相关文档
使用Java SDK，请参见Java SDK使用说明。
更多直播截图API，可参见直播截图相关API。