画像と 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 から画像を取得できます	文字列	`https://mysite.com/videos/video123/images/poster.png`
`language`	のサブタグからの画像の言語コード http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry （デフォルトは、ブライトコーブサポートに連絡することでアカウントに設定できます）	文字列
`variant`	この画像のタイプ： `poster` \| `thumbnail` \| `portrait` \| `square` \| `wide` \| `ultra-wide`	文字列	`wide`
`height`		数	`2160`
`width`		数	`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 実際の画像サイズを保持するには、次の手順を実行します。

新しいカスタムインジェストプロファイルを作成する（または既存のカスタムプロファイルを変更する）

投稿とサムネイルのイメージレンディションを含める 正確に これらの width と height 値：

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

これをデフォルトプロファイルにする画像をオリジナルのサイズで保存したい場合は、アカウント用に

これで、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
      }

あなたは profile フィールドを作成し、イメージのレンディションを持つプロファイルを指定します（すべての標準プロファイルにはそれらがあります）。

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

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

プロパティ	値
`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
            }

形式として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.

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 ビデオリクエスト。