サポート サポート問い合わせ先 | システムステータス システムステータス

概要:Playback API

Playback API は、Video Cloud から動画やプレイリストのデータを取得するために使用されます。これは通常、動画のデータをWebページ上やモバイルアプリ内のプレーヤー向けに取得するために使用されます。

概要

挽き目 Playback API Webページやモバイルアプリからビデオやプレイリストのデータを取得する際のクライアントサイドの使用を目的とした低遅延APIです。 それは Studio上ではサポートされていません。 統合に使用する一般的なメディア管理API Video Cloud あなたのCMSや他のシステムでは、 CMS API.

挽き目 Playback API 結果はフィルタリングされ、再生可能な動画のみが返されます(state = ACTIVE、取り込み完了フラグ= true、スケジュールされている場合は正しいデータ/時間)。 これは、 player 他のレンディションがまだ処理中である場合でも、XNUMXつのレンディションが存在するとすぐにビデオを再生できます。 現在再生できない動画を取得する必要がある場合は、もう一度 CMS API 代わりに。

パフォーマンスを最大化するために、アクセスするビデオデータは Playback API 短時間キャッシュされます。 特定のデータセットIDがキャッシュされる期間は異なりますが、最大20分かかる場合があります。

また、 APIリファレンス.

ユースケース

挽き目 Brightcove Player Brightcove SDK players の方法と同じカタログ方法を含む Playback API実行時に再生するためにビデオやプレイリストを取得するだけであれば、ほとんどの場合、それらを使用することができます。

ただし、プレーヤーを表示していないモバイルアプリの画面で動画や再生リストを表示したい場合があります。

さらに、動画や再生リストを取得して、それらに関する情報を表示したい場合があります。 player たとえば、ビデオポータルのランディングページとして。

Playback API はこれらの場合に有用です。

一般情報

ベースURL

そのベースURL Playback API 次のとおりです。

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

アカウントパス

すべての場合において、要求は特定の Video Cloud アカウント。 だから、あなたはいつもその言葉を追加するでしょう accounts アカウントIDをベースURLに続けて入力します。

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}

認証

リクエストはポリシーキーによって認証され、次の3つの方法のいずれかで渡されます。

  1. の議論では、 Accept ヘッダ:
            Accept: application/json;pk={policy_key}

    これは、ブラウザベースのクライアントに推奨される方法です。これは、ブラウザのCORSの「フライト前」チェックの一環として、最初に余分な要求を行わずに要求を進めることができるためです。 これにより、ブラウザーの要求が初めて行われたときに待ち時間が節約されます。

  2. Authorization realmキーワードを使用したヘッダー BCOV-Policy:
            Authorization: BCOV-Policy {policy_key}
  3. BCOV-Policy ヘッダ:
            BCOV-Policy: {policy_key}

ポリシーキーの取得

ポリシーキーを取得するには、次の3つの方法があります。

  1. すべてのブライトコーブ player 自動的に割り当てられます。 を取得するための手順を見つけることができます playerのポリシーキー この文書。 ポリシーキーはアカウント全体で有効であるため、それが使用されているかどうかに関係なく使用できます。 player ページに埋め込まれています。
  2. 基本ポリシーキーを生成するには、 ポリシーキーのクイックスタート
  3. あなたは、 Policy API

トークン認証

HLSおよびDASHコンテンツのトークン認証がサポートされています。 トークン認証が必要な場合は、アカウントマネージャーに連絡してアカウントで有効にしてください。

ハードコードされたURLを避ける

サムネイル、ポスター、ビデオファイル、およびその他のメディアのURLは、ページやアプリケーションにハードコードされてはなりません。 ザ Playback API メディアファイルの最新のキャッシュバージョンのURLが返されますが、URL自体は変更される可能性があります。 あなたは CMS API (または Playback API )リクエストがページが読み込まれるたびにこれらのURLを取得するか、6時間を超えてキャッシュしません。

動画URLと画像URLのキャッシュ

動画や画像のURLをキャッシュしてページのパフォーマンスを向上させることはできますが、キャッシュは定期的に更新する必要があります。 ページのパフォーマンスを向上させるために取得したURLをキャッシュする場合は、少なくとも6時間に1度はAPI呼び出しを繰り返すことでキャッシュを更新してください。

メソッド

APIは、次のタイプのGETリクエストのみをサポートしています。

ビデオリクエスト

