サポート サポート問い合わせ先 | システムステータス システムステータス

画像と Dynamic Ingest API

このトピックでは、ビデオの画像をキャプチャまたは取り込む方法について説明します。

概要

関連付けるXNUMX種類の画像を取り込むことができます 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

を使用してビデオに基本的なポスターとサムネイル画像を追加するには、XNUMXつの異なる方法があります。 Dynamic Ingest API:

  • 画像をキャプチャする トランスコーディング中のビデオの中間点
  • 自分の画像をインジェストすると同時に、ビデオを取り込むと同時に

セットアップ

ダイナミックインジェストリクエストの設定は、ビデオ、画像、WebVTTファイル、またはこれらのすべてを取り込んでも同じです。

リクエストURL
    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 for Brightcove Beacon アプリ。 の一般的な実装 Brightcove Player 現在、カスタム開発が必要です。

画像の言語は、 language 次のセクションで詳しく説明するプロパティ。

画像を取り込む

動画にカスタム画像を追加する詳細は次のとおりです。

リクエスト本文の画像フィールド

取り込みリクエスト本文の画像は、オブジェクトの配列として指定されます。 オブジェクトプロパティの詳細を次の表に示します。

画像オブジェクトのプロパティ
プロパティ 説明 種類 必須 例
url そのURL Video Cloud から画像を取得できます 文字列 Yes https://mysite.com/videos/video123/images/poster.png
language のサブタグからの画像の言語コード http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry （デフォルトは、ブライトコーブサポートに連絡することでアカウントに設定できます） 文字列 No
variant この画像のタイプ： poster | thumbnail | portrait | square | wide | ultra-wide 文字列 Yes 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または Dynamic Ingest API、デフォルトで Video Cloud そのアカウントのデフォルトのインジェストプロファイルで定義されているイメージサイズに合わせてサイズを変更します。

サイズ変更とパディングが唯一の変更であることに注意してください Video Cloud or Brightcove Beacon。 画像はトリミングされません。

オーバーライドオートリサイズ

この動作を無効にして 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を使用してカスタム画像を追加すると、ソース画像の元のサイズになります。

画像をキャプチャする

トランスコード中に、 Video Cloud 中間点でビデオからスナップショットをキャプチャし、これをポスターおよびサムネイルイメージとして保存できます。

カスタムの取り込みプロファイルの場合、イメージキャプチャでは、使用している取り込みプロファイルにXNUMXつの特別なレンディションを追加する必要があります。 見る 取り込みプロファイルの画像 以下。

また、 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 数字（ピクセル）

2つのレンディションのサンプルデータを次に示します。

            {
              "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, Studio上ではサポートされていません。 by Playback API ビデオリクエスト。
ページの最終更新日：12年2020月XNUMX日