静的URL配信

はじめに

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)の対応フォーマット: HLS HLS VMAP
再生権限サービス (EPA)	詳細については、弊社営業にお問い合わせ下さい。
サーバーサイド広告挿入 (SSAI)	VOD およびライブ
ビデオ・オン・デマンド (VOD)	動的配信 (Dynamic Delivery)の対応ビデオフォーマット: HLS DASH HLS VMAP DASH VMAP MP4
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/

クエリパラメータ

Query Params
クエリパラメータ	値
`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 クレームを除外します。

ページコンテンツ