画像とDynamicIngest API

入門

次の2つのカテゴリの画像を取り込むことができます。

リクエスト本文で次のように定義されているプライマリ/デフォルトのポスターとサムネイル画像ポスターとサムネイルオブジェクト（フィールドと構文の詳細は以下にあります）
で定義されている多言語バリアント画像画像オブジェクトの配列（フィールドと構文の詳細は以下にあります）

多言語バリアント画像には、次の6つのタイプがあります。

ポスター: ポスター画像は、ユーザーがビデオを再生する前に、Brightcoveプレーヤーに表示されます。通常、ビデオからキャプチャされたフレームですが、そうである必要はありません。
サムネイル: サムネイル画像は、プレイリストや終了画面などに表示されます。通常、ビデオからキャプチャされたフレームですが、そうである必要はありません。
ポートレート: 携帯電話やその他のデバイスでポートレートモードのポスターとして通常使用される画像。Brightcoveのビーコンに必要です。仕様の詳細は以下の表にあります。
平方: 通常、チャンネルのロゴまたはグリッド表示で使用される画像。Brightcoveのビーコンに必要です。仕様の詳細は以下の表にあります。
ワイド: 携帯電話やその他のデバイスで横向きモードのポスターとして通常使用される画像。Brightcoveのビーコンに必要です。仕様の詳細は以下の表にあります。
超広い: TVなどの超ワイドディスプレイのポスターとして一般的に使用される画像。Brightcoveのビーコンに必要です。仕様の詳細は以下の表にあります。

仕様

以下の表に、画像の仕様を示します。

一次画像の詳細
タイプ	[ 形式]	アスペクト比（W / H）	最小幅（ピクセル）
ポスター	pngまたはjpg	16：9または4：3	640
サムネイル	pngまたはjpg	16：9または4：3	160

多言語バリアント画像の詳細
タイプ	[ 形式]	アスペクト比（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を使用して、メインのポスター画像とサムネイル画像を動画に追加するには、次の2つの方法があります。

画像をキャプチャするトランスコーディング中のビデオの中間点（現在、これはposterそしてthumbnail画像。他のタイプを摂取する必要があります）。プライマリポスターとサムネイルのキャプチャ画像は、多言語バリアントの取り込み画像と一緒に使用できます。
ビデオの取り込みと同時に、または個別に、独自の画像を取り込みます。ビデオを取り込んだ後に画像を取り込んだ場合は、画像を取り込む前に、ビデオ処理が完了するのを待つ必要があります。

セットアップ

動的取り込み要求の設定は、ビデオ、画像、WebVTT ファイル、またはこれらすべてを取り込むかどうかに関係なく同じです。

URL をリクエスト

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

認証

認証には、BearerAuthorizationアクセストークンをトークンとしてヘッダーに渡す必要があります。

    Authorization: Bearer {access_token}

S3 に関する注意

保護された S3 バケットから画像を取得する場合は、Video Cloud がファイルにアクセスできるようにバケットポリシーを設定する必要があります。詳細については、「 S3 での動的取り込みの使用」を参照してください。

多言語バリアント

さまざまな言語で使用するさまざまなバージョンの画像を提供できます。これはによって処理されますBrightcoveビーコン Brightcoveビーコンアプリ用。Brightcove Playerでの一般的な実装には、現在、カスタム開発が必要です。

画像の言語はで指定されていますlanguage次のセクションで詳しく説明するプロパティ。

画像を取り込み

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

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

上記のように、プライマリポスターとサムネイル画像はリクエスト本文のトップレベルオブジェクトとして指定されます。取り込みリクエスト本文の多言語バリアント画像は、オブジェクトの配列として指定されます。オブジェクトのプロパティの詳細を次の表に示します。

一次ポスターとサムネイル画像
プロパティ	説明	タイプ	例
`url`	画像を取得できる公開URL	文字列	http://learning-services-media.brightcove.com/images/celtic-lullaby-large.png
`幅`	画像の幅（ピクセル単位）	数値	1920
`身長`	画像の高さ（ピクセル単位）	数値	1080

