直播截图提供实时截图功能,满足您在观看直播同时的截图需求。本文详细为您介绍视频直播截图功能。
前提条件
视频直播截图功能需要将截图文件存放在媒体Bucket中,因此需要开通OSS服务并且将Bucket设置为媒体Bucket。更多详情,请参见开通OSS服务和添加媒体Bucket。
配置截图模板后,需要重新推流才生效;新配置的截图模板对正在进行的直播流不生效。
直播截图规则
直播截图是针对推流的
AppName
为粒度设置的。您可以设置某个AppName
下的所有StreamName
的截图规则。当AppName
取值为星号(*)时 ,表示此截图规则适用于该直播域名下的所有推流。推流的AppName
需要和配置的AppName
相同。直播截图功能配置时,ObjectName可以定义为覆盖截图和实时截图两种类型。
覆盖截图是每次新生成截图覆盖之前生成的截图文件。
实时截图是每次新生成的截图不覆盖之前生成的截图文件,截图递增存储。截图文件使用
{Sequence}
区分,{Sequence}
通过1,2,……,n的方式表示。目前直播截图仅支持生成JPG格式。
使用API和SDK配置截图时,
OverwriteOssObject
参数和SequenceOssObject
参数必须配置其中之一,暂无默认值设置。
直播截图功能介绍
视频截图功能配置
配置视频直播截图功能可以通过以下两种方法:
通过控制台配置。具体操作,请参见配置截图。
AddLiveAppSnapshotConfigRequest addLiveAppSnapshotConfigRequest = new AddLiveAppSnapshotConfigRequest(); addLiveAppSnapshotConfigRequest.setDomainName("<DomainName>"); addLiveAppSnapshotConfigRequest.setAppName("<AppName>"); addLiveAppSnapshotConfigRequest.setTimeInterval(5); addLiveAppSnapshotConfigRequest.setOssEndpoint("<Endpoint>"); addLiveAppSnapshotConfigRequest.setOssBucket("<BucketName>"); addLiveAppSnapshotConfigRequest.setOverwriteOssObject("{AppName}/{StreamName}.jpg"); try { AddLiveAppSnapshotConfigResponse addLiveAppSnapshotConfigResponse = client.getAcsResponse(addLiveAppSnapshotConfigRequest); System.out.println(addLiveAppSnapshotConfigResponse.getRequestId()); // todo something. } catch (ServerException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (ClientException e) { // TODO Auto-generated catch block e.printStackTrace(); }
说明使用Java SDK,具体请参见Java SDK使用说明。
视频截图管理
截图配置完成后通过新发起的推流生成截图,查看截图的方法包括以下两种:
反馈
- 本页导读 (1)
文档反馈