直播截图

视频直播截图功能需要将截图文件存放在媒体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添加截图配置的示例代码：

  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使用说明。

视频截图管理

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

• 您可以在视频直播控制台和OSS控制台中查看截图文件。截图文件存储在OSS的Bucket中，可以通过OSS Bucket管理视频截图。更多详情，请参见截图管理。

  说明

  您只有在OSS控制台才能删除截图。

• API和SDK提供查询截图信息的接口。更多详情，请参见查询截图内容。