支持 聯繫支持 | 系統狀況 系統狀態
頁面內容

    圖片和 Dynamic Ingest API

    本主題說明如何捕獲或攝取視頻圖像。

    簡介

    您可以攝取六種類型的圖像以進行關聯 Video Cloud 視頻:

    海報
    海報圖像顯示在 Brightcove Player 在用戶播放視頻之前。 它通常是從視頻捕獲的幀,但不是必須的。
    縮略圖
    縮略圖圖像顯示在播放列表,結束屏幕等中。 它通常是從視頻捕獲的幀,但不是必須的。
    肖像
    通常在電話和其他設備上以縱向模式用作海報的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 聯絡一位教師
    廣場
    通常用作通道徽標或網格顯示的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 聯絡一位教師
    通常在手機和其他設備上以橫向模式用作海報的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 聯絡一位教師
    超寬
    通常在電視等超寬顯示器上用作海報的圖像。 需要 Brightcove Beacon。 規範的詳細信息在 聯絡一位教師

    產品規格

    下表提供了圖像規格。

    圖片詳情表
    類型 格式 長寬比(W / H) 最小寬度(像素)
    海報 jpg或png 搭配影片 沒有
    縮略圖 jpg或png 搭配影片 沒有
    肖像 jpg或png 0.6667(2x3) 500
    廣場 jpg或png 1.0(1x1) 500
    jpg或png 1.7778(16x9) 2000
    超寬 jpg或png 2.3333 21x9 2000

    您可以通過兩種方法將基本海報和縮略圖圖像添加到視頻中, 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上使用動態攝取 有關詳細信息。

    多語言變體

    您可以提供用於不同語言的圖像的不同版本。 這是由處理 Brightcove Beacon Brightcove Beacon 應用。 一般實施 Brightcove Player 當前需要定制開發。

    圖片的語言在 language 屬性將在下一部分中詳細介紹。

    攝取圖像

    以下是為視頻添加自定義圖像的詳細信息。

    請求正文中的圖像字段

    攝取請求主體中的圖像被指定為對像數組。 下表中詳細介紹了對象屬性。

    圖像對象屬性
    財產 產品描述 類型 需要的
    url 一個網址 Video Cloud 可以從中檢索圖像 是 https://mysite.com/videos/video123/images/poster.png
    language 圖片中來自子標籤的語言代碼 http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry (可以通過聯繫Brightcove支持為帳戶設置默認值) No
    variant 該圖像的類型: poster | thumbnail | portrait | square | wide | ultra-wide 是 wide
    height No 2160
    width No 3840
    {
          "images":[
            {
                "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/poster.jpg",
                "variant": "poster",
                "height": 1080,
                "width": 1920
            },
            {
                "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/thumbnail.jpg",
                "variant": "thumbnail",
                "height": 108,
                "width": 292
            },
            {
                "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/square.jpg",
                "language": "de",
                "variant": "square",
                "height": 570,
                "width": 570
            },
            {
                "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/wide.jpg",
                "language": "fr",
                "variant": "wide",
                "height": 1440,
                "width": 2560
            },
            {
                "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/portrait.jpg",
                "language": "es",
                "variant": "portrait",
                "height": 1200,
                "width": 800
            },
            {
                "url":"https://apis.support.brightcove.com/assets/images/dynamic-ingest/test-images/ultra-wide.jpg",
                "language": "hi",
                "variant": "ultra-wide",
                "height": 1646,
                "width": 3840
            }
          ]
        }

    自動調整大小

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

    請注意,調整大小和填充是唯一的修改 Video Cloud or Brightcove Beacon。 圖像永遠不會被裁剪。

    覆蓋自動調整大小

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

    1. 創建一個新的自定義攝取配置文件 您的帳戶(或修改現有的自定義配置文件)
    2. 包括具有以下內容的帖子和縮略圖的圖像副本: 究竟 這些 widthheight 值:
          {
            "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添加自定義圖像時,它們將具有源圖像的原始尺寸。

    拍攝影像

    在轉碼過程中, Video Cloud 可以從視頻中點捕獲快照並將其另存為海報和縮略圖。

    對於自定義攝取配置文件,圖像捕獲要求向您使用的攝取配置文件添加兩個特殊格式。 看到 提取配置文件中的圖像 聯絡一位教師

    您還應該設置 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
          }

    提取配置文件中的圖像

    以下是有關如何在提取配置文件中指定圖像再現的詳細信息。

    財產
    media_type “圖片”
    label “海報”或“縮略圖”(每個都需要翻譯)
    format “ png”或“ jpg”
    width 數量(像素)
    height 數量(像素)

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

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

    檢索圖像數據

    您可以使用 CMS API.

    CMS API 將以 GET 請求 https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id} 或者,如果您只想要圖像數據, https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/images

    無論哪種情況,響應中的圖像數據都將如下所示:

    {
      "thumbnail": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/160x90/20s629ms/match/image.jpg",
            "height": 90,
            "width": 160
          }
        ]
      },
      "poster": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/main/1280x720/20s629ms/match/image.jpg",
            "height": 720,
            "width": 1280
          }
        ]
      },
      "portrait.es": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/bac8717a-43db-4fa8-a6f0-189c80ee4c4e/800x1200/match/image.jpg",
            "height": 1200,
            "width": 800
          }
        ]
      },
      "thumbnail.en": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/0ce2da4d-ca36-469b-9024-0273d79feeeb/292x108/match/image.jpg",
            "height": 108,
            "width": 292
          }
        ]
      },
      "poster.en": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/a7cb150d-c84a-48e0-9469-5b4ce80fba53/1920x1080/match/image.jpg",
            "height": 1080,
            "width": 1920
          }
        ]
      },
      "square.de": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/22209955-e136-4f17-914c-e19ec4c58886/570x570/match/image.jpg",
            "height": 570,
            "width": 570
          }
        ]
      },
      "ultra-wide.hi": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/72fd489f-d978-44ba-8d04-1e33c7c36cef/3840x1646/match/image.jpg",
            "height": 1646,
            "width": 3840
          }
        ]
      },
      "wide.fr": {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
        "sources": [
          {
            "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/57838016001/ee705e97-3fb5-409c-99d8-703e9f57bd0a/4405a5d5-8b9e-4c2b-be71-cf4e2c153e87/2560x1440/match/image.jpg",
            "height": 1440,
            "width": 2560
          }
        ]
      }
    }

    限制

    • 提取系統不允許在同一視頻上同時進行作業。 因此,如果您在視頻被攝取或重新轉換時嘗試上載圖像,則圖像上載將失敗。
    • 目前,寬幅,方形,人像和超寬幅變體的圖像數據僅由 CMS API, by Playback API 視頻請求。

    頁面最後更新於12年2020月XNUMX日