サポート問い合わせ先| システムステータス
ページコンテンツ

    画像と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
            }
          ]
        }
    レスポンスの例

    以下はへの応答です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
          }

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

    にとって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
    	}
    ]

    画像データの取得

    を使用して画像データを取得できます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ビデオリクエストによる。

    ページの最終更新日22 Sep 2021