視頻直播常見問題與解決辦法彙總【系列二—直播截圖】

時間 2019-11-12

原文原文鏈接

摘要： 使用場景用戶常須要對視頻直播的內容進行分析。例如，須要對直播中的某一幀的內容做爲封面圖片或者對於直播內容進行鑑黃以查看內容合法性等需求。所以，視頻直播提供了實時截圖功能知足用戶的截圖需求。截圖功能介紹截圖功能配置配置視頻直播的截圖功能能夠經過兩種方法：經過控制檯建立：詳情參考控制檯配置截圖。html

使用場景

用戶常須要對視頻直播的內容進行分析。例如，須要對直播中的某一幀的內容做爲封面圖片或者對於直播內容進行鑑黃以查看內容合法性等需求。所以，視頻直播提供了實時截圖功能知足用戶的截圖需求。spa

截圖功能介紹

截圖功能配置

配置視頻直播的截圖功能能夠經過兩種方法：code

經過控制檯建立：詳情參考控制檯配置截圖。
經過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();
      }

查看截圖文件

上述截圖配置完成後新發起的推流便可生成截圖，查看截圖的方法包括如下三種：視頻

OSS控制檯提供截圖管理功能，詳情參考截圖管理。
API/SDK提供了查詢截圖信息的接口，詳情參考查詢截圖信息。
在知曉截圖錄制地址時能夠直接在該媒體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參數必須兩者選一進行配置，暫時沒有默認值設置。