圖片和 Dynamic Ingest API

簡介

您可以通過兩種不同的方式使用 Dynamic Ingest API:

• 在轉碼過程中在視頻的中點捕獲圖像
• 在攝取視頻的同時或單獨攝取圖像

格局

無論您要攝取視頻，圖像，WebVTT文件還是所有這些，動態攝取請求的設置都是相同的：

要求網址

    https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests

認證

身份驗證需要以 Bearer 令牌中 Authorization 標頭：

    Authorization: Bearer {access_token}

關於S3的注意事項

如果您的圖片是從受保護的S3存儲桶中提取的，則需要設置存儲桶策略以允許 Video Cloud 訪問文件。 看到 在S3上使用動態攝取 有關詳細信息。

拍攝影像

在轉碼過程中， Video Cloud 可以從視頻的中點捕獲快照，並將其另存為海報（視頻靜止圖像）和縮略圖。

對於自定義再現，圖像捕獲要求將兩個特殊的再現添加到您正在使用的攝取配置文件中。 新的演繹必須具有以下屬性：

以下是這兩種格式的樣本數據：

    {
      "media_type": "image",
      "format": "jpg",
      "label": "poster",
      "width": 1280,
      "height": 720
    },
    {
      "media_type": "image",
      "format": "jpg",
      "label": "thumbnail",
      "width": 160,
      "height": 90
    }

您還應該設置 capture-images 在您的請求數據中標記為 true，但這是默認值 if 所選配置文件包括圖像副本。 （如果配置文件中沒有圖像副本，則默認為 capture-images is false.)

樣品請求數據：

    {
      "master": { "url": "http://learning-services-media.brightcove.com/videos/mp4/Bird_Titmouse.mp4" },
      "profile": "multi-platform-standard-static",
      "capture-images": true
    }

提取視頻後添加圖像的樣本請求數據

    {
        "profile": "multi-platform-standard-static",
        "thumbnail": {
            "url": "http://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-thumbnail.png",
            "width": 160,
            "height": 90
        },
        "poster": {
            "url": "http://bcls@solutions.brightcove.com/bcls/assets/images/great-blue-heron-poster.png",
            "width": 1280,
            "height": 720
        }
    }

攝取圖像

您還可以通過在用於動態提取請求正文的JSON中引用它們的URL，為視頻添加自定義海報和縮略圖（或添加它們）：

    {
        "poster": {
            "url": "http://learning-services-media.brightcove.com/images/for_video/Water-In-Motion-poster.png",
            "width": 1280,
            "height": 720
        },
        "thumbnail": {
            "url": "http://learning-services-media.brightcove.com/images/for_video/Water-In-Motion-thumbnail.png",
            "width": 160,
            "height": 90
        }
    }

自動調整大小

當您通過Studio或Google+添加自定義海報和/或縮略圖時 Dynamic Ingest API， 默認 Video Cloud 將調整這些圖片的大小，以匹配該帳戶的默認“攝取配置文件”中定義的圖片大小。

覆蓋自動調整大小

如果要覆蓋此行為並具有 Video Cloud 保留實際的圖像尺寸，請按照下列步驟操作：

1. 創建一個新的自定義攝取配置文件 您的帳戶（或修改現有的自定義配置文件）
2. 包括具有以下內容的帖子和縮略圖的圖像副本： 究竟 這些 width 以及 height 值：

       {
         "media_type": "image",
         "format": "jpg",
         "label": "poster",
         "width": 9999,
         "height": 9999
       },
       {
         "media_type": "image",
         "format": "jpg",
         "label": "thumbnail",
         "width": 9999,
         "height": 9999
       }

3. 將此設置為默認配置文件 如果您始終希望以原始尺寸保存圖像，請選擇該帳戶。

現在，當您通過Studio或Dynamic Ingest添加自定義圖像時，它們將具有源圖像的原始尺寸。

限制

• 提取系統不允許在同一視頻上同時進行作業。 因此，如果您在視頻被攝取或重新轉換時嘗試上載圖像，則圖像上載將失敗。