はじめに
Brightcoveは、Video Cloud ライブラリ内のアセットの動画マニフェスト ファイルへの静的 URL を提供します。これにより、独自の CMS でコンテンツを柔軟に管理し、カスタム セキュリティ スキーマを使用して配信することができます。
これは、マニフェスト URL (複数可)を必要とする前に再生 API 呼び出しを許可しない既存のアーキテクチャを使用しているお客様にとって重要です。プレーヤーはこの機能を使用することもでき、1つの呼び出しを排除することによって再生開始時間を短縮することができます。
Playback API のリファレンスも参照してください。
要件
静的 URL には、次の要件が必要です。
- Brightcove Playback API (2.0.0)。
- 動画アセットは動的配信(Dynamic Delivery)を用に取り込まれていること。
アナリティクスの登録
静的 URL を使用すると、Brightcove プレーヤーを使用せずに再生 API と統合することになります。Brightcove プレーヤーは、自動的にアナリティクス データをBrightcoveに送信しますが、そのためにはデータ収集 API を使用します。
データ収集 API についてよく知らない場合は、概要:データ収集 API ドキュメントを参照してください。
データコレクターへの情報送信の詳細については、データ収集 API のサンプルを参照してください。
Video Cloud
現在、Video Cloud を介したすべての再生では、動画再生を開始するには 2 回の API 呼び出しが必要です。静的 URL を使用することで、API 呼び出しの数を 1 回に減らすことができます。
次の図は、静的 URL を使用しない動画再生の API 呼び出しを示しています。
静的 URL
Brightcoveの再生 API (2.0.0) では、静的 URL を使用することができます。
特徴
静的 URL に関連付けられた機能は次のとおりです。
機能 | コメント |
---|---|
認証 | JSON Web Token (JWT) |
BYO CDN |
Brightcoveの CDN は、マニフェストとサブマニフェストを引き続き配信します。
お客様のCDNは動画セグメントのみを配信します。 |
クローズド キャプション | 現在サポートされているのは、マニフェスト内のキャプションのみです。 |
配信ルール | VODのみ |
DRM | VODのみ |
ライブ ストリーム | 動的配信(Dynamic Delivery)の対応フォーマット:
|
再生権限サービス (EPA) | 詳細については、弊社営業にお問い合わせ下さい。 |
サーバーサイド広告挿入 (SSAI) | VOD および ライブ |
ビデオ・オン・デマンド (VOD) | 動的配信 (Dynamic Delivery)の対応ビデオ フォーマット:
|
VOD アセット | サムネイルとポスター画像 |
静的 URL の実装
静的 URL には、次のものがあります。
- アカウントID
- 動画ID(または参照)
- 配信タイプ(HLS、DASH)
- 設定オプション (SSAI、DRM、CDN など)
静的URLは、お客様が生成し署名したJSON Webトークン(JWT)を使用して保護されます。このトークンを使用して、配信の様々な側面を設定し強制することができます。詳細については、JSON Webトークンの作成セクションを参照して下さい。
ドメイン
静的 URL に使用されるドメインは、再生 API v2 (papI v2) URL です。
https://edge.api.brightcove.com/playback/v1/
クエリ パラメータ
クエリ パラメータ | 値 |
---|---|
bcov_auth |
JWT は 以下 を参照 |
ビデオ・オン・デマンド (VOD) エンドポイント
各配信タイプの静的URLの例:
- HLS マスター マニフェスト
-
/accounts/{{account_id}}/videos/{{video_id}}/master.m3u8?bcov_auth={jwt}
- DASH マニフェスト
-
/accounts/{{account_id}}/videos/{{video_id}}/manifest.mpd?bcov_auth={jwt}
- HLS VMAP [1]
-
/accounts/{{account_id}}/videos/{{video_id}}/hls.vmap?bcov_auth={jwt}
- DASH VMAP [1]
-
/accounts/{{account_id}}/videos/{{video_id}}/dash.vmap?bcov_auth={jwt}
- 最大ビットレート MP4 [2]
-
/accounts/{{account_id}}/videos/{{video_id}}/high.mp4?bcov_auth={jwt}
- 最小ビットレート MP4 [2]
-
/accounts/{{account_id}}/videos/{{video_id}}/low.mp4?bcov_auth={jwt}
- サムネイル画像
-
/accounts/{{account_id}}/videos/{{video_id}}/thumbnail.jpg?bcov_auth={jwt}
- ポスター画像
-
/accounts/{{account_id}}/videos/{{video_id}}/poster.jpg?bcov_auth={jwt}
注
- [1] HLS と DASH の VMAPは、JWTを作成する際に、
ssai
クレームを含める場合にのみ取得できます。 - [2]
high.mp4
およびlow.mp4
エンドポイントを使用する場合、動画にはMP4レンディションが含まれていなければなりません。含まれていない場合は、次のエラーが発生します:404 (NO RESOURCE)
ライブ エンドポイント
ライブストリーム用の静的URLの例:
- HLS マスター マニフェスト
-
/accounts/{{account_id}}/videos/{{video_id}}/master.m3u8?bcov_auth={jwt}
- HLS VMAP [1]
-
/accounts/{{account_id}}/videos/{{video_id}}/hls.vmap?bcov_auth={jwt}
注
- [1] HLS VMAPは、JWTを作成する際に、
ssai
クレームを含める場合のみ取得できます。
JSON Webトークンの作成
Brightcove の再生APIと通信する際に使用するトークンを作成するには、JSON Webトークン(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
クレームを除外します。