多言語画像オブジェクトのプロパティ
プロパティ	説明	タイプ	例
`url`	VideoCloudが画像を取得できるURL	文字列	`https://mysite.com/videos/video123/images/poster.png`
`language`	のサブタグからの画像の言語コードhttp://www.iana.org/assignments/language-subtag-registry/language-subtag-registry（デフォルトは、Brightcoveサポートに連絡することでアカウントに設定できます）;含まれていない場合、アカウントのデフォルト言語が使用されます。	文字列
`variant`	この画像のタイプ：`poster` \| `thumbnail` \| `portrait` \| `square` \| `wide` \| `ultra-wide`	文字列	`wide`
`height`		番号	`2160`
`width`		番号	`3840`

リクエスト本文の例

以下のサンプルリクエスト本文には、画像フィールドのみが含まれています。他の取り込みフィールドも含めることができます。

{
			"poster": {
				"url": "http://learning-services-media.brightcove.com/images/celtic-lullaby-large.png",
				"width": 1400,
				"height": 1400
			},
			"thumbnail": {
				"url": "http://learning-services-media.brightcove.com/images/celtic-lullaby-large.png",
				"width": 160,
				"height": 90
			},
	    "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
        }
      ]
    }

注意:

画像の場合、保護されていない HTTP/HTTPS URL または署名付き S3 URL のみがサポートされます。
画像は、ビデオの取り込みに含めることができますmaster、または個別に
を使用している場合レガシー取り込みシステム、および省略しますwidthそしてheightフィールドでは、システムのデフォルト値が使用されます（サムネイル：160x90;ポスター：960x540）
独自のポスターとサムネイル画像をビデオマスターと一緒にアップロードしていて、使用している取り込みプロファイルに画像レンディションが含まれている場合は、次のように設定する必要があります。capture-imagesにfalse

レスポンスの例

以下はへの応答ですCMS APIビデオ画像の取得リクエスト。見る画像データの取得未満。

{
  "thumbnail.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/5b593403-01a7-4a18-978e-cad13647cf99/292x108/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/5b593403-01a7-4a18-978e-cad13647cf99/292x108/match/image.jpg",
        "height": 108,
        "width": 292
      }
    ]
  },
  "ultra-wide.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48900952-8e0e-4fc6-bd4f-116809195ab7/2000x857/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48900952-8e0e-4fc6-bd4f-116809195ab7/2000x857/match/image.jpg",
        "height": 857,
        "width": 2000
      }
    ]
  },
  "wide.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/111fafb1-d754-49a9-9fc7-04a5637bb3d0/2000x1125/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/111fafb1-d754-49a9-9fc7-04a5637bb3d0/2000x1125/match/image.jpg",
        "height": 1125,
        "width": 2000
      }
    ]
  },
  "portrait.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/d6c605ed-11db-45a1-a7a9-beeb7b4ead1d/500x750/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/d6c605ed-11db-45a1-a7a9-beeb7b4ead1d/500x750/match/image.jpg",
        "height": 750,
        "width": 500
      }
    ]
  },
  "poster.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/35d3f294-b62e-46e5-874e-c0c85846d80a/1920x1080/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/35d3f294-b62e-46e5-874e-c0c85846d80a/1920x1080/match/image.jpg",
        "height": 1080,
        "width": 1920
      }
    ]
  },
  "square.en": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/1f719d8b-ebe9-4f6a-b5f1-8906b220554f/500x500/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/1f719d8b-ebe9-4f6a-b5f1-8906b220554f/500x500/match/image.jpg",
        "height": 500,
        "width": 500
      }
    ]
  },
  "poster": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/6c9b5fc6-3368-47c5-98a5-a5878224fe5b/1400x1400/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/6c9b5fc6-3368-47c5-98a5-a5878224fe5b/1400x1400/match/image.jpg",
        "height": 1400,
        "width": 1400
      }
    ]
  },
  "thumbnail": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/b56eee50-f593-4d0d-be15-42d5c5c147af/160x90/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/b56eee50-f593-4d0d-be15-42d5c5c147af/160x90/match/image.jpg",
        "height": 90,
        "width": 160
      }
    ]
  },
  "ultra-wide.hi": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48b1cfee-8579-4d48-9824-93ea2e1cce22/3840x1646/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/48b1cfee-8579-4d48-9824-93ea2e1cce22/3840x1646/match/image.jpg",
        "height": 1646,
        "width": 3840
      }
    ]
  },
  "wide.fr": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/45bf1048-d3fa-4ad3-89f1-1df362b60264/2560x1440/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/45bf1048-d3fa-4ad3-89f1-1df362b60264/2560x1440/match/image.jpg",
        "height": 1440,
        "width": 2560
      }
    ]
  },
  "portrait.es": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/89581e27-38b7-4b1b-85c6-fc624331a72b/800x1200/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/89581e27-38b7-4b1b-85c6-fc624331a72b/800x1200/match/image.jpg",
        "height": 1200,
        "width": 800
      }
    ]
  },
  "square.de": {
    "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/12819ec8-4da6-42ae-a67f-aed0424b8d51/570x570/match/image.jpg",
    "sources": [
      {
        "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/static/3676484086001/4fb9012e-7b20-4744-9fff-512634d7b2a5/12819ec8-4da6-42ae-a67f-aed0424b8d51/570x570/match/image.jpg",
        "height": 570,
        "width": 570
      }
    ]
  }
}

