视频直播常见问题与解决办法汇总【系列二—直播截图】

摘要： 使用场景 用户常须要对视频直播的内容进行分析。例如，须要对直播中的某一帧的内容做为封面图片或者对于直播内容进行鉴黄以查看内容合法性等需求。所以，视频直播提供了实时截图功能知足用户的截图需求。 截图功能介绍 截图功能配置 配置视频直播的截图功能能够经过两种方法： 经过控制台建立：详情参考 控制台配置截图。

使用场景

用户常须要对视频直播的内容进行分析。例如，须要对直播中的某一帧的内容做为封面图片或者对于直播内容进行鉴黄以查看内容合法性等需求。所以，视频直播提供了实时截图功能知足用户的截图需求。

截图功能介绍

截图功能配置

配置视频直播的截图功能能够经过两种方法：

经过控制台建立：详情参考 控制台配置截图。

经过API/SDK：API/SDK提供了添加、删除、查询和更新截图配置的接口，详情分别参考 添加截图配置、删除截图配置、查询截图配置、更新截图配置。下面提供使用Java SDK添加截图配置的示例代码。

IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou","<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();
      }

查看截图文件

上述截图配置完成后新发起的推流便可生成截图，查看截图的方法包括如下三种：

1.OSS控制台提供截图管理功能，详情参考 截图管理。 
2.API/SDK提供了查询截图信息的接口，详情参考 查询截图信息。 
3.在知晓截图录制地址时能够直接在该媒体Bucket的对应目录查看生成结果，请参考下图。

常见问题

直播截图是针对于推流的AppName为粒度设置的，用户能够设置某个AppName下的全部StreamName的截图规则。而且AppName支持“*”通配符，表示该截图规则是针对于该直播域名下的全部推流均生效的，截图生效须要注意推流的AppName须要与配置的AppName匹配。

与直播录制功能相似，截图功能也须要将截图结果存放在媒体Bucket中。所以，截图功能也须要开通OSS服务，而且在媒体Bucket中设置输入媒体Bucket，详情参考 媒体Bucket的增删改操做。

配置截图功能时，ObjectName能够定义为覆盖和非覆盖两种类型，其中覆盖是按照截图频率每次新生成的截图将覆盖以前生成的截图文件，所以仅会获得一张截图文件；而不覆盖则是每次新产生的截图将不覆盖以前生成的截图文件，各截图文件使用{Sequence}区分，{Sequence}将经过1，2，……，n的方式表示。

使用API/SDK配置截图配置是须要输入OSS的Endpoint，OSS的Endpoint为不包括Bucket名称的OSS访问地址，详情参考 OSS Endpoint设置，而且这里请不要加http:// 或者 https:// 协议头。 
使用API/SDK配置截图时OverwriteOssObject参数和SequenceOssObject参数必须两者选一进行配置，暂时没有默认值设置。

0.1元开启直播之旅

开年采购季，为了让更多用户可以体验和享受到视频直播云服务的便利，视频产品推出了0.1元体验包，配置清单以下： 

点击了解活动详情

阅读更多干货好文，请关注扫描如下二维码：