1つのビデオオブジェクトは、ビデオIDまたは参照IDのいずれかを使用して取得できます。

IDでビデオを取得する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}

        https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/38467382999

サンプルレスポンス

        {
          "account_id": "107767373999",
          "ad_keys": null,
          "created_at": "2010-07-12T22:37:34.760Z",
          "description": "Avatar_MakingAScene_Featurette",
          "duration": 595560,
          "id": "38467382999",
          "long_description": null,
          "name": "Avatar_MakingAScene_Featurette",
          "published_at": "2010-07-12T22:37:34.760Z",
          "reference_id": "AvatarMakingShort",
          "text_tracks": [],
          "updated_at": "2010-07-12T22:54:29.666Z",
          "cue_points": [
            {
              "id": "111637107001",
              "name": "Pre-roll",
              "type": "AD",
              "time": 0,
              "metadata": null,
              "force_stop": false
            }
          ],
          "custom_fields": {
            "moretext": "this is the first video uploaded",
            "mylist": "abc"
          },
          "link": {
            "text": "Full Dvd at Amazon",
            "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
          },
          "tags": [
            "copied"
          ],
          "poster_sources": [
            {
              "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
            }
          ],
          "thumbnail_sources": [
            {
              "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
            }
          ],
          "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
          "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
          "sources": [
            {
              "avg_bitrate": 379000,
              "width": 320,
              "duration": 595560,
              "size": 28196307,
              "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
              "codec": "H264",
              "asset_id": "111728840001",
              "container": "MP4",
              "height": 180,
              "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
            },
            {
              "avg_bitrate": 379000,
              "width": 320,
              "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
              "size": 28196307,
              "height": 180,
              "duration": 595560,
              "container": "MP4",
              "codec": "H264",
              "asset_id": "111728840001"
            }, ... 6 more sources ...
    
          ]
        }

参照IDでビデオを取得する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}

        https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/ref:nature_2010-07-12

サンプルレスポンス

        {
          "account_id": "107767373999",
          "ad_keys": null,
          "created_at": "2010-07-12T22:37:34.760Z",
          "description": "Avatar_MakingAScene_Featurette",
          "duration": 595560,
          "id": "38467382999",
          "long_description": null,
          "name": "Avatar_MakingAScene_Featurette",
          "published_at": "2010-07-12T22:37:34.760Z",
          "reference_id": "nature_2010-07-12",
          "text_tracks": [],
          "updated_at": "2010-07-12T22:54:29.666Z",
          "cue_points": [
            {
              "id": "111637107001",
              "name": "Pre-roll",
              "type": "AD",
              "time": 0,
              "metadata": null,
              "force_stop": false
            }
          ],
          "custom_fields": {
            "moretext": "this is the first video uploaded",
            "mylist": "abc"
          },
          "link": {
            "text": "Full Dvd at Amazon",
            "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
          },
          "tags": [
            "copied"
          ],
          "poster_sources": [
            {
              "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
            }
          ],
          "thumbnail_sources": [
            {
              "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
            }
          ],
          "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
          "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
          "sources": [
            {
              "avg_bitrate": 379000,
              "width": 320,
              "duration": 595560,
              "size": 28196307,
              "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
              "codec": "H264",
              "asset_id": "111728840001",
              "container": "MP4",
              "height": 180,
              "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
            },
            {
              "avg_bitrate": 379000,
              "width": 320,
              "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
              "size": 28196307,
              "height": 180,
              "duration": 595560,
              "container": "MP4",
              "codec": "H264",
              "asset_id": "111728840001"
            }, ... 6 more sources ...
    
          ]
        }

動画の検索

あなたは 検索可能なポリシーキー、を使用して動画を検索するとき Playback API。 詳細については、 Playback APIリファレンス の資料をご参照ください。

パラメーター

すべてのパラメータは 任意。 彼らはに適用されます GET Videos リクエストのみ。

GET動画のリクエストパラメータ
パラメーター 説明
q 検索のクエリ文字列 - 詳細は、 検索ガイド
limit 返されるビデオの数 - 1と100の間の整数でなければなりません。 デフォルト:20
offset スキップするビデオの数(ページング結果用)。 正の整数でなければなりません。 デフォルト:0
sort 並べ替えるフィールドを指定する文字列。
で始まる - 降順をソートする。
値の場合 q が提供されている場合、デフォルトのソートは「スコア」(検索結果と元のクエリの関連性)です。
値がない場合 q が提供されている場合、デフォルトのソートは updated_at 降順。
ソートには次のフィールドが有効です。 name, reference_id, created_at, published_at, updated_at, schedule_starts_at, schedule_ends_at, state, plays_totalおよび plays_trailing_week
詳細については、 ビデオを入手する のセクション Playback API 参照

