直播截图提供实时截图功能,满足您在观看直播同时的截图需求。本文详细为您介绍视频直播截图功能。

前提条件

  • 视频直播截图功能需要将截图文件存放在媒体Bucket中,因此需要开通OSS服务并且将Bucket设置为媒体Bucket。更多详情,请参见开通OSS服务媒体 Bucket 的增删改操作
  • 配置截图模版后,需要重新推流才生效;新配置的截图模版对正在进行的直播流不生效。

直播截图规则

  • 直播截图是针对推流的AppName为粒度设置的。您可以设置某个AppName下的所有StreamName的截图规则。当AppName取值为星号(*)时 ,表示此截图规则适用于该直播域名下的所有推流。推流的AppName需要和配置的AppName相同。
  • 直播截图功能配置时,ObjectName可以定义为覆盖截图和实时截图两种类型。
    • 覆盖截图是每次新生成截图覆盖之前生成的截图文件。
    • 实时截图是每次新生成的截图不覆盖之前生成的截图文件,截图递增存储。截图文件使用{Sequence}区分,{Sequence}通过1,2,……,n的方式表示。
    • 目前直播截图仅支持生成JPG格式。
  • 使用API和SDK配置截图时,OverwriteOssObject参数和SequenceOssObject参数必须配置其中之一,暂无默认值设置。

直播截图功能介绍

  • 视频截图功能配置

    配置视频直播截图功能可以通过以下两种方法:

    • 通过控制台配置。具体操作,请参见配置截图

    • 通过API和SDK配置。API和SDK提供了以下截图配置接口: 以下为Java SDK添加截图配置的示例代码:
          IClientProfile profile = DefaultProfile.getProfile("cn-shanghai","<AccessKeyId>", "<AccessKeySecret>");
          IAcsClient client = new DefaultAcsClient(profile);
          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();
          }                  
  • 视频截图管理

    截图配置完成后通过新发起的推流生成截图,查看截图的方法包括以下两种:

    • 您可以在视频直播控制台OSS控制台中查看截图文件。截图文件存储在OSS的Bucket中,可以通过OSS Bucket管理视频截图。更多详情,请参见截图管理
      说明 您只有在OSS控制台才能删除截图。
    • API和SDK提供查询截图信息的接口。更多详情,请参见查询截图内容