自動サイズ変更

Studio または Dynamic Ingest API 経由でカスタムポスターやサムネイル画像を追加すると、デフォルトでは、Video Cloud は、アカウントのデフォルトの取り込みプロファイルで定義されている画像サイズに合わせてこれらのサイズを変更します。

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

画像をキャプチャする

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

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

また、を設定する必要がありますcapture-imagesリクエストデータにフラグを立ててtrueトランスコーディング中にポスターとサムネイルをビデオからキャプチャしたいが、これがデフォルト値である場合 if 選択したプロファイルには画像レンディションが含まれます。（プロファイルに画像レンディションがない場合、デフォルトはcapture-imagesですfalse。）

リクエストデータの例:

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

を含める必要があることに注意してくださいprofileフィールドに入力し、画像レンディションを含むプロファイルを指定します（すべての標準プロファイルにそれらがあります）。

取り込みプロファイルの画像

にとってposterそしてthumbnail画像のみ。取り込みプロファイルに画像レンディションを含める必要があります。これは、ビデオを取り込むときに使用する場合でも、後でトランスコードするときに使用する場合でも、自動キャプチャ用です。画像レンディションはすべての標準の取り込みプロファイルに含まれているため、このセクションはカスタムの取り込みプロファイルにのみ適用されます。

取り込みプロファイルで画像レンディションを指定する方法の詳細は次のとおりです。

プロパティ	値
`media_type`	"image"
`label`	「ポスター」または「サムネイル」（それぞれにレンディションが必要です）
`format`	「png」または「jpg」
`width`	数 (ピクセル)
`height`	数 (ピクセル)

レンディションのサンプルデータは次のとおりです。

"images": [
	{
		"label": "square",
		"height": 500,
		"width": 500
	},
	{
		"label": "ultra-wide",
		"height": 1714,
		"width": 4000
	},
	{
		"label": "wide",
		"height": 2250,
		"width": 4000
	},
	{
		"label": "portrait",
		"height": 3000,
		"width": 2000
	},
	{
		"label": "thumbnail",
		"height": 90,
		"width": 160
	},
	{
		"label": "poster",
		"height": 1080,
		"width": 1920
	}
]

フォーマットとして png または jpg を指定できます。現在キャプチャされた画像は、常に jpg 画像として出力されます。

            {
                "height": 360,
                "label": "poster",
                "width": 480,
                "media_type": "image",
                "format": "png"
            },
            {
                "height": 90,
                "label": "thumbnail",
                "width": 160,
                "media_type": "image",
                "format": "png"
            }

画像データの取得

を使用して画像データを取得できますCMS API。

NS 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によってのみ返されます。notPlayback APIビデオリクエストによる。