ブライトコーブ Playback API プログラム内で動画を検索する方法を提供します Video Cloud としょうかん。

ビデオデータの基本的な検索や複雑な検索を行うには、 q パラメータ:

        https://edge.api.brightcove.com/playback/v1/accounts/1752604051111/videos?q={search terms}

動画の検索方法の詳細については、 検索動画 の資料をご参照ください。

ページング結果

使用 limit 100までのリクエストで返すアイテムの数を指定するパラメータ。 その後、 offset パラメータよりも大きい結果セットをページする limit offset スキップする項目の数です。

たとえば、次の検索では、合計結果セットに少なくとも51ビデオがあると仮定して、合計結果セットのビデオ75-75が返されます。

        /videos?q=updated_at:2014-01-01..2014-06-30&limit=25&offset=50

挽き目 limitoffset パラメータは動画にのみ使用できます。

ページングのベストプラクティス

結果セットをページングするとき Playback API次の手順を実行することをお勧めします。

  1. 使用 limitoffset 結果セットからデータのグループを戻すためのパラメーター。
            /accounts/578380111111/videos?q=tags:nature&limit=20&offset=50
  2. それぞれの応答で、あなたは count フィールドには、結果セットの動画の最大数が常に表示されます。
            {"count": 171,
              "videos": [ ... ]
            }
  3. コーヒー豆の水への溶解度は平均して count 最初のリクエストの動画を使用して、リクエストする必要のあるページ数を判断できます。

    あるいは、 count それぞれのレスポンスで count ページサイズの limit.
            count <= page-number * limit

動画の結果を並べ替える

パラメータを使用する sort=field_name 結果をソートする方法を指定します。 次のビデオフィールドを並べ替えることができます:[1-1]

  • reference_id
  • created_at
  • published_at
  • updated_at
  • schedule_starts_at(注:これは sort フィールド - 検索フィールドは schedule.starts_at)
  • schedule_ends_at(注:これは sort フィールド - 検索フィールドは schedule.ends_at)
  • 状態
  • plays_total[1-2]
  • plays_trailing_week[1-2]

ノート

  • [1-1] ビデオ検索呼び出しにソート値を指定しないと、結果は関連性によってソートされます。 ソート値を指定しないと GET ビデオが呼び出されると、結果は updated_at 降順。
  • [1-2] 並べ替えることができます plays_total or plays_trailing_weekこれらのフィールドは結果に含まれません

すべての動画と大きなデータセット

アカウント内のすべての動画や多数の動画を取得する場合は、次の点に注意する必要があります。

  1. 許可されている最大のものを使用するように誘惑されるかもしれません limit (100)ですが、25以下のバッチで動画を取得する方が、APIリクエストがタイムアウトする可能性を最小限に抑えることができます
  2. 大量のデータセットをページングしているとき、操作中にビデオデータが更新される可能性があります。そのため、アイテムのレスポンスが変化する可能性があります。
    • 連続したページで項目が繰り返されることがあります
    • 前の応答セットに移動したため、アイテムが見逃されることがあります

    最初の可能性を考慮すると、動画の取得が完了した後に、アプリは完全なアイテムリストを重複排除する必要があります。 2つ目の可能性を処理するには、取得した項目の総数(期待していた数)を比較し、次にリクエストを再実行し、結果をlast_modified_date(降順)でソートする必要があります。 1つ以上のバッチを取り出して欠落したアイテムを取り出す。

  3. 返された結果を適切にソートすることで、前の項目のシナリオの可能性を減らすことができます。 デフォルトのソート順は 関連性 キーワード、タグ、およびカスタムフィールド値の組み合わせを探す複雑なアルゴリズムに基づいています。 複数のキーワード、タグ、および/またはカスタムフィールドに基づいて動画を検索している場合、関連性によるソートはまさにあなたが望むものです。 ただし、すべての動画や大量の動画を取得しようとしているだけの場合は、 sort パラメータを明示的に指定すると、返される項目の順序をより詳細に制御できます。

