文档

直播截图

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

前提条件

  • 视频直播截图功能需要将截图文件存放在媒体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提供查询截图信息的接口。更多详情,请参见查询截图内容

  • 本页导读 (1)