Static URL 配信

概要

Brightcove は、Video Cloud ライブラリ内のアセットに対して動画マニフェスト ファイルへの Static (静的) URL を提供しています。これにより、独自の CMS でコンテンツを管理し、カスタム セキュリティ方式で配信する柔軟性が得られます。

これは、マニフェスト URL が必要になる前に Playback API を呼び出せない既存のアーキテクチャを持つお客様にとって重要です。プレーヤーもこの機能を利用でき、1 回の API 呼び出しが不要になることで再生開始時間を短縮できます。

Playback API リファレンス も参照してください。

要件

Static URL を使用するには、以下の要件が必要です：

• Brightcove Playback API（2.0.0）
• アセットが Dynamic Delivery 用に取り込まれていること

アナリティクスの登録

Static URL を使用する場合、Brightcove プレーヤーを使用せず Playback API と連携します。Brightcove プレーヤーは自動的にアナリティクス データを送信しますが、この場合は Data Collection API を使用してデータを送信します。

Data Collection API に慣れていない場合は、概要: Data Collection API を確認してください。

Data Collector に情報を送信する方法については、Data Collection API サンプル を参照してください。

Video Cloud

現在、Video Cloud を使用した再生では、動画再生開始のために 2 回の API 呼び出しが必要です。Static URL を使用すると、API 呼び出しを 1 回だけに削減できます。

以下の図は、Static URL を使用しない場合の動画再生 API 呼び出しを示しています。

Static URL

Brightcove の Playback API（2.0.0）では、Static URL が利用可能です。

機能

Static URL に関連する機能は次のとおりです：

Static URL の実装

Static URL には以下の情報が含まれます：

• アカウント ID
• 動画 ID（またはリファレンス）
• 配信タイプ（HLS、DASH）
• 設定オプション（SSAI、DRM、CDN など）

Static URL は、お客様側で生成・署名された JSON Web Token（JWT）を使用して保護されます。 このトークンを使用して、配信に関するさまざまな項目を設定・制御できます。詳細は、JSON Web Token の作成 セクションを参照してください。

ドメイン

Static URL に使用されるドメインは Playback API の URL です：

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

クエリ パラメータ

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

配信タイプごとの Static 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)

ライブ エンド ポイント

ライブ配信における Static 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}}

注意事項

Static URL 配信に適用される注意点は以下のとおりです：

• マニフェスト内キャプション（In-Manifest captions）はサポートされています。外部ファイルのサイドカーキャプション（Out-of-band captions）は今後のリリースでサポート予定です。
• お客様の BYO CDN は動画セグメントを配信し、Brightcove の CDN はマニフェストおよびサブマニフェストを配信します。
• Brightcove では、有効期限のない JWT の使用をサポートしています。その場合は、トークン作成時に exp クレームを含めないでください。

制限事項

Static URL 配信には次の制限があります。

• Brightcove は Static URL 配信で SSAI の URL パラメータ フォワーディングをサポートしていません。