ビデオを入手する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos

        https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos?q=tags:nature,name:nature

サンプルレスポンス

        {
          "count": 123,
          "videos":
            [
              {<video1 fields>},
              {<video2 fields>},
              ...
            ]
        }

エラー応答

検索キーではないポリシーキーを使用してビデオを取得しようとすると、次のエラーメッセージが表示されます。 Playback API:

        [
          {
            "api_call": "search",
            "error_subcode": "API",
            "error_code": "ACCESS_DENIED",
            "message": "Access to this resource is forbidden by access policy."
          }
        ]

挽き目 Playback API 指定した動画に関連する動画をアカウントで検索できます。 に基づく nameshort description APIは指定された動画の次のフィールドで部分一致を検索します:

  • name
  • short description
  • long description
  • tags

地域制限が有効な場合、結果の全ページを受け取ることはできません。

パラメーター

GET関連の動画リクエストには、次のURLパラメータを使用できます。

関連する動画をリクエストする
パラメーター 説明
limit 返す動画の数(デフォルト= 20、最大= 100)
ad_config_id 返品するad_config_idを追加する SSAIの動画

デフォルトでは、レスポンスには20までの動画が含まれます。 あなたは limit パラメータを使用して、最大100の動画に戻すことができます。また、レイテンシが増加します。

注目すべきは、 offset パラメータを使用すると、関連する動画を見つけることができます。そのため、動画の検索結果を表示することはできません。

動画IDを使用して関連動画を取得する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}/related

        https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001/related

参照IDを使用して関連動画を取得する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}/related

        https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/ref:nature/related

サンプルレスポンス

以下のレスポンスでは、 count フィールドとは異なり、 動画を検索 応答。

        {
          "videos":
            [
              {<video1 fields>},
              {<video2 fields>},
              ...
            ]
        }

エラー応答

検索に関連しないポリシーキーを使用して関連エンドポイントを検索しようとすると、次のエラーメッセージが表示されます。 Playback API:

        [
          {
            "api_call": "search",
            "error_subcode": "API",
            "error_code": "ACCESS_DENIED",
            "message": "Access to this resource is forbidden by access policy."
          }
        ]

SSAIによるビデオリクエスト

Brightcove Webを使用していない場合でも player またはアプリケーションでBrightcove Native SDKを使用している場合でも、独自のサーバーサイド広告挿入(SSAI)を使用できます。 player.

SSAIでビデオを入手する

SSAIで動画を返信するには、広告設定IDをURLパラメータとして Playback API 要求。 このリクエストでは、動画IDまたは動画参照IDのいずれかを使用できます。

エンドポイントURLパラメータ

追加する ad_config_id の終わりまで Playback API リクエスト:

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}?ad_config_id={ad_config_id}

        https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001?ad_config_id=1234abcd

以下のサンプルレスポンスでは、次のことに気づくでしょう:

  • この応答は、広告の設定IDを含めなかった場合と同様です。
  • の要素 sources 配列には、 vmap.
  • コンテンツ内の広告の場所を知りたい場合は、リンク先のVMAPファイルを読むことができます。 vmap プロパティ。
  • 挽き目 src 内のプロパティ sources 配列には、HLSまたはDASHソースへのURLが含まれます。 これは、広告設定IDが使用されていない場合の応答と同じですが、 src メインコンテンツにスティッチされた広告が表示されます。

サンプルレスポンス

        {
          "description": "The story of a giant rabbit with a heart bigger than himself. ",
          "poster_sources": [
            {
              "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/3723496277001/dd5bd69c-e962-4a43-9dbd-94faaaba1785/main/1280x720/5m17s130ms/match/image.jpg"
            }
          ],
          "tags": [],
          "cue_points": [],
          "custom_fields": {},
          "account_id": "3723496277001",
          "sources": [
            {
              "ext_x_version": "4",
              "vmap": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/vmap/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/content.vmap?bc_token=NTllMTMxYjNfMTdkOTY2YThhNjU5MDk5ZTQ3NDBkNmUxOTYyOGRkNzM0ZjBiM2RjMGEwOThjOGFkYjk1MWQxMzFmNGYzMjA5YQ%3D%3D",
              "type": "application/x-mpegURL",
              "src": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/master.m3u8?bc_token=NTllMTMxYjNfZGM5ZDg0NGM2ZGJjZDcxZTFjOGYyODBlMzM2NmNmMmJkMWNhZDczNWViNzRiMjIwNjg5MjkzZGM0ZmJlMTc1Yw%3D%3D"
            },
            ...
          ],
          "created_at": "2017-05-15T17:09:11.171Z"
        }

