摘要：常見問題直播截圖是針對于推流的為粒度設置的，用戶可以設置某個下的所有的截圖規則。

摘要： 使用場景 用戶常需要對視頻直播的內容進行分析。例如，需要對直播中的某一幀的內容作為封面圖片或者對于直播內容進行鑒黃以查看內容合法性等需求。因此，視頻直播提供了實時截圖功能滿足用戶的截圖需求。 截圖功能介紹 截圖功能配置 配置視頻直播的截圖功能可以通過兩種方法： 通過控制臺創建：詳情參考 控制臺配置截圖。

使用場景

用戶常需要對視頻直播的內容進行分析。例如，需要對直播中的某一幀的內容作為封面圖片或者對于直播內容進行鑒黃以查看內容合法性等需求。因此，視頻直播提供了實時截圖功能滿足用戶的截圖需求。

截圖功能介紹

截圖功能配置

配置視頻直播的截圖功能可以通過兩種方法：

通過控制臺創建：詳情參考 控制臺配置截圖。

通過API/SDK：API/SDK提供了添加、刪除、查詢和更新截圖配置的接口，詳情分別參考 添加截圖配置、刪除截圖配置、查詢截圖配置、更新截圖配置。下面提供使用Java SDK添加截圖配置的示例代碼。

IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou","", "");
      IAcsClient client = new DefaultAcsClient(profile);
      AddLiveAppSnapshotConfigRequest addLiveAppSnapshotConfigRequest = new AddLiveAppSnapshotConfigRequest();
      addLiveAppSnapshotConfigRequest.setDomainName("");
      addLiveAppSnapshotConfigRequest.setAppName("");
      addLiveAppSnapshotConfigRequest.setTimeInterval(5);
      addLiveAppSnapshotConfigRequest.setOssEndpoint("");
      addLiveAppSnapshotConfigRequest.setOssBucket("");
      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元體驗包，配置清單如下：

點擊了解活動詳情

閱讀更多干貨好文，請關注掃描以下二維碼：