サポートに連絡する| システムステータス
ページコンテンツ

    静的URL配信

    このトピックでは、Brightcove Playback APIから静的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 呼び出しを示しています。

    Video Cloud playback
    Video Cloud再生

    静的 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 クレームを除外します。

    ページの最終更新日30 Sep 2021