ad_config_idを要求する

使い方 Policy APIポリシーキーを作成すると、 ad_config_id リクエストを行う際のURLパラメータ Playback API。 この機能の設定の詳細については、 Policy API 参照 の資料をご参照ください。

ポリシーキーが要求するように設定されている場合 ad_config_id、あなたはそれを Playback API 次のエラーが表示されます。

        [
          {
            "error_subcode": "AD_CONFIG",
            "error_code": "ACCESS_DENIED",
            "message": "Missing required ad_config_id parameter"
          }
        ]

プレイリストリクエスト

プレイリストビデオオブジェクトは、プレイリストIDまたはその参照IDのいずれかを使用して取得できます。

パラメーター

次のURLパラメータは、プレイリスト要求に使用できます

プレイリスト要求パラメータ
パラメーター 説明
制限 返す動画の数(デフォルト= 20、最大= 100)
オフセット スキップする動画の数(プレイリストの先頭から、デフォルト= 0)

たとえば、あなたのリクエストに追加されたこれらのパラメータ - ?limit = 40&offset = 20 - は、プレイリストに21-60という動画を返します(その数が多いと仮定します)。

IDで再生リストを取得する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/{playlist_id}

        https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/38467382999

サンプルレスポンス

        {
          "account_id": "107767373999",
          "created_at": "2010-07-12T22:43:30.290Z",
          "description": null,
          "id": "111592530001",
          "name": "Play One",
          "reference_id": null,
          "type": "EXPLICIT",
          "updated_at": "2010-07-12T22:51:25.055Z",
    
          "videos": [
            {
              "description": "Avatar_MakingAScene_Featurette",
              "poster_sources": [
                {
                  "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
                }
              ],
              "tags": [
                "copied"
              ],
              "cue_points": [
                {
                  "id": "111637107001",
                  "name": "Pre-roll",
                  "type": "AD",
                  "time": 0,
                  "metadata": null,
                  "force_stop": false
                }
              ],
              "custom_fields": {
                "moretext": "this is the first video uploaded",
                "mylist": "abc"
              },
              "account_id": "107767373999",
              "sources": [
                {
                  "avg_bitrate": 379000,
                  "width": 320,
                  "duration": 595560,
                  "size": 28196307,
                  "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728840001",
                  "container": "MP4",
                  "height": 180,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 379000,
                  "width": 320,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 28196307,
                  "height": 180,
                  "duration": 595560,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728840001"
                },
                {
                  "avg_bitrate": 267000,
                  "width": 320,
                  "duration": 595560,
                  "size": 19894997,
                  "stream_name": "mp4:107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728852001",
                  "container": "MP4",
                  "height": 180,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 267000,
                  "width": 320,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 19894997,
                  "height": 180,
                  "duration": 595560,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728852001"
                },
                {
                  "avg_bitrate": 549000,
                  "width": 480,
                  "duration": 595567,
                  "size": 40889436,
                  "stream_name": "mp4:107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728860001",
                  "container": "MP4",
                  "height": 268,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 549000,
                  "width": 480,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 40889436,
                  "height": 268,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728860001"
                },
                {
                  "avg_bitrate": 835000,
                  "width": 640,
                  "duration": 595567,
                  "size": 62142992,
                  "stream_name": "mp4:107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728865001",
                  "container": "MP4",
                  "height": 360,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 835000,
                  "width": 640,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 62142992,
                  "height": 360,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728865001"
                },
                {
                  "avg_bitrate": 1744000,
                  "width": 640,
                  "duration": 595567,
                  "size": 129836869,
                  "stream_name": "mp4:107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111735357001",
                  "container": "MP4",
                  "height": 360,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 1744000,
                  "width": 640,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 129836869,
                  "height": 360,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111735357001"
                },
                {
                  "avg_bitrate": 1249000,
                  "width": 640,
                  "duration": 595567,
                  "size": 92994065,
                  "stream_name": "mp4:107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111735369001",
                  "container": "MP4",
                  "height": 360,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 1249000,
                  "width": 640,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 92994065,
                  "height": 360,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111735369001"
                }
              ],
              "name": "Avatar_MakingAScene_Featurette",
              "reference_id": "AvatarMakingShort",
              "long_description": null,
              "duration": 595560,
              "published_at": "2010-07-12T22:37:34.760Z",
              "text_tracks": [],
              "updated_at": "2010-07-12T22:54:29.666Z",
              "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
              "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
              "link": {
                "text": "Full Dvd at Amazon",
                "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
              },
              "id": "38467382999",
              "ad_keys": null,
              "thumbnail_sources": [
                {
                  "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
                }
              ],
              "created_at": "2010-07-12T22:37:34.760Z"
            }
          ],
        }

