入門
Brightcoveは、Video Cloud ライブラリのアセットの動画マニフェストファイルへの静的 URL を提供します。これにより、独自の CMS でコンテンツを柔軟に管理し、カスタムセキュリティスキーマを使用して配信できます。
これは、マニフェスト URL を必要とする前に Playback API 呼び出しを許可しない既存のアーキテクチャを使用しているお客様にとって重要です。プレーヤーはこの機能を使用することもできます。これにより、1 回のコールを排除して再生開始時間を短縮できます。
要件
静的 URL には、次の要件が必要です。
- BrightcovePlayback API v2
- お客様の資産は動的配信のために取り込まれています
アナリティクスの登録
静的 URL を使用すると、Brightcoveプレーヤーを使用せずにPlayback API と統合できます。Brightcove Player はアナリティクスデータを自動的にBrightcoveに送信しますが、データ収集 API を使用してこれを行うことになります。
データ収集 API に慣れていない場合は、「概要」を参照してください。データ収集 API ドキュメント。
データコレクターへの情報の送信の詳細については、「データ収集 API のサンプル」を参照してください。
Video Cloud
今日、VideoCloud で再生されるたびに、ビデオの再生を開始するには 2 回の API 呼び出しが必要です。静的 URL を使用すると、API 呼び出しの数を 1 つに減らすことができます。
次の図は、静的 URL を使用しないビデオ再生の API 呼び出しを示しています。
静的 URL
BrightcoveのPlayback API v2 では、静的 URL を使用できるようになりました。
特徴
静的 URL に関連付けられた機能は次のとおりです。
機能 | コメント |
---|---|
ビデオ・オン・デマンド (VOD) | ダイナミック配信でのみサポートされているビデオフォーマット:
|
VODアセット | サムネイルとポスター画像 |
認証 | JSON ウェブトークン (JWT) |
DRM | VODのみ |
配信ルール | VODのみ |
サーバー側広告挿入 (SSAI) | VODとライブ |
BYO CDN |
Brightcoveの CDN は、マニフェストとサブマニフェストを引き続き配信します。
お客様のCDNは動画セグメントのみを配信します。 |
クローズドキャプション | 現時点では、マニフェスト内キャプションのみがサポートされています。 |
ライブストリーム | |
プレイバック権限サービス (EPA) | 詳細はアカウントマネージャーにお問い合わせください。 |
配信ルール | VODのみ |
静的 URL の実装
静的 URL には、次のものがあります。
- アカウントID
- 動画ID(または参照)
- 配信タイプ(HLS、ダッシュ)
- 設定オプション (SSAI、DRM、CDN など)
静的URLは、顧客が生成して署名したものを使用して保護されますJSONWebトークン(JWT)。このトークンを使用すると、配信の側面を構成および適用できます。詳細については、の作成JSONWebトークンセクション。
ドメイン
静的 URL に使用されるドメインは、Playback API v2 (papIv2) URL です。
https://playback.brightcovecdn.com/playback/v1/
エンドポイント
各配信タイプの静的URLの例:
注
- [1-1] HLSおよびDASHVMAPは、
ssai
JWTを作成するときに主張します-次のセクションを参照してください。
クエリパラメータ
クエリパラメータ | 値 |
---|---|
bcov_auth |
JWTは下記を参照してください |
の作成JSONWebトークン
BrightcoveのPlaybackAPIと通信するときに使用するトークンを作成するには、の作成JSONWebトークン(JWT)資料。静的 URL 配信に使用できるクレームがそこにあります。
コンテンツ保護 (DRM) の使用
pro
上記のように要求を含めると、保護の種類を指定できます。
ライセンス要求の場合、JWT はペイロードを必要としませんが、マニフェスト要求 JWT と同じ RSA キーを使用して署名する必要があります。
Widevine ライセンスリクエスト
次のエンドポイントを使用して Widevine の DRM ライセンスを取得できます。
/accounts/{account_id}/videos/{video_id}/licenses/cenc/widevine?bcov_auth={JWT}
FairPlay アプリ証明書
FairPlay アプリ証明書の場合、エンドポイントは次のとおりです。
/accounts/{account_id}/fairplay_app_cert
PlayReady エンドポイント
PlayReady の場合、ライセンスリクエストのエンドポイントは次のとおりです。
/accounts/{account_id}/videos/{video_id}/licenses/cenc/playready?bcov_auth={JWT}
注
静的 URL 配信には、次の注意事項が適用されます。
- マニフェスト内キャプションがサポートされています。アウトオブバンドサイドカーキャプションは、将来のリリースでサポートされる予定です。
- カスタマーの BYO CDN は動画セグメントを配信しますが、Brightcoveの CDN は引き続きマニフェストとサブマニフェストを配信します。
-
Brightcoveでは、有効期限のない JWT の使用がサポートされています。これを行うには、
exp
トークンを作成するときにクレームを除外します。