入門
高速公開により、次のことが可能になりますCAEそれでも、すぐに再生できる1つ以上の一時的なレンディションを作成することで、できるだけ早くビデオをオンラインで入手できます。次に、次の条件が適用されます。
- 動的レンディションが利用可能になるとすぐに、一時的なレンディションではなく、動的レンディションが再生に使用されます。
- すべての動的レンディションが処理された後のある時点で、一時レンディションは自動的に削除されます
要件
高速公開を使用するには、次のことを行う必要があります。
- アカウントを有効にする動的配信
- アカウントを有効にしますCAE
- を使用してカスタムCAE取り込みプロファイルを作成しますIngest Profiles API（指示未満）
高速公開用のカスタムプロファイル
高速公開を有効にするカスタムプロファイルの作成は簡単です。これは通常のCAEプロファイルのように見えますが、1つの違いがあります。renditions配列、dynamic_originオブジェクトにはtemporary_renditions 1つ以上の高速公開レンディションを含む配列。
高速公開レンディションは名前と名前で指定されますしなければならない以下のリストから来ます（次の番号ビデオまたはオーディオレンディションのターゲットビットレートです）。必要に応じて、ビデオレンディションに加えて、オーディオのみのレンディションを含めることができます。
高速公開のポイントは、レンディションをできるだけ早く再生できるようにすることであるため、一時的なレンディションの少なくとも1つに低から中程度のビットレートを使用することはおそらく理にかなっています。
カスタムプロファイルを作成する手順
1つの一時的なレンディションでカスタムの高速公開プロファイルを作成する手順は次のとおりです。以下の手順では、multi-platform-standard-dynamicカスタムプロファイルの基礎としての標準プロファイルですが、 CAEプロファイル。
Ingest ProfilesAPIのクライアント資格情報を取得します
- スタジオにログインして、 API認証セクション [管理者]の下（これを行うには、管理者であるか、アカウントの管理者を取得する必要があります）
- クリック新規申請の登録クライアント資格情報の新しいセットを作成します。
- 適切なアカウントを選択し、 少なくとも 資格情報に対するこれらの権限：
取り込みプロファイルの権限 - を助けてクライアントIDそしてクライアントシークレット後の手順で必要になるためです。
カスタムプロファイルのJSONを作成します
- 以下のJSONをコピーします（マルチプラットフォーム-標準-動的プロファイル）をテキストエディタに：
{ "name": "multi-platform-standard-dynamic", "display_name": "Multiplatform Standard (CAE)", "description": "Deliver a wide range of content types across a variety of platforms on mobile and desktop.", "account_id": YOUR_ACCOUNT_ID, "digital_master": { "rendition": "passthrough", "distribute": false }, "renditions": [], "packages": [], "dynamic_origin": { "renditions": [ "default/audio64", "default/audio128", "default/audio96" ], "images": [ { "label": "thumbnail", "height": 90, "width": 160 }, { "label": "poster", "height": 720, "width": 1280 } ], "dynamic_profile_options": { "min_renditions": 2, "max_renditions": 6, "min_resolution": { "width": 320, "height": 180 }, "max_resolution": { "width": 1280, "height": 720 }, "max_frame_rate": 30, "max_bitrate": 2400, "max_first_rendition_bitrate": 250, "keyframe_rate": 0.5, "select_baseline_profile_configuration": true } } } - 次の値を変更します。
name：「multi-platform-standard-dynamic-fast-publish」display_name:「FastPublishStandard（CAE）」account_id:「YOUR_ACCOUNT_ID」
- 後に
dynamic_origin>renditions配列、次の配列を追加します。"temporary_renditions": [ {"name": "default/video450"}, {"name": "default/video700"}, {"name": "default/video900"} ] - カスタムプロファイルの完全なJSONは次のようになります。
{ "name": "multi-platform-standard-dynamic-fast-publish", "display_name": "Fast Publish Standard (CAE)", "description": "Deliver a wide range of content types across a variety of platforms on mobile and desktop.", "account_id": "account_id", "digital_master": { "rendition": "passthrough", "distribute": false }, "renditions": [], "packages": [], "dynamic_origin": { "renditions": [ "default/audio64", "default/audio128", "default/audio96" ], "temporary_renditions": [ {"name": "default/video450"}, {"name": "default/video700"}, {"name": "default/video900"} ], "images": [ { "label": "thumbnail", "height": 90, "width": 160 }, { "label": "poster", "height": 720, "width": 1280 } ], "dynamic_profile_options": { "min_renditions": 2, "max_renditions": 6, "min_resolution": { "width": 320, "height": 180 }, "max_resolution": { "width": 1280, "height": 720 }, "max_frame_rate": 30, "max_bitrate": 2400, "max_first_rendition_bitrate": 250, "keyframe_rate": 0.5, "select_baseline_profile_configuration": true } } }
アカウントにカスタムプロファイルを追加します
次に、Ingest Profiles APIを使用して、カスタムプロファイルをアカウントに追加します。
アクセストークンの取得
各APIリクエストは、アクセストークンを使用して認証する必要があります（後の手順で正確に確認できます）。
- あなたはする必要がありますアクセストークンを取得するから：
https://oauth.brightcove.com/v4/access_token - 使用している場合不眠症またはPostman員、次に、リンクされたドキュメントの手順を使用してOAuth2認証を設定し、アクセストークンをフェッチさせることができます。
- cURLを使用している場合、アクセストークンを取得するために使用できるcURLコマンドは次のとおりです-を置き換える必要があります
ENCODED_AUTHENTICATION_STRINGBase64でエンコードされた文字列を使用してclient_id:client_secret:curl --request POST \ --url 'https://oauth.brightcove.com/v4/access_token?grant_type=client_credentials' \ --header 'Authorization: Basic ENCODED_AUTHENTICATION_STRING' \ --header 'Content-Type: application/x-www-form-urlencoded' - アクセストークンは5分後に期限切れになることに注意してください。その場合は、新しいトークンを取得してください（Insomniaは必要なときに自動的にトークンを取得します）。
カスタム取り込みプロファイルを追加する
- 使用している場合不眠症またはPostman員、次の宛先に新しいPOSTリクエストを設定します。
https://ingestion.api.brightcove.com/v1/accounts/account_id/profilesリクエストの本文は、前に作成したカスタムプロファイルのJSONになります。
含める
Content-Type: application/jsonヘッダInsomniaまたはPostmanの使用ガイドの指示に従ってOAuth2認証を設定します。
- cURLを使用している場合は、次のリクエストを使用して、account_idとアクセストークンの値を独自のものに置き換えることができます。
curl --request POST \ --url https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles \ --header 'authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{ "name": "multi-platform-standard-dynamic-fast-publish", "display_name": "Fast Publish Standard (CAE)", "description": "Deliver a wide range of content types across a variety of platforms on mobile and desktop.", "account_id": "YOUR_ACCOUNT_ID", "digital_master": { "rendition": "passthrough", "distribute": false }, "renditions": [], "packages": [], "dynamic_origin": { "renditions": [ "default/audio64", "default/audio128", "default/audio96" ], "temporary_renditions": [ {"name": "default/video450"}, {"name": "default/video700"}, {"name": "default/video900"} ], "images": [ { "label": "thumbnail", "height": 90, "width": 160 }, { "label": "poster", "height": 720, "width": 1280 } ], "dynamic_profile_options": { "min_renditions": 2, "max_renditions": 6, "min_resolution": { "width": 320, "height": 180 }, "max_resolution": { "width": 1280, "height": 720 }, "max_frame_rate": 30, "max_bitrate": 2400, "max_first_rendition_bitrate": 250, "keyframe_rate": 0.5, "select_baseline_profile_configuration": true } } }' - リクエストを送信すると、新しいプロファイルがレスポンスにエコーバックされます。
通知
高速公開の一時的なレンディションが作成されると、DYNAMIC_RENDITION通常のレンディションの場合と同じように、「CREATE」通知：
{
"entity": "contextAwareEncoding5",
"entityType": "DYNAMIC_RENDITION",
"version": "1",
"action": "CREATE",
"jobId": "413a9938-6d73-478c-b4d9-fdeb45927a4b",
"videoId": "5600255921001",
"dynamicRenditionId": "contextAwareEncoding5",
"bitrate": 364,
"width": 512,
"height": 384,
"accountId": "1910141566001",
"status": "SUCCESS"
}
一時的なレンディションが削除されると、新しい通知が送信されます。
{
"entity": "fastpublishRendition1",
"entityType": "DYNAMIC_RENDITION",
"version": "1",
"action": "DELETE",
"jobId": "413a9938-6d73-478c-b4d9-fdeb45927a4b",
"videoId": "5600255921001",
"dynamicRenditionId": "fastpublishRendition1",
"accountId": "1910141566001",
"status": "SUCCESS"
}