参照IDでプレイリストを取得する

エンドポイント

        https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/ref:{reference_id}

        https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/ref:nature_2010-07-12

サンプルレスポンス

        {
          "account_id": "107767373999",
          "created_at": "2010-07-12T22:43:30.290Z",
          "description": null,
          "id": "111592530001",
          "name": "Play One",
          "reference_id": nature_2010-07-12,
          "type": "EXPLICIT",
          "updated_at": "2010-07-12T22:51:25.055Z",
    
          "videos": [
            {
              "description": "Avatar_MakingAScene_Featurette",
              "poster_sources": [
                {
                  "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
                }
              ],
              "tags": [
                "copied"
              ],
              "cue_points": [
                {
                  "id": "111637107001",
                  "name": "Pre-roll",
                  "type": "AD",
                  "time": 0,
                  "metadata": null,
                  "force_stop": false
                }
              ],
              "custom_fields": {
                "moretext": "this is the first video uploaded",
                "mylist": "abc"
              },
              "account_id": "107767373999",
              "sources": [
                {
                  "avg_bitrate": 379000,
                  "width": 320,
                  "duration": 595560,
                  "size": 28196307,
                  "stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728840001",
                  "container": "MP4",
                  "height": 180,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 379000,
                  "width": 320,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 28196307,
                  "height": 180,
                  "duration": 595560,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728840001"
                },
                {
                  "avg_bitrate": 267000,
                  "width": 320,
                  "duration": 595560,
                  "size": 19894997,
                  "stream_name": "mp4:107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728852001",
                  "container": "MP4",
                  "height": 180,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 267000,
                  "width": 320,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 19894997,
                  "height": 180,
                  "duration": 595560,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728852001"
                },
                {
                  "avg_bitrate": 549000,
                  "width": 480,
                  "duration": 595567,
                  "size": 40889436,
                  "stream_name": "mp4:107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728860001",
                  "container": "MP4",
                  "height": 268,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 549000,
                  "width": 480,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 40889436,
                  "height": 268,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728860001"
                },
                {
                  "avg_bitrate": 835000,
                  "width": 640,
                  "duration": 595567,
                  "size": 62142992,
                  "stream_name": "mp4:107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111728865001",
                  "container": "MP4",
                  "height": 360,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 835000,
                  "width": 640,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 62142992,
                  "height": 360,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111728865001"
                },
                {
                  "avg_bitrate": 1744000,
                  "width": 640,
                  "duration": 595567,
                  "size": 129836869,
                  "stream_name": "mp4:107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111735357001",
                  "container": "MP4",
                  "height": 360,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 1744000,
                  "width": 640,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 129836869,
                  "height": 360,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111735357001"
                },
                {
                  "avg_bitrate": 1249000,
                  "width": 640,
                  "duration": 595567,
                  "size": 92994065,
                  "stream_name": "mp4:107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
                  "codec": "H264",
                  "asset_id": "111735369001",
                  "container": "MP4",
                  "height": 360,
                  "app_name": "rtmp://cp150446.edgefcs.net/ondemand"
                },
                {
                  "avg_bitrate": 1249000,
                  "width": 640,
                  "src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
                  "size": 92994065,
                  "height": 360,
                  "duration": 595567,
                  "container": "MP4",
                  "codec": "H264",
                  "asset_id": "111735369001"
                }
              ],
              "name": "Avatar_MakingAScene_Featurette",
              "reference_id": "AvatarMakingShort",
              "long_description": null,
              "duration": 595560,
              "published_at": "2010-07-12T22:37:34.760Z",
              "text_tracks": [],
              "updated_at": "2010-07-12T22:54:29.666Z",
              "thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
              "poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
              "link": {
                "text": "Full Dvd at Amazon",
                "url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
              },
              "id": "38467382999",
              "ad_keys": null,
              "thumbnail_sources": [
                {
                  "src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
                }
              ],
              "created_at": "2010-07-12T22:37:34.760Z"
            }
          ],
        }

