静的URL配信

はじめに

Brightcoveは、Video Cloud ライブラリのアセットの動画マニフェストファイルへの静的 URL を提供します。これにより、独自の CMS でコンテンツを柔軟に管理し、カスタムセキュリティスキーマを使用して配信できます。

既存のシステム構成上、Playback API をあらかじめ呼び出すことが難しいお客様に特に適しています。プレーヤーもこの機能を利用でき、API 呼び出しを 1 回省略することで再生開始時間を短縮できます。

Playback API v2 のリファレンスもご参照ください。

要件

静的 URL を使用するには、以下の要件を満たす必要があります。

• BrightcovePlayback API v2
• アセットが Dynamic Delivery 用に取り込まれていること

アナリティクスの登録

静的 URL を使用すると、Brightcoveプレーヤーを使用せずにPlayback API と統合できます。Brightcove Player はアナリティクスデータを Brightcove に自動的に送信しますが、静的 URL を使用する場合は Brightcove Player を経由しないため、Data Collection API を使ってアナリティクスデータを手動で送信する必要があります。

Data Collection API を初めてご利用の場合は、概要: Data Collection API ドキュメントをご参照ください。

Data Collection API を使ったデータ送信の詳細については、「Data Collection API のサンプル」をご参照ください。

Video Cloud

現在、Video Cloud での再生には、再生を開始するために 2 回の API 呼び出しが必要です。静的 URL を使用すると、API 呼び出しの数を 1 つに減らすことができます。

次の図は、静的 URL を使用しないビデオ再生の API 呼び出しを示しています。

静的 URL

BrightcoveのPlayback API v2 では、静的 URL を使用できるようになりました。

特徴

静的 URL に関連付けられた機能は次のとおりです。

静的 URL の実装

静的 URL には、以下の情報が含まれます。

• アカウントID
• 動画ID（または参照）
• 配信タイプ（HLS、ダッシュ）
• 設定オプション (SSAI、DRM、CDN など)

静的 URL は、お客様が生成・署名した JSON Web Token (JWT) によって保護されます。このトークンを使用すると、配信の側面を構成および適用できます。詳細については、JSON Web Token の作成 セクションをご参照ください。

ドメイン

静的 URL に使用されるドメインは、Playback API の URL です。

https://edge.api.brightcove.com/playback/v1/

Video-On-Demand (VOD) エンドポイント

各配信タイプの静的URLの例：

HLS マスターマニフェスト

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

ダッシュマニフェスト

/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}

ダッシュ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 クレームを含める必要があります。詳細は JSON Web Token の作成 セクションをご参照ください。
• ^[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 Token の作成

Brightcove Playback API との通信に使用するトークンの作成方法については、JSON Web Token (JWT) の作成ドキュメントを参照してください。Static 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}/videos/{video_id}/licenses/fairplay?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 クレームを除外してください。

制限事項

Static URL 配信には、以下の制限事項が適用されます。

• Brightcove は、Static URL 配信における SSAI URL パラメータの転送をサポートしていません。