キャプション

クローズドキャプションは、ビデオにアクセスしたい人のために、ビデオに関する追加情報を提供します。 キャプションは、あなたのビデオのオーディオ部分にアクセスするために聴覚障害者や聴覚障害者にとって必要です。 キャプションが初めての方は、 概要:ビデオにキャプションを追加する の資料をご参照ください。

外部WebVTT

外部WebVTTキャプションは、ビデオとは別のテキストファイルです。 次のようにキャプションファイルをビデオに関連付けることができます。

サンプルレスポンス

以下は、 Playback API WebVTTキャプションファイルがMediaモジュールを使用してビデオに追加されています。 テキストトラック src プロパティは外部キャプションファイルをポイントします。

        {
        "text_tracks": [
        {
          "mime_type": null,
          "account_id": "20318290001",
          "default": true,
          "sources": [
            {
              "src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856"
            }
          ],
          "src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856",
          "asset_id": null,
          "label": "English",
          "id": "13d66def-d004-4e75-b160-4ac693eff7d7",
          "kind": "captions",
          "srclang": "en"
        }
        ],
        }

インマニフェストWebVTT

マニフェスト内のWebVTTキャプションは、あなたのビデオと共に取り込まれます。 これは、動画を最初に取り込んだとき、または動画が取り込まれた後に行うことができます。 次のように、マニフェスト内のキャプションを作成できます。

サンプルレスポンス

以下は、 Playback API WebVTTキャプションファイルが Dynamic Ingest API。 テキストトラック src プロパティは内部のBrightcoveファイルを指します。

        {
        "text_tracks": [
        {
          "mime_type": "text/webvtt",
          "account_id": "1752604059001",
          "default": false,
          "sources": [
            {
              "src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
            },
            {
              "src": "https://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
            }
            ],
          "src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173",
          "asset_id": null,
          "label": "EN",
          "id": "92cb36a7-c836-4506-a87f-f649316c0cdf",
          "kind": "captions",
          "in_band_metadata_track_dispatch_type": "",
          "srclang": "en"
        }
        ],
        }

マニフェスト

HLSまたはDASHビデオファイルのマニフェストには、WebVTTキャプションを含めるために必要な情報も含まれています。

HLS
        #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-0",NAME="en (Main)",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/8b12c808-c5ea-47f3-abfa-c23b023db297/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfNzAwNTczOWM4MWQ4Mzk2NjFkYjVjYmFhYjQwNzY2MWUzM2MyNDM5ZDA5ZGExYTFkMzRmYzA0MDdhOTlmZWJhMw%3D%3D"
        #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles-0",NAME="EN",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/rendition.m3u8?fastly_token=NWE3YjU3ZThfNDYzOThkZGJiZTU1NTlhOTdkYzA5OTA3M2UzZGRlYTgzMmRkZmUxMGIxYTJkY2Y5ZDQ1ODFiNTEyMmNiZDVhMw%3D%3D"
        #EXT-X-STREAM-INF:PROGRAM-ID=0,BANDWIDTH=519200,CODECS="mp4a.40.2,avc1.420015",RESOLUTION=480x270,AUDIO="audio-0",CLOSED-CAPTIONS=NONE,SUBTITLES="subtitles-0"
        https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/5f7850d9-9a65-4eee-8810-86a1e18e05fb/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfY2Q5YmE2ODc2OWFiNTgyZjUxMjc1MzRhNmQxMzA0ZmJmY2RlMGU4ZjBiNDExZGRmNjc3YjQ0OGQ5N2RiOTVmMA%3D%3D
        
ダッシュ
        <AdaptationSet mimeType="text/vtt" lang="en">
        <Representation bandwidth="256" id="92cb36a7-c836-4506-a87f-f649316c0cdf">
          <BaseURL>http://bcboltbde696aa-a.akamaihd.net/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf.vtt?akamai_token=exp=1518032494~acl=/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a*~hmac=3e2edc412c273f1255f2c18bbbcee7afc6a2edb74573f9295b0f05feda69f0e2</BaseURL>
        </Representation>
        </AdaptationSet>

ページの最終更新日:12年2